Claude Code 구성 튜토리얼
Claude Code는 Anthropic Messages 프로토콜을 사용합니다. ai2save에 접속할 때 주소에는 사이트 루트 주소 **https://ai2save.com**를 입력하고, /v1를 수동으로 추가하지 마세요. 키는 ai2save 콘솔에서 생성한 sk-...를 사용합니다.
1. API Key 준비
- https://ai2save.com/keys를 엽니다.
- '키 생성'을 클릭하고 이름을 입력한 후 Claude 모델이 포함된 그룹을 선택합니다.
- 생성 후 즉시 전체 키를 복사하세요. 전체 키는 한 번만 표시됩니다.
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
인터랙티브 인터페이스에 들어간 후:
- 짧은 질문 한 문장을 입력합니다. 예: '안녕하세요, 자기소개 해주세요.'
- 정상적으로 내용이 반환되면, 주소, 키, 모델 그룹이 연결된 것입니다.
- 모델을 전환해야 할 경우
/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을 완전히 종료한 후 다시 열어보세요.