Claude Code

CometAPI와 함께 Claude Code를 설정하세요: 공식 설치 프로그램으로 설치하고, settings.json에서 ANTHROPIC_AUTH_TOKEN 및 ANTHROPIC_BASE_URL을 구성하며, 일반적인 문제를 해결합니다.

이 가이드를 사용해 Claude Code를 CometAPI에 연결하세요.

공식 참고 문서:

• Claude Code Overview
• Claude Code Getting Started

모델 제공 여부는 시간이 지나면서 변경될 수 있습니다. 현재 Claude 모델 ID는 CometAPI Models page에서 확인하세요.

​

사전 준비

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

​

Claude Code 설치

1. 공식 설치 프로그램 실행

   macOS / Linux

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

   Homebrew

   brew install --cask claude-code
   

   Windows

   PowerShell:

   irm https://claude.ai/install.ps1 | iex
   

   CMD:

   curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
   

   Windows에서는 먼저 Git for Windows를 설치해야 합니다.
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의 네이티브 서비스를 호출하며, 이를 위해 직접적인 인터넷 접속이 필요합니다. 시스템 전체 프록시가 필요할 수 있습니다.