전체 가이드

공식Anthropic 호환Anthropic

Claude Code

Anthropic 공식 터미널 에이전트.

Claude Code는 Anthropic Messages 프로토콜을 사용합니다. Anthropic 키를 바로 쓰거나, 환경 변수 두 개로 Anthropic 호환 엔드포인트를 가리키게 할 수 있습니다.

공식 문서

설정 단계

  1. 1

    CLI 설치

    Node.js 18 이상이 필요합니다. 전역 명령 claude가 설치됩니다.

    bash
    npm install -g @anthropic-ai/claude-code
  2. 2

    방법 A: Anthropic 키 사용

    Anthropic 콘솔의 키를 설정합니다. Windows는 세션 간에 유지하며, setx 후에는 터미널을 다시 여세요.

    bash / zsh
    export ANTHROPIC_API_KEY="your-api-key"
    PowerShell
    setx ANTHROPIC_API_KEY "your-api-key"
  3. 3

    방법 B: 커스텀 엔드포인트 사용

    모든 요청을 더 저렴한 Anthropic 호환 게이트웨이로 보냅니다. URL과 키를 제공업체 값으로 바꾸세요.

    bash / zsh
    export ANTHROPIC_BASE_URL="https://api.example.com"
    export ANTHROPIC_AUTH_TOKEN="your-api-key"
  4. 4

    영구 설정

    매번 export하는 대신 엔드포인트와 키를 설정 파일에 저장하면 모든 세션이 읽어옵니다.

    ~/.claude/settings.json
    {
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.example.com",
        "ANTHROPIC_AUTH_TOKEN": "your-api-key"
      }
    }
  5. 5

    코딩 시작

    프로젝트 폴더에서 실행하세요. 지금 있는 위치에서 파일을 읽고 편집합니다.

    bash
    claude
팁: api.anthropic.com이 아닌 베이스 URL은 서드파티 게이트웨이로 취급됩니다. bearer 토큰을 요구하는 게이트웨이에는 ANTHROPIC_AUTH_TOKEN을 사용하세요.
먼저 더 저렴한 모델이나 제공업체를 고른 뒤, 그 키와 엔드포인트를 위 단계에 넣으세요. 가격 비교 · 제공업체 보기