개발지식창고 | AI·유튜브 실측 기록
클로드 코드 설치 방법: 준비물부터 첫 실행 확인까지 4단계 본문
이 글에서 얻는 것
- 설치 명령 한 줄로 깔고 첫 로그인까지 마친다
- API 키 설정과 CLAUDE.md 길이를 점검해 한도를 아낀다
바로 받기
글에 나온 코드 1개와 점검 목록 5항목을 파일 하나로 묶었습니다.
클로드 코드 사용법의 첫걸음은 설치입니다. 유료 계정을 준비하고 운영체제에 맞는 설치 명령 한 줄을 실행한 뒤, 작업할 폴더에서 claude를 입력하면 됩니다.
이 글을 따라 하면 계정과 컴퓨터 조건 확인부터 첫 로그인까지 마칠 수 있습니다.
설치 전에 확인할 것: 계정과 컴퓨터
무료 요금제로는 쓸 수 없습니다. 공식 설정 문서에 따르면 Pro, Max, Team, Enterprise, Console 중 하나가 있어야 합니다.
Amazon Bedrock 같은 외부 업체를 거쳐 쓰는 방법도 있습니다.
컴퓨터 조건도 공식 설정 문서에 나와 있습니다.
| 항목 | 조건 |
|---|---|
| 맥 | macOS 13.0 이상 |
| 윈도우 | 10 1809 이상, Server 2019 이상 |
| 리눅스 | Ubuntu 20.04, Debian 10, Alpine 3.19 이상 |
| 하드웨어 | 메모리(RAM) 4GB 이상, x64 또는 ARM64 |
| npm으로 설치할 때 | Node.js 22 이상 |
따라 하기: 설치하고 처음 실행하기
- 터미널을 엽니다. 터미널은 글자로 명령을 입력하는 창입니다.
- 맥: Spotlight에서 '터미널'을 검색해 엽니다.
- 윈도우: PowerShell을 엽니다.
- 운영체제에 맞는 한 줄을 붙여 넣고 실행합니다. 공식 개요 문서에 나온 명령입니다. WSL은 윈도우 안에서 리눅스를 쓰는 기능입니다.
# 맥, 리눅스, WSL
curl \
-fsSL https://claude.ai/install.sh | bash
# 윈도우 PowerShell
irm https://claude.ai/install.ps1 | iex- 설치가 끝나면 작업할 폴더로 옮겨 갑니다. 그 폴더에서 claude를 입력합니다.
- 처음 실행하면 로그인(인증)하라는 안내가 화면에 나옵니다. 안내대로 유료 계정으로 로그인하면 질문을 입력할 수 있습니다.
이 방식으로 깔면 알아서 자동 업데이트됩니다. Homebrew나 WinGet(프로그램 설치 도우미)으로 깔면 기본적으로 자동 업데이트가 되지 않습니다.
클로드 코드 설치나 로그인이 안 될 땐?
아래 네 가지는 공식 문서에 나온 내용입니다.
- 로그인이 되지 않으면 요금제부터 확인합니다. 무료 요금제로는 쓸 수 없습니다.
- 윈도우에서는 Git for Windows 설치를 권합니다. 없으면 명령이 PowerShell로 실행됩니다.
- npm으로 설치한다면 sudo(관리자 권한)를 붙이지 않습니다. 권한 문제와 보안 위험이 있다고 경고합니다.
- 터미널이 낯설면 VS Code 확장, JetBrains 플러그인, 데스크톱 앱, 웹에서도 쓸 수 있습니다.
다음 두 가지는 공식 문서 인용이 아니라 일반적인 확인법입니다.
- claude를 찾을 수 없다고 나오면 터미널을 닫았다가 다시 열어 봅니다.
claude --version을 입력해 버전 번호가 나오면 설치는 된 것입니다.
자주 묻는 질문
클로드 코드는 무료로 쓸 수 있나요?
무료 요금제로는 쓸 수 없습니다. Pro, Max, Team, Enterprise, Console 중 하나가 있어야 합니다.
클로드 코드 설치 방법은 무엇인가요?
터미널에 운영체제에 맞는 한 줄을 붙여 넣어 실행합니다. 맥, 리눅스, WSL은 curl 명령을, 윈도우 PowerShell은 irm 명령을 씁니다.
클로드 코드 설치 방법 윈도우에서는 어떻게 하나요?
윈도우에서는 PowerShell을 열고 irm https://claude.ai/install.ps1 | iex 명령을 실행합니다. Git for Windows를 함께 설치하길 권합니다.
클로드 코드는 설치 후 어떻게 실행하나요?
설치가 끝나면 작업할 폴더로 옮겨 가서 claude를 입력합니다. 처음 실행하면 나오는 안내대로 유료 계정으로 로그인하면 됩니다.
클로드 코드 업데이트는 어떻게 하나요?
공식 명령으로 설치하면 자동으로 업데이트됩니다. Homebrew나 WinGet으로 설치했다면 기본적으로 자동 업데이트가 되지 않아 직접 업데이트해야 합니다.
터미널이 낯설면 클로드 코드를 다른 방법으로 쓸 수 있나요?
가능합니다. VS Code 확장, JetBrains 플러그인, 데스크톱 앱, 웹에서도 쓸 수 있습니다.
이 글의 명령어·요금제·화면은 2026-10-22 기준으로 공식 문서와 대조했습니다. 이후 바뀔 수 있으니 최신 안내를 함께 확인하세요.
바로 해 볼 점검 목록
- 유료 계정(Pro, Max, Team, Enterprise, Console 중 하나)이 있는지 확인했습니다.
- 공식 설치 명령으로 깔았는지 확인했습니다. Homebrew나 WinGet이라면 직접 업데이트합니다.
- 관계없는 작업으로 넘어갈 때 /clear를 입력하기로 했습니다.
- 복잡한 작업 전에는 Shift+Tab으로 플랜 모드로 바꾸기로 했습니다.
- 요금제와 화면은 바뀔 수 있습니다. 최신 안내는 공식 개요 문서, 비용 관리 문서, 요금제 도움말에서 확인합니다.
연재 이어 보기
다음 편 예고: VRAM 8GB·12GB에 맞는 Ollama 로컬 LLM 모델 고르는 법
함께 읽으면 좋은 글
클로드 코드, 여러분은 어떻게 하고 계신가요? 막힌 곳이나 궁금한 점을 댓글로 남겨 주시면 다음 글에서 직접 해 보고 답하겠습니다.
새 글을 놓치지 않으려면 블로그 오른쪽 위 '구독하기'를 누르거나 RSS(https://chon91.tistory.com/rss)를 등록해 주세요.
이 글은 AI의 도움을 받아 작성했으며, 수치는 직접 수집한 데이터에서 계산한 값입니다. 틀린 곳을 알려 주시면 확인해 고치겠습니다.
출처
- Claude Code overview (Claude Code Docs)
- Advanced setup (Claude Code Docs)
- Manage costs effectively (Claude Code Docs)
- How Claude remembers your project (Claude Code Docs)
- Introducing Claude 4 (Anthropic News)
- Claude 3.7 Sonnet and Claude Code (Anthropic News)
- Use Claude Code with your Pro or Max plan (Claude Help Center)