📋 준비 단계
시작하기 전에 다음 사항을 확인하세요.
- Koze 계정을 등록하고 로그인했는지 확인하세요.
- API 관리 페이지에서 API 키를 생성했는지 확인하세요.
- Claude Code를 설치했는지 확인하세요. (
npm install -g @anthropic-ai/claude-code)
🚀 1단계: 환경 변수 설정
터미널에서 다음 명령어를 실행하여 API 주소와 키를 환경 변수로 설정하세요.
# Koze 프록시 주소를 기본 URL로 설정
export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1'
# Koze 백엔드에서 생성한 API 키를 설정
export ANTHROPIC_AUTH_TOKEN="Your API" 키"
💡 팁:
https://api.kozeai.com을 실제 서비스 도메인으로 바꾸세요. API 키는 "API 관리 → 기존 키" 페이지에서 확인하거나 생성할 수 있습니다.
🔧 2단계: VSCode 플러그인 구성 (선택 사항)
VSCode용 Claude 플러그인을 사용하는 경우 `~/.claude/config.json` 파일에서 구성해야 합니다.
{
"primaryApiKey": "API 키",
"apiBaseUrl": "https://api.kozeai.com/v1"
}
파일이 없는 경우 수동으로 생성하세요.
- macOS / Linux:
~/.claude/config.json - Windows:
C:\Users\Your Username\.claude\config.json
🎯 3단계: Claude Code 실행
환경 변수를 설정한 후 터미널에서 직접 실행합니다.
claudeClaude Code는 설정한 Koze 프록시 주소를 자동으로 사용하여 요청을 보냅니다.
📌 영구 환경 변수
터미널을 열 때마다 변수를 재설정하지 않으려면 셸 설정 파일에 변수를 저장하는 것이 좋습니다.
# Bash 사용자
echo 'export' ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN='your API key' >>> ~/.bashrc
source ~/.bashrc
# Zsh 사용자
echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN='your API key' >> ~/.zshrc
source ~/.zshrc
✅ 연결 확인
Claude Code를 시작한 후 정상적인 대화 상자 인터페이스가 보이면 설정이 성공적으로 완료된 것입니다.
Koze의 "사용 통계" 페이지에서 실시간 통화 기록을 확인할 수 있습니다.⚠️ 자주 묻는 질문
| 문제 | 해결 방법 |
|---|---|
| 팁: 잘못된 API 키 | API 키를 정확하게 복사했는지, 불필요한 공백이 없는지 확인하세요. |
| 연결 시간 초과 | 기본 URL이 올바르고 접미사 /v1이 포함되어 있는지 확인하세요. |
| 모델을 사용할 수 없음 | 현재 사용 가능한 모델 목록을 확인하세요. | 코제 모델 로비의 패키지