← 목록으로 돌아가기

Claude Code 연결 가이드

Claude Code를 설치하고 API 키를 설정한 뒤 Starsg를 통해 대화를 시작하세요.

중요시작하기 전에 콘솔에서 만든 API 키를 준비하세요. 아직 없다면 링크를 열어 생성하세요.

1. 환경점검

아래 npm 명령으로 설치한다면 먼저 터미널에서 node --version 명령을 실행하세요. 명령을 찾을 수 없다면 Node.js 다운로드 페이지에서 설치하세요. 새 터미널을 열고 아래의 두 확인 명령을 실행하세요.

bash
node --version
npm --version

공식 설치 가이드: Claude Code

사용할 도구만 설치하세요. 이미 설치했다면 건너뛰어도 됩니다. npm 명령:

bash
npm i -g @anthropic-ai/claude-code@latest
중요: 설치한 도구의 --version 명령만 실행해 설치 여부를 확인하세요.
bash
claude --version

버전 번호가 표시되면 설치된 것입니다. 명령을 찾을 수 없다면 터미널을 다시 열어 시도하세요.

중요: clude 보고서를 실행하면 Anthropic 서비스에 연결할 수 없습니다. Claude Code는 Anthropic에 연결할 수 없습니다. 먼저 추가 설정 명령을 실행한 다음 돌아와서 아래의 CLI별 구성 섹션을 계속 진행하세요.

2. Claude Code

설정 파일 ~/.claude/settings.json을 열고 다음 내용을 입력하세요. 파일이 없으면 새로 만드세요.

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.starsg.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-abc...xyz",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1"
  }
}

설정 예제의 sk-abc...xyz를 콘솔에서 만든 API 키로 바꾸세요.

참고: 구성 후에도 여전히 오류가 발생하고 CLI에서 로그인하라는 메시지가 표시되면 다음을 따르세요. Claude Code는 Anthropic에 연결할 수 없습니다. 그것을 해결하기 위해.

3. 확인

터미널에서 claude 명령을 실행해 응답을 받으면 연결된 것입니다.