메인 콘텐츠로 건너뛰기
이 가이드를 사용해 Claude Code를 CometAPI에 연결하세요. 공식 참고 문서:
모델 제공 여부는 시간이 지나면서 변경될 수 있습니다. 현재 Claude 모델 ID는 CometAPI Models page에서 확인하세요.

​
사전 준비

  • dashboard에서 발급한 CometAPI 키 (sk-로 시작)
  • Git 설치
  • 지원 OS: macOS, Linux 또는 Windows

​
Claude Code 설치

1

공식 설치 프로그램 실행

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

설치 확인

claude --version

​
CometAPI 엔드포인트 구성

설정 파일을 생성하거나 편집하세요:
  • macOS / Linux: ~/.claude/settings.json
  • Windows: %USERPROFILE%\.claude\settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-cometapi-key",
    "ANTHROPIC_BASE_URL": "https://api.cometapi.com"
  }
}
sk-your-cometapi-key를 실제 CometAPI 키로 바꾼 다음, Claude Code를 시작하세요: 
cd your-project
claude

​
문제 해결

settings.json이 적용되지 않나요?
  1. 터미널을 완전히 다시 시작하세요(모든 창을 닫고 다시 열기)
  2. 그래도 작동하지 않으면 ~/.claude.json을 만들고 다음을 추가하세요: 
    {
  "hasCompletedOnboarding": true
}
  3. 대안으로, 환경 변수를 직접 export하세요: 
    # ~/.zshrc (macOS) 또는 ~/.bashrc (Linux)에 추가
export ANTHROPIC_AUTH_TOKEN="sk-your-cometapi-key"
export ANTHROPIC_BASE_URL="https://api.cometapi.com"
Invalid API Key 또는 Please run /login이 표시되나요? ~/.claude/settings.json이 존재하는지, 그리고 JSON 형식이 올바른지(후행 쉼표 없음, 따옴표 올바름) 확인하세요. jsonlint.com에서 검증할 수 있습니다. 이전에 Anthropic 공식 계정으로 로그인했나요? Claude Code는 캐시된 공식 자격 증명을 우선 사용합니다. Claude Code 내부에서 /logout을 실행하고, 종료한 뒤 다시 시작하세요. 그래도 실패하면: 
rm -rf ~/.config/claude-code/auth.json
상태가 offline으로 표시되나요? Claude Code는 Google을 통해 연결 상태를 확인합니다. offline은 단지 Google에 연결할 수 없다는 의미일 뿐이며, CometAPI 사용에는 영향을 주지 않습니다. Fetch / 웹 브라우징이 실패하나요? Claude Code의 Fetch 기능은 먼저 Anthropic의 네이티브 서비스를 호출하며, 이를 위해 직접적인 인터넷 접속이 필요합니다. 시스템 전체 프록시가 필요할 수 있습니다.