설치하기
Claude Code를 설치하기 전에 다음을 준비하세요:
| 항목 | 확인 |
|---|---|
| Node.js 18 이상 | node --version으로 확인 (버전 18+ 필요) |
| npm | Node.js와 함께 설치됨 (npm --version으로 확인) |
| Anthropic API 키 | console.anthropic.com에서 발급 |
| 터미널 | Terminal (macOS) 또는 PowerShell (Windows) |
터미널을 열고 다음을 입력하세요:
node --version
npm --version
Node.js 18 이상이 설치되어 있으면 다음 단계로 이동하세요.
Node.js가 설치되지 않았다면 nodejs.org에서 다운로드하세요 (LTS 버전 권장).
다음 명령어를 실행하세요:
npm install -g @anthropic-ai/claude-code
설치가 완료되었는지 확인하세요:
claude --version
버전 번호가 표시되면 설치 완료입니다.
Anthropic API 키를 환경변수로 설정해야 합니다.
터미널에서 (macOS/Linux)
> export ANTHROPIC_AUTH_TOKEN="sk-ant-..."
API 키는 console.anthropic.com/account/keys에서 생성할 수 있습니다.
Windows PowerShell 사용자:
$env:ANTHROPIC_AUTH_TOKEN="sk-ant-..."
설치가 완료되었으면 다음 명령어로 시작하세요:
claude
Claude Code 터미널이 열립니다. 이제 첫 작업 실행으로 이동하세요.
특별한 추가 설정은 필요하지 않습니다. Terminal 앱에서 위 단계를 따르면 됩니다.
PowerShell을 관리자 권한으로 실행하고 위 단계를 따르세요.
Git Bash 사용자: 아래와 같이 설정하세요:
export ANTHROPIC_AUTH_TOKEN="sk-ant-..."
| 문제 | 원인 | 해결 방법 |
|---|---|---|
command not found: claude | Claude Code 경로가 PATH에 없음 | npm install -g를 다시 실행 |
API key not found | ANTHROPIC_AUTH_TOKEN이 설정되지 않음 | 위 4단계 재확인 |
node: command not found | Node.js 미설치 | nodejs.org에서 설치 |
- 첫 작업 실행 — Claude Code에서 첫 번째 프로젝트 시작