Claude Code

개요

유형: 코딩 도구주요 경로: Anthropic-native지원 수준: 강한 네이티브 경로

Claude Code는 AI 지원 코딩을 위한 Anthropic의 공식 CLI 도구입니다. API 제공자로 TokenLab를 사용하도록 구성할 수 있습니다.

설치

Anthropic는 이제 native installer를 권장합니다. npm 설치도 호환성을 위해 여전히 존재하지만, upstream에서는 deprecated 상태입니다.

curl -fsSL https://claude.ai/install.sh | bash

특별히 npm 패키지가 필요한 경우 다음을 사용하세요:

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

Claude Code에 sudo npm install -g를 사용하지 마세요.

구성

환경 변수

다음 환경 변수를 설정하세요:

export ANTHROPIC_API_KEY="sk-your-tokenlab-key"
export ANTHROPIC_BASE_URL="https://api.tokenlab.sh"

영구적으로 적용하려면 이를 shell profile(~/.bashrc, ~/.zshrc 등)에 추가하세요.

TokenLab의 경우 ANTHROPIC_BASE_URL은 /v1 suffix 없이 https://api.tokenlab.sh로 유지하세요. 이는 Anthropic 스타일 endpoint 형식 및 Claude Code에 문서화된 unified gateway pattern과 일치합니다.

구성 파일

또는 ~/.claude/settings.json을 생성하거나 편집하세요:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-tokenlab-key",
    "ANTHROPIC_BASE_URL": "https://api.tokenlab.sh"
  }
}

사용법

구성 후에는 Claude Code를 일반적으로 사용하세요:

# Start an interactive session
claude

# Run a single command
claude "Explain this code" < main.py

# Chat mode
claude chat

필요한 경우 설치를 확인하세요:

claude --version
claude doctor

사용 가능한 모델

TokenLab는 모든 Claude 모델을 지원합니다:

모델	설명
`claude-opus-4-6`	가장 뛰어난 성능, 복잡한 추론
`claude-sonnet-4-6`	균형 잡힌 성능, 코딩에 탁월
`claude-haiku-4-5`	가장 빠르며 비용 효율적

모델 선택

--model 플래그로 모델을 지정하세요:

claude --model claude-sonnet-4-6 "Review this PR"

또는 구성에서 기본값을 설정하세요:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-tokenlab-key",
    "ANTHROPIC_BASE_URL": "https://api.tokenlab.sh"
  },
  "model": "claude-sonnet-4-6"
}

확장된 사고

복잡한 추론 작업에는 extended thinking이 지원되는 모델을 사용하세요:

claude --model claude-opus-4-6 "Design a microservices architecture for..."

문제 해결

연결 오류

base URL이 정확히 https://api.tokenlab.sh인지 확인하세요(Anthropic 스타일 요청에는 /v1 suffix 없음).

유효하지 않은 API 키

TokenLab API 키가 sk-로 시작하고 충분한 잔액이 있는지 확인하세요.

Gateway에는 Authorization bearer token이 필요합니다

Claude Code의 gateway mode는 ANTHROPIC_AUTH_TOKEN도 지원합니다. 의도적으로 gateway auth 동작을 전환한 경우가 아니라면, 표준 TokenLab 설정에서는 계속 ANTHROPIC_API_KEY를 사용하세요.

모델을 찾을 수 없음

모델 이름이 올바른지 확인하세요. claude-sonnet-4-6 형식을 사용하세요.

호환성 매트릭스

코딩 도구

네이티브 SDK

프레임워크 및 플랫폼

채팅 앱

개요

설치

구성

환경 변수

구성 파일

사용법

사용 가능한 모델

모델 선택

확장된 사고

문제 해결

​개요

​설치

​구성

​환경 변수

​구성 파일

​사용법

​사용 가능한 모델

​모델 선택

​확장된 사고

​문제 해결

개요

설치

구성

환경 변수

구성 파일

사용법

사용 가능한 모델

모델 선택

확장된 사고

문제 해결