ai2saveai2save

Claude Code 구성 튜토리얼

Claude Code는 Anthropic Messages 프로토콜을 사용합니다. ai2save에 접속할 때 주소에는 사이트 루트 주소 **https://ai2save.com**를 입력하고, /v1를 수동으로 추가하지 마세요. 키는 ai2save 콘솔에서 생성한 sk-...를 사용합니다.

1. API Key 준비

  1. https://ai2save.com/keys를 엽니다.
  2. '키 생성'을 클릭하고 이름을 입력한 후 Claude 모델이 포함된 그룹을 선택합니다.
  3. 생성 후 즉시 전체 키를 복사하세요. 전체 키는 한 번만 표시됩니다.

2. Claude Code 설치

먼저 Node.js 환경 설치를 완료한 후 실행합니다:

npm install -g @anthropic-ai/claude-code
claude --version

버전이 게이트웨이 요구사항보다 낮으면, 안내에 따라 업그레이드하세요:

npm update -g @anthropic-ai/claude-code

3. 현재 터미널 임시 활성화

macOS / Linux / WSL:

export ANTHROPIC_BASE_URL="https://ai2save.com"
export ANTHROPIC_AUTH_TOKEN="sk-사용자의 API 키"
claude

Windows PowerShell:

$env:ANTHROPIC_BASE_URL="https://ai2save.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-사용자의 API 키"
claude

ANTHROPIC_AUTH_TOKEN는 중간 전송 키 전용 변수입니다. ANTHROPIC_API_KEY를 다른 공식 키로 동시에 설정하지 말고, Claude Code가 잘못된 자격 증명을 읽지 않도록 하십시오.

4. Claude Code 구성 파일 작성(권장)

~/.claude/settings.json를 편집하십시오(Windows에서는 일반적으로 %USERPROFILE%\.claude\settings.json에 있음):

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai2save.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-사용자의 API 키"
  }
}

저장 후 터미널을 다시 열고 claude를 실행하세요. 특정 프로젝트에서만 적용하고 싶다면, 같은 내용을 프로젝트 내 .claude/settings.local.json에 작성하고 실제 키는 Git에 커밋하지 마세요.

5. 모델 선택 및 검증

claude --model claude-sonnet-4-6

인터랙티브 인터페이스에 들어간 후:

  1. 짧은 질문 한 문장을 입력합니다. 예: '안녕하세요, 자기소개 해주세요.'
  2. 정상적으로 내용이 반환되면, 주소, 키, 모델 그룹이 연결된 것입니다.
  3. 모델을 전환해야 할 경우 /model를 사용하며, 모델 ID는 콘솔에서 열려 있는 ID와 일치해야 합니다.

또한 먼저 Claude Code 내장 진단을 사용하여 구성 상태를 확인할 수도 있습니다:

/status
/doctor

6. 다중 구성 및 이전 구성 정리

이전에 공식 Claude 또는 다른 중계 서버에 로그인한 적이 있다면:

  • 여러 공급업체를 관리할 때는 CC Switch를 우선 사용하여 수동 구성 오류를 방지하세요.
  • 수동으로 구성할 때는 이전의 ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN 또는 ANTHROPIC_API_KEY가 현재 값을 덮어쓰지 않았는지 확인하세요.
  • WSL와 Windows는 두 가지 환경입니다; Windows 터미널에서 구성한 후에도 WSL 내에서 별도로 설정해야 합니다.

macOS / Linux 임시 정리:

unset ANTHROPIC_API_KEY

자주 발생하는 오류

  • 401 / invalid_api_key:키가 완전히 복사되지 않았거나, 취소되었거나, 그룹에 현재 모델이 포함되어 있지 않습니다.
  • 404 / model not found:모델 ID가 올바르지 않거나, 해당 키 그룹에서 이 모델을 사용할 수 없습니다.
  • 연결 실패:Base URL를 https://ai2save.com/v1로 잘못 입력하면 오류가 발생합니다; Claude Code는 https://ai2save.com로 입력해야 합니다.
  • 여전히 공식 주소로 요청됨:~/.claude/settings.json, 프로젝트 .claude/settings.local.json, 그리고 터미널 환경 변수에 이전 주소가 남아 있는지 확인하세요.
  • Windows에서 열어도 적용되지 않음:터미널, VS Code 또는 Claude Desktop을 완전히 종료한 후 다시 열어보세요.