클로드코드CLI

① 사전 준비물 확인 → ② CLI 설치 → ③ OS에 맞는 환경 변수 적용 순서입니다. 무작정 명령만 붙여넣지 말고 이 순서대로 진행하세요.

사전 준비물

클로드코드 CLI는 Node.js 위에서 동작하고 npm으로 설치합니다. 환경 변수를 넣기 전에 아래 도구가 먼저 설치돼 있어야 합니다.

• Node.js (LTS 18 이상 권장) — nodejs.org에서 설치하면 npm이 함께 설치됩니다.
• Git — git-scm.com. 버전 관리와 대부분의 에디터·에이전트 연동에 필요합니다.
• 터미널 — macOS는 터미널/iTerm, Windows는 PowerShell 또는 CMD, Linux는 기본 터미널을 사용합니다.

아래 명령으로 설치 여부를 먼저 확인하세요. 버전이 출력되면 준비 완료입니다.

1node -v      "docs-token-comment"># v18 이상 권장2npm -v3git --version

CLI 설치

준비물이 확인되면 npm으로 클로드코드 CLI를 전역 설치합니다.

1npm install -g @anthropic-ai/claude-code

환경 변수 설정

1sed -i '' '/export ANTHROPIC_API_KEY/d' ~/.zshrc2echo 'export ANTHROPIC_BASE_URL="https://api-anthropic.com/v1"' >> ~/.zshrc3echo 'export ANTHROPIC_AUTH_TOKEN="여기에_발급받은_API키를_넣어주세요"' >> ~/.zshrc4echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"' >> ~/.zshrc5unset ANTHROPIC_API_KEY6source ~/.zshrc7claude /logout

환경변수 코드는 무엇을 의미하나요?

1. 기존 API 키가 먼저 잡히지 않도록 제거합니다.
2. 요청이 엔트로픽 엔드포인트로 향하도록 BASE_URL을 지정합니다.
3. 발급받은 키를 AUTH_TOKEN에 넣어 인증합니다.
4. 불필요한 원격 트래픽을 줄이고 기존 CLI 세션을 정리합니다.