CC Switch로 Claude Code와 Codex 중계 서비스 설정을 관리하기

어떤 문제를 푸나

Claude Code만 쓰고 서비스 하나에만 연결한다면, 환경 변수를 직접 설정하는 것으로 충분합니다.

구성이 더 복잡할 때는 CC Switch 같은 도구가 도움이 됩니다.

• Claude Code, Codex, Gemini CLI, OpenCode 또는 비슷한 도구를 동시에 씁니다
• 공식 계정, AI API 중계 서비스, 로컬 모델을 자주 바꿉니다
• 프로바이더, API 키, Base URL, MCP, 프롬프트, 스킬을 한곳에서 관리하고 싶습니다
• settings.json, config.toml, 셸 프로필을 직접 고치는 일을 줄이고 싶습니다

새 AI 코딩 도구가 아닙니다. AI 코딩 CLI를 위한 로컬 제어판입니다.

권장 작업 순서

첫날에 설정을 한꺼번에 가져오지 마세요. 더 안정적인 순서는 다음과 같습니다.

1. 먼저 Claude Code 또는 Codex의 최소 설정을 직접 실행합니다.
2. Base URL, API 키, 모델 이름이 모두 동작하는지 확인합니다.
3. 동작하는 설정을 CC Switch에 추가합니다.
4. 전환할 때마다 해당 CLI나 터미널 세션을 다시 열고 설정이 적용됐는지 확인합니다.

이렇게 하면 문제가 났을 때 서비스 API가 깨진 것인지, 전환 도구가 동기화에 실패한 것인지 구분할 수 있습니다.

확인할 필드

• 프로바이더 이름: 본인용 표시입니다. 서비스와 프로토콜을 넣으세요.
• Base URL: 서비스 문서를 그대로 따르세요. 특히 /v1 여부를 확인합니다.
• API 키 / 토큰: OpenAI 키, Anthropic 키, Bearer 토큰을 구분합니다.
• 모델 이름: claude-sonnet이나 gpt-5 같은 별칭이 항상 있다고 가정하지 마세요.
• 대상 도구: 같은 서비스가 Claude Code에서는 되고 Codex에서는 안 될 수 있습니다.

유용한 원칙

전환 도구는 설정을 관리합니다. API 호환을 보장하지 않습니다. 실제로 되는지는 해당 CLI가 필요로 하는 프로토콜, 모델, 스트리밍 동작을 서비스가 지원하는지에 달려 있습니다.