모델 공급자 설정

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를 통해 과금되고 있음을 의미합니다:

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

4. 다른 모델 사용하기

OfoxAI를 통해 Claude Code에서 Claude 이외의 모델(Qwen, GLM, DeepSeek 등)을 사용할 수 있습니다. 모델 광장에서 호환 모델을 필터링하고 모델 매핑을 설정하기만 하면 됩니다.

단계 1: 호환 모델 필터링

OfoxAI 모델 광장 에 접속하여 왼쪽 사이드바의 API 프로토콜에서 Anthropic을 선택하여 Anthropic 프로토콜을 지원하는 모델을 필터링합니다.

단계 2: 모델 이름 복사

대상 모델 카드를 클릭하면 모델 이름 옆에 복사 버튼이 있어 모델 ID를 원클릭으로 복사할 수 있습니다(예: bailian/qwen3.6-plus).

단계 3: 모델 매핑 설정

CC Switch로 돌아가 공급자 설정의 모델 매핑 부분을 찾습니다. 복사한 모델 이름을 해당 모델 슬롯에 입력합니다. 호환 모델은 OfoxAI 모델 광장 에서 확인하세요:

매핑 슬롯	설명
주 모델	Claude Code 기본 사용 모델
추론 모델 (Thinking)	심층 추론용 모델
Haiku 기본 모델	경량 작업 모델
Sonnet 기본 모델	중간 복잡도 작업 모델
Opus 기본 모델	고복잡도 작업 모델

공급자가 기본적으로 Claude 시리즈 모델을 제공하는 경우, 모델 매핑은 보통 필요하지 않습니다. 요청을 다른 모델 이름으로 매핑해야 할 때만 설정하세요.

문제 해결

문제가 발생하면 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에는 글로벌 가속이 내장되어 있으므로, 일반적으로 로컬 네트워크 문제입니다. 로컬 연결을 확인한 후 다시 시도하세요.