Skip to main content
이 가이드를 사용해 Claude Code를 CometAPI에 연결하세요. 공식 참고 문서:
모델 제공 여부는 시간에 따라 변경됩니다. 현재 Claude model ID는 CometAPI Models page에서 확인하세요.

​
사전 준비

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

​
Claude Code 설치

1

공식 설치 프로그램 실행

2

설치 확인

​
CometAPI 엔드포인트 구성

설정 파일을 생성하거나 수정하세요:
  • macOS / Linux: ~/.claude/settings.json
  • Windows: %USERPROFILE%\.claude\settings.json
sk-your-cometapi-key를 실제 CometAPI 키로 바꾼 다음, Claude Code를 시작하세요:

​
문제 해결

  1. 모든 창을 닫고 다시 열어 터미널을 완전히 재시작합니다.
  2. 그래도 작동하지 않으면 ~/.claude.json을 생성하고 다음을 추가합니다:
  1. 대안으로 환경 변수를 직접 export합니다:
~/.claude/settings.json이 존재하는지, 그리고 JSON 형식이 올바른지 확인하세요. 후행 쉼표가 없어야 하고 따옴표도 정확해야 합니다. jsonlint.com에서 검증할 수 있습니다.
Claude Code는 캐시된 공식 자격 증명을 우선 사용합니다. Claude Code 내부에서 /logout을 실행하고 종료한 다음 다시 시작하세요.그래도 실패하면 캐시된 auth 파일을 삭제하세요:
Claude Code는 Google을 통해 연결 상태를 확인합니다. offline은 Google에 도달할 수 없다는 의미입니다. 이는 CometAPI 사용에는 영향을 주지 않습니다.
Claude Code의 Fetch 기능은 먼저 Anthropic의 네이티브 서비스를 호출하며, 이 과정에는 직접적인 인터넷 접속이 필요합니다. 시스템 전체 프록시가 필요할 수 있습니다.