Claude Code

환경 변수 두 개로 Anthropic의 CLI 에이전트를 게이트웨이에 연결하고, 잘못된 키에 조용히 요금이 청구되는 함정을 피하세요.

Claude Code는 환경 변수에서 엔드포인트를 읽으므로 패치가 필요 없습니다. 게이트웨이에서 가장 흔히 사용하는 설정입니다.

설정

Copyexport ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
claude

이것으로 연동이 완료됩니다. 두 줄을 모두 다음 파일에 추가하세요: ~/.zshrc 또는 ~/.bashrc 설정을 영구적으로 적용할 수 있습니다.

프로젝트별 설정

게이트웨이를 셸 전체가 아닌 특정 저장소에만 적용하려면 설정 파일을 사용하세요:

Copy{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiprimetech.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

파일을 다음 위치에 두세요: .claude/settings.json 프로젝트 내부에 두거나, 다음 위치에 두세요: ~/.claude/settings.json 사용자 전체의 기본값으로 적용할 수 있습니다. 다음을 추가하세요: .claude/settings.json 다음으로 변경되었습니다. .gitignore — 키가 포함되어 있습니다.

작동 여부 확인

Copy"c"># 1. the gateway answers and the key is valid
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

"c"># 2. start Claude Code and confirm usage appears in your dashboard
claude

대시보드에 요청이 표시되지 않으면 다른 곳으로 전송되고 있는 것입니다. 거의 항상 다음 문제 때문입니다: ANTHROPIC_API_KEY 위에서 설명한 함정입니다.

모델 선택

Copyclaude --model claude-opus-4-8

다음에서 제공하는 모든 ID 모델 사용할 수 있습니다. 어려운 리팩터링에는 Opus, 일상적인 작업에는 Sonnet을 사용하세요 — 참고: 비용 관리 이 선택이 요금에 가장 큰 영향을 미치는 이유를 확인하세요.

비용을 적정 수준으로 유지하기

• Claude Code는 매 턴마다 파일 내용과 도구 결과를 다시 전송하므로, 긴 세션의 비용은 비선형적으로 증가합니다. 다음을 사용하세요: /clear 서로 관련 없는 작업 사이에 실행하세요.
• 큰 도구 출력(500행의 쿼리 결과, 전체 빌드 로그)은 컨텍스트에 계속 남습니다. 다음 도구로 파이프 처리하세요: head 가능한 경우에 적용하세요.
• 시스템 프롬프트와 도구 정의가 턴마다 거의 바뀌지 않으므로, 이 경우 프롬프트 캐싱의 효과가 가장 큽니다.