​
모델 구성

기본적으로 Claude Code는 claude-3-7-sonnet-20250219를 사용합니다. 다음 환경 변수를 사용하여 이를 재정의할 수 있습니다:

# Anthropic API
ANTHROPIC_MODEL='claude-3-7-sonnet-20250219'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku-20241022'

# Amazon Bedrock
ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'
ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# Google Vertex AI
ANTHROPIC_MODEL='claude-3-7-sonnet@20250219'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku@20241022'

전역 구성을 사용하여 이러한 변수를 설정할 수도 있습니다:

# Anthropic API 구성
claude config set --global env '{"ANTHROPIC_MODEL": "claude-3-7-sonnet-20250219"}'

# Bedrock 구성
claude config set --global env '{"CLAUDE_CODE_USE_BEDROCK": "true", "ANTHROPIC_MODEL": "us.anthropic.claude-3-7-sonnet-20250219-v1:0"}'

# Vertex AI 구성
claude config set --global env '{"CLAUDE_CODE_USE_VERTEX": "true", "ANTHROPIC_MODEL": "claude-3-7-sonnet@20250219"}'

다양한 제공업체에서 사용 가능한 모든 모델은 모델 이름 참조를 참조하세요.

​
타사 API와 함께 사용

Claude Code는 사용하는 API 제공업체와 관계없이 Claude 3.7 Sonnet과 Claude 3.5 Haiku 모델 모두에 대한 액세스가 필요합니다.

​
Amazon Bedrock에 연결

CLAUDE_CODE_USE_BEDROCK=1

프록시를 통해 Claude Code에 액세스하려면 ANTHROPIC_BEDROCK_BASE_URL 환경 변수를 사용할 수 있습니다:

ANTHROPIC_BEDROCK_BASE_URL='https://your-proxy-url'

프롬프트 캐싱이 활성화되어 있지 않은 경우 다음도 설정하세요:

DISABLE_PROMPT_CACHING=1

표준 AWS SDK 자격 증명이 필요합니다(예: ~/.aws/credentials 또는 AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY와 같은 관련 환경 변수). AWS 자격 증명을 설정하려면 다음을 실행하세요:

aws configure

비용 절감과 더 높은 속도 제한을 위해 Amazon Bedrock에 프롬프트 캐싱을 문의하세요.

사용자는 AWS 계정에서 Claude 3.7 Sonnet과 Claude 3.5 Haiku 모델 모두에 대한 액세스 권한이 필요합니다. 모델 액세스 역할이 있는 경우 이러한 모델이 아직 사용 가능하지 않다면 액세스를 요청해야 할 수 있습니다. 추론 프로필에는 교차 리전 기능이 필요하므로 각 리전의 Bedrock에 대한 액세스가 필요합니다.

​
Google Vertex AI에 연결

CLAUDE_CODE_USE_VERTEX=1
CLOUD_ML_REGION=us-east5
ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

프록시를 통해 Claude Code에 액세스하려면 ANTHROPIC_VERTEX_BASE_URL 환경 변수를 사용할 수 있습니다:

ANTHROPIC_VERTEX_BASE_URL='https://your-proxy-url'

프롬프트 캐싱이 활성화되어 있지 않은 경우 다음도 설정하세요:

DISABLE_PROMPT_CACHING=1

Vertex AI의 Claude Code는 현재 us-east5 리전만 지원합니다. 프로젝트에 이 특정 리전에 할당된 할당량이 있는지 확인하세요.

사용자는 Vertex AI 프로젝트에서 Claude 3.7 Sonnet과 Claude 3.5 Haiku 모델 모두에 대한 액세스 권한이 필요합니다.

google-auth-library를 통해 구성된 표준 GCP 자격 증명이 필요합니다. GCP 자격 증명을 설정하려면 다음을 실행하세요:

gcloud auth application-default login

최상의 경험을 위해 Google에 높은 속도 제한을 문의하세요.

​
프록시를 통해 연결

Claude Code를 LLM 프록시(LiteLLM와 같은)와 함께 사용할 때 다음 환경 변수와 구성을 사용하여 인증 동작을 제어할 수 있습니다. 이러한 설정은 Bedrock 및 Vertex 관련 설정과 함께 혼합하여 사용할 수 있습니다.

​
환경 변수

  • ANTHROPIC_AUTH_TOKEN: Authorization 및 Proxy-Authorization 헤더의 사용자 지정 값(여기에 설정한 값 앞에 Bearer 가 붙습니다)
  • ANTHROPIC_CUSTOM_HEADERS: 요청에 추가하려는 사용자 지정 헤더(Name: Value 형식)
  • HTTP_PROXY: HTTP 프록시 URL 설정
  • HTTPS_PROXY: HTTPS 프록시 URL 설정

환경 변수 대신 파일을 통해 구성하려면 전역 Claude 구성(~/.claude.json)의 env 객체에 이러한 변수를 추가할 수 있습니다.

​
전역 구성 옵션

  • apiKeyHelper: API 키를 가져오기 위한 사용자 지정 셸 스크립트(시작 시 한 번 호출되며 각 세션 동안 캐시됨)

Was this page helpful?

비용튜토리얼