모델 공급자 설정

CC Switch 를 사용하여 설정하는 것을 권장합니다 — 오픈소스 공급자 관리 도구로, 시각적 인터페이스를 통해 JSON이나 환경 변수를 수동으로 편집할 필요가 없습니다.

1. CC Switch 설치

macOS


brew install --cask cc-switch

또는 Releases 에서 .dmg 파일을 다운로드하여 수동 설치하세요.

Windows

Releases 에서 .msi 설치 프로그램을 다운로드하세요.

Linux


# Debian / Ubuntu
sudo dpkg -i CC-Switch-*.deb
 
# Fedora / RHEL
sudo rpm -i CC-Switch-*.rpm
 
# AppImage
chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

macOS 12+, Windows 10+, Ubuntu 22.04+ / Debian 11+ / Fedora 34+ 지원

2. OfoxAI 공급자 추가

단계 1: 새 공급자 추가

CC Switch를 열고 공급자 관리 페이지로 이동한 후 우측 상단의 + 버튼을 클릭하세요.

단계 2: 설정 입력

아래 이미지에 표시된 대로 입력하고 + 추가 버튼을 클릭하여 완료하세요.

설정 항목	값	설명
❶ 공급자 이름	`ofoxai-claude`	사용자 지정, 식별하기 쉽게
❷ 공식 웹사이트 링크	`https://ofox.ai`	공급자 공식 웹사이트
❸ API Key	귀하의 OfoxAI API Key	app.ofox.ai에서 발급
❹ 요청 주소	`https://api.ofox.ai/anthropic`	끝에 슬래시를 추가하지 마세요
❺ API 형식 / 인증 필드	`Anthropic Messages (네이티브)` / `ANTHROPIC_AUTH_TOKEN (기본값)`	기본값 유지
❻ 모델 설정	비워두기	비워두면 기본 Claude 모델 사용
❼ 옵션	「AI 서명 숨기기」와 「Teammates 모드」 체크	필요에 따라 체크
❽ 공통 설정에 기록	✅ 체크	전역 설정에 기록하여 모든 프로젝트에 적용

CC Switch가 자동으로 ~/.claude/settings.json에 기록하므로, 파일을 수동으로 편집할 필요가 없습니다.

단계 3: 공급자 활성화

추가 완료 후 목록으로 돌아가 ofoxai-claude를 선택하고 사용 버튼을 클릭합니다. “전환 성공” 메시지가 표시되면 완료입니다.

3. 설정 확인

프로젝트 디렉토리로 이동하여 Claude Code를 시작하세요:


cd your-project
claude

첫 시작 시 Esc를 눌러 로그인을 건너뛰세요. 시작 후 상단 정보 바를 확인하여 API Usage Billing(❶)이 표시되는지 확인하세요. 이는 OfoxAI를 통해 과금되고 있음을 의미합니다:

위 정보가 정확하면 설정이 성공한 것입니다.

문제 해결

문제가 발생하면 Claude Code 터미널에서 /status를 실행하여 설정을 확인하세요:


/status

다음 주요 필드를 확인하세요:

❶ Anthropic base URL이 https://api.ofox.ai/anthropic인지
❷ Model에 현재 사용 중인 모델이 표시되는지

Q: “Authentication error” 메시지가 표시됨

Anthropic base URL이 올바른지 확인하고, API Key가 유효한지 점검하세요.

Q: 연결 시간 초과

요청 주소가 https://api.ofox.ai/anthropic으로 입력되었는지 확인하세요. 끝에 슬래시가 없어야 합니다.

Q: 스트리밍 응답 끊김

OfoxAI에는 글로벌 가속이 내장되어 있으므로, 일반적으로 로컬 네트워크 문제입니다. 로컬 연결을 확인한 후 다시 시도하세요.