Source: https://aiprimetech.io/ko/docs/guides/claude-code/

[홈](/ko/) / [문서](/ko/docs/) / Claude Code 

# Claude Code 

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

 페이지 복사 [ Markdown으로 보기](/ko/docs/guides/claude-code.md) [ ChatGPT에 질문](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/guides/claude-code.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Claude에서 질문](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/guides/claude-code.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

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

## 설정 

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

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

주의할 함정: 만약 ANTHROPIC_API_KEY 셸에 설정되어 있으면 Claude Code가 이를 우선하여 해당 키로 요금을 청구하고, 게이트웨이 키와 Pro/Max 구독을 모두 알림 없이 무시할 수 있습니다. 다음을 실행하세요: echo $ANTHROPIC_API_KEY — 무언가 출력된다면 다음을 실행하세요: unset ANTHROPIC_API_KEY 시작하기 전에 실행하세요. 

## 프로젝트별 설정 

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

```
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 [모델](/ko/docs/getting-started/models/) 사용할 수 있습니다. 어려운 리팩터링에는 Opus, 일상적인 작업에는 Sonnet을 사용하세요 — 참고: [비용 관리](/ko/docs/guides/cost-control/) 이 선택이 요금에 가장 큰 영향을 미치는 이유를 확인하세요. 

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

[MCP 서버Claude Code에 실제 도구 제공하기](/ko/docs/guides/mcp-servers/)[비용 관리에이전트 토큰이 사용되는 곳](/ko/docs/guides/cost-control/)[문제 해결아무 반응이 없을 때](/ko/docs/guides/troubleshooting/) 

[이전비전 및 이미지 입력](/ko/docs/api-reference/vision/)[다음Cursor](/ko/docs/guides/cursor/)