Ofox에서 Codex CLI와 CC Switch: 두 프로토콜 설정법

Codex CLI와 Claude Code는 서로 다른 프로토콜을 씁니다. CC Switch는 두 항목을 나란히 관리해 주는데, 이게 이 도구를 쓰는 가장 큰 이유입니다. Claude Code용 base URL을 Codex 탭에 붙여 넣거나 그 반대로 하는 실수는 손으로 설정하면 아주 쉽게 납니다.

클라이언트 둘, 프로토콜 둘

두 URL 모두 끝에 슬래시를 붙이지 않으며, Ofox 키 하나로 양쪽 모두 인증됩니다. 이 표가 설명하는 것은 클라이언트이지 모델이 아닙니다. Ofox 카탈로그의 Claude 모델은 Fable 5.1을 포함해 전부 두 프로토콜 어느 쪽이든 받습니다.

CC Switch 설치

# macOS
brew install --cask cc-switch

# Debian / Ubuntu — 먼저 Releases에서 .deb 파일을 받으세요
sudo dpkg -i <내려받은-파일>.deb

# Fedora / RHEL
sudo rpm -i <내려받은-파일>.rpm

# AppImage
chmod +x <내려받은-파일>.AppImage && ./<내려받은-파일>.AppImage

Windows는 .msi 설치 파일을 제공하고, Homebrew를 쓰지 않겠다면 macOS용 .dmg도 릴리스 페이지에 있습니다. 설치 과정 전체는 CC Switch 설치 가이드(영문)를 참고하세요. 최소 지원 버전은 macOS 12, Windows 10, Ubuntu 22.04 / Debian 11 / Fedora 34입니다.

Codex CLI 프로바이더 추가

상단의 Codex 탭으로 이동한 뒤 오른쪽 위 + 버튼을 누릅니다.

“Write to Global Config”를 체크해 두면 현재 프로젝트가 아니라 모든 프로젝트에 프로바이더가 적용됩니다. 추가한 다음 목록에서 활성화하세요.

Claude Code 프로바이더 추가

같은 도구, 다른 페이지, 다른 값입니다.

Model Configuration은 비워 두세요. 비워 두면 기본 Claude 모델로 넘어가는데, 특정 모델을 일부러 고정하려는 것이 아니라면 그게 원하는 동작입니다. CC Switch는 결과를 ~/.claude/settings.json에 기록합니다.

이 페이지에는 “Hide AI Signature”와 “Teammates Mode”라는 선택 토글이 둘 있습니다. 어느 쪽도 라우팅이나 과금에 영향을 주지 않습니다.

사용량 조회 켜기

CC Switch는 Ofox에서 소비량을 가져와 대시보드에 보여 줄 수 있습니다. 설정할 것은 넷입니다. Enable Usage Query를 켜고, 같은 Ofox API 키를 붙여 넣고, 요청 엔드포인트를 https://api.ofox.ai/v1로 두고, 범용 템플릿(通用模板) 옵션을 고릅니다. 이 옵션이 호환성이 가장 좋다고 Ofox 문서가 권장합니다.

두 가지를 알아 두세요.

• API 할당량을 소모하지 않습니다. 호출 예산이 아니라 전용 통계 API를 씁니다.
• 수치는 해당 호출보다 몇 분 늦게 반영됩니다.

나중에 꺼도 일반 API 호출에는 영향이 없습니다.

Fable 5.1의 경우

Fable 5.1은 2026년 9월 3일 Ofox 카탈로그에 들어왔습니다. 등록명은 anthropic/claude-fable-5.1입니다. 위의 내용에서 달라지는 것은 없습니다. base URL 둘도, API 형식 둘도, 키도 그대로입니다. 모델 문자열만 다릅니다.

어떤 모델에 정착하든 이 설정 자체는 해 둘 값어치가 있습니다. 모델 교체가 문자열 하나로 끝나는 두 프로토콜 경로가 생기기 때문입니다. Fable 5.1과 나란히 카탈로그에는 anthropic/claude-fable-5, anthropic/claude-opus-5, anthropic/claude-sonnet-5가 Anthropic 정가에 추가 요금 없이 올라와 있고, 넷 다 같은 키로 두 프로토콜 어느 쪽에서든 호출됩니다.

Fable 5.1에서 특히 중요한 이유가 있습니다. 이 모델의 유일한 요금 변화가 캐시 읽기이기 때문입니다. $1에서 $0.25로 내려갔습니다. 그게 본인에게 값어치가 있는지는 전적으로 캐시 적중률에 달려 있고, 알아내는 방법은 실제 워크로드를 이 설정으로 돌려 보고 자기 사용량에서 숫자를 읽는 것입니다. 요금표와 TTL 계산은 API 레퍼런스에 정리해 뒀습니다.

연결이 안 될 때

흔한 실패 유형이 셋 있습니다.

• Request URL 끝의 슬래시. Ofox 문서가 두 프로바이더 모두에 대해 이 점을 명시합니다.
• 탭에 맞지 않는 API 형식. Codex CLI에 “Anthropic Messages (Native)“를 골라 두면 동작하지 않고, 반대도 마찬가지입니다. 키보다 형식 필드를 먼저 확인하세요.
• 카탈로그에 없는 모델 문자열. Fable 5.1의 Ofox ID는 하이픈이 아니라 점을 쓴 anthropic/claude-fable-5.1입니다. 별칭 anthropic/claude-fable-5-1도 해석되기는 합니다. 기준은 라이브 카탈로그입니다. GET /v1/models가 돌려주는 것이 정확히 호출 가능한 목록입니다.

CC Switch 설치 대상, 프로바이더 필드 값, base URL, 사용량 조회 동작은 2026년 9월 3일 Ofox 연동 문서에 대조해 확인했습니다. 카탈로그 내용은 같은 날 라이브 /v1/models 엔드포인트에 대조했습니다.