CC-Switch에서 BeatAPI 사용하기

CC-Switch는 Claude Code, Codex CLI, Gemini CLI 등 여러 AI 코딩 CLI의 제공자 설정을 한곳에서 관리하는 오픈 소스 데스크톱 앱입니다. BeatAPI를 한 번 추가해 두면 편집기를 열지 않고 클릭 한 번으로 전환하거나 되돌릴 수 있습니다.

사전 준비

지원되는 CLI를 하나 이상 설치 — Claude Code 또는 Codex CLI.
BeatAPI API 키 — 대시보드 → API Keys에서 만드세요.

1단계: CC-Switch 설치

macOS

Windows

Linux

brew tap farion1231/ccswitch
brew install --cask cc-switch

서명된 .dmg는 GitHub Releases에서도 받을 수 있습니다. macOS 12 이상이 필요합니다.

처음 실행하면 CC-Switch가 이미 설치된 CLI를 감지하고 현재 설정을 기본 제공자로 가져올 수 있습니다.

2단계: BeatAPI 추가

메인 창 위쪽에서 도구 그룹을 선택합니다. 사용하는 CLI를 설정하세요.

Claude Code

Claude Code 그룹을 선택하세요.
오른쪽 위의 **+**를 클릭하세요.
양식을 작성하세요.

필드	값
이름	`BeatAPI`
엔드포인트 URL	`https://api.beatapi.io`
API Key	BeatAPI API 키
API 형식	`Anthropic Messages`

Add를 클릭하세요.

Codex

Codex 그룹을 선택하세요.
오른쪽 위의 **+**를 클릭하세요.
Codex 제공자는 블록 두 개로 구성됩니다. auth.json 블록에는 다음을 입력합니다.

{
  "OPENAI_API_KEY": "<BEATAPI_API_KEY>"
}

config.toml 블록에는 다음을 입력합니다.

model = "gpt-5.6-sol"
model_provider = "beatapi"
[model_providers.beatapi]
name = "BeatAPI"
base_url = "https://api.beatapi.io/v1"
wire_api = "responses"
requires_openai_auth = true

이름을 BeatAPI로 지정하고 Add를 클릭하세요. CC-Switch가 저장 전에 JSON과 TOML을 모두 검사합니다.

두 URL은 의도적으로 다르며, 둘을 혼동하는 것이 가장 흔한 설정 실패 원인입니다. Claude Code는 https://api.beatapi.io의 Anthropic 네이티브 형식을 사용하며 클라이언트가 /v1/messages를 직접 붙이므로 /v1이 없습니다. Codex는 https://api.beatapi.io/v1의 OpenAI 호환 형식을 사용하며 /v1이 있습니다.

3단계: 전환

메인 창에서: 제공자 목록에서 BeatAPI를 선택하고 Enable을 클릭하세요. 확인 알림이 표시됩니다.

시스템 트레이에서: CC-Switch 아이콘을 클릭하고 메뉴에서 제공자를 고르세요.

Claude Code는 즉시 전환되며 새 세션부터 변경 사항이 적용됩니다. Codex는 터미널이나 에이전트를 다시 시작해야 합니다.

모델

모델 ID	사용 가능한 도구	추천 용도
`claude-fable-5-1`	Claude Code	최신 세대. 에이전트 코딩의 기본값
`claude-opus-5`	Claude Code	가장 강력한 추론 등급
`claude-sonnet-5`	Claude Code	성능과 속도의 균형
`gpt-5.6-sol`	Codex	가장 강력한 코딩 등급
`gpt-6-astra`	Codex	최신 세대. 입력 토큰이 272K를 넘으면 요금이 높아짐

두 CLI 모두 /model로 모델을 바꿀 수 있습니다. 전체 목록은 텍스트 API 페이지에, 요금은 가격 페이지에 있습니다.

자주 묻는 질문

전환해도 적용되지 않음

Claude Code — 새 세션을 시작하세요. 계속되면 에이전트를 다시 시작하세요.
Codex — 터미널이나 Codex를 다시 시작하세요.

키가 거부됨

키를 앞뒤 공백 없이 전부 복사했는지 확인하세요.
대시보드 → API Keys에서 활성 상태인지 확인하세요.
위의 참고 사항에 맞게 엔드포인트 URL을 다시 확인하세요. Claude Code는 /v1 없이, Codex는 포함해서 씁니다.

Codex 제공자 추가 시 형식 오류

CC-Switch는 auth.json을 JSON으로, config.toml을 TOML로 검사합니다. 빠진 중괄호나 쉼표, 철자가 틀린 필드, 문서에서 붙여 넣은 둥근 따옴표가 있는지 확인하세요.

어떤 파일을 수정하나요?

Claude Code: ~/.claude/settings.json
Codex: ~/.codex/config.toml, ~/.codex/auth.json

CC-Switch는 전환할 때마다 이 파일을 백업하므로 직접 편집할 필요가 없습니다.

지원

대시보드에서 지원 티켓을 열고 실패한 응답의 request_id를 함께 보내 주세요.