Claude Code 설정
Claude Code 는 Anthropic에서 공식 출시한 AI 코딩 CLI 도구입니다. OfoxAI를 통해 무제한 트래픽, 더 낮은 지연 시간, 다중 모델 전환 기능을 얻을 수 있습니다.
OfoxAI를 사용하는 이유
- 높은 속도 할당량 — 기본 200 RPM, TPM 무제한, 고빈도 코딩 요구 충족
- 99.9% SLA — 다중 노드 이중화, 자동 장애 전환
- 저지연 — P99 지연 < 200ms
- 완전한 프로토콜 지원 — 100% Anthropic 네이티브 프로토콜 호환
설정 단계
1. API Key 발급
OfoxAI 콘솔 에서 API Key를 생성하세요.
2. 환경 변수 설정
Claude Code는 Anthropic 네이티브 프로토콜을 사용하므로 ANTHROPIC_BASE_URL과 ANTHROPIC_AUTH_TOKEN을 설정해야 합니다.
shell 설정 파일(~/.zshrc 또는 ~/.bashrc)에 다음을 추가하세요:
~/.zshrc
# OfoxAI API 주소, API Key는 https://app.ofox.ai 에서 발급받으세요
export ANTHROPIC_BASE_URL=https://api.ofox.ai/anthropic
export ANTHROPIC_AUTH_TOKEN=<귀하의 OFOXAI_API_KEY>저장 후 실행:
source ~/.zshrc3. 설정 확인
claude --version
# 버전 번호가 정상적으로 출력되면 설정 완료
# 테스트 메시지 전송
claude "안녕하세요, 잘 지내시나요?"모델 매핑
Claude Code에서 사용하는 모델 이름 매핑:
| Claude Code에서 사용 | OfoxAI 모델 ID |
|---|---|
claude-opus-4.6 | anthropic/claude-opus-4.6 |
claude-sonnet-4.5 | anthropic/claude-sonnet-4.5 |
claude-haiku-4.5 | anthropic/claude-haiku-4.5 |
OfoxAI는 모델 이름 매핑을 자동으로 처리하므로 anthropic/ 접두사를 수동으로 추가할 필요가 없습니다. Claude Code의 기본 모델 이름을 그대로 사용할 수 있습니다.
고급 설정
settings.json에서 설정
Claude Code의 설정 파일에서도 환경 변수를 설정할 수 있습니다:
~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.ofox.ai/anthropic",
"ANTHROPIC_AUTH_TOKEN": "<귀하의 OFOXAI_API_KEY>"
}
}모델 전환
Claude Code에서 /model 명령으로 모델을 전환하세요:
/model claude-sonnet-4.5문제 해결
자주 묻는 질문
Q: “Authentication error” 오류가 표시됩니다
ANTHROPIC_AUTH_TOKEN이 올바르게 설정되었는지 확인하세요:
echo $ANTHROPIC_AUTH_TOKEN
# API Key가 출력되어야 합니다Q: 연결 시간 초과
ANTHROPIC_BASE_URL이 올바른지 확인하세요:
echo $ANTHROPIC_BASE_URL
# https://api.ofox.ai/anthropic 이 출력되어야 합니다Q: 스트리밍 응답이 끊깁니다
네트워크 연결을 확인하세요. 중국 본토에서 사용하는 경우, OfoxAI는 홍콩 노드 가속을 제공하며 지연 시간은 약 300ms입니다.
Last updated on