CC Switch는 AI CLI용 크로스 플랫폼 설정 관리 도구입니다. 공식 Codex 설정과 여러 API 제공자를 시각적으로 전환할 수 있습니다. 이 가이드는 CC Switch 3.20 이상을 기준으로 합니다.

설정 개요

CC Switch는 ~/.codex/auth.json과 ~/.codex/config.toml을 관리합니다.

필드	값
Provider name	`4AICode`
API Key	대시보드의 `sk-4ai-...` 토큰
API endpoint	`https://relay.4aicode.com/v1`
Default model	`gpt-5.6-terra`
Upstream format	`OpenAI Responses API`

4AICode는 Responses API를 직접 지원합니다. Full URL mode와 로컬 라우팅은 끄세요.

1. 토큰 및 클라이언트 준비

대시보드 → 토큰 관리에서 sk-4ai-... 토큰 생성.
CC Switch 웹사이트 또는 GitHub Releases에서 최신 버전 설치.
Codex CLI 설치.

가이드의 sk-4ai-xxxxxxxxxxxxxxxx는 placeholder입니다. 제공자 입력 시 대시보드에서 만든 토큰으로 바꾸고, 실제 토큰은 버전 관리·비공개 메시지에 넣지 마세요.

첫 실행 시 CC Switch가 기존 Codex 설정을 가져올 수 있습니다. 제공자를 바꿀 때마다 Codex 설정 파일을 갱신합니다.

2. 4AICode 제공자 추가

CC Switch 상단에서 Codex 선택.
우측 상단 + 클릭.
App-specific provider에 머물고 Custom 프리셋 선택.
다음 값 입력:

CC Switch 필드	값
Name	`4AICode`
API Key	`sk-4ai-xxxxxxxxxxxxxxxx`
API endpoint / Base URL	`https://relay.4aicode.com/v1`
Default model	`gpt-5.6-terra`

권장 엔드포인트는 지역별: 국제망은 .com, 중국 본토는 https://relay.4aicode.net/v1. 영문 예시는 .com 기준.

3. 고급 옵션 확인

Advanced options를 펼치고 확인:

옵션	설정
Upstream format	`OpenAI Responses API`
Full URL mode	Off
Local routing / mapping	Off; 최근 CC Switch는 upstream format에서 추론해 스위치를 숨길 수 있음
Model mapping	비움

https://relay.4aicode.com/v1은 API 접두사입니다. Full URL mode가 꺼져 있으면 Codex가 /responses 경로를 붙입니다.

폼 하단 config.toml (TOML) 편집기에서 model_reasoning_effort를 xhigh로. 이 가이드 권장값이며 CC Switch가 Codex 설정에 기록합니다.

Add로 저장.

4. 활성화 및 확인

4AICode 제공자 카드에서 Enable 클릭.
실행 중인 Codex CLI·Codex App 인스턴스를 모두 종료.
새 터미널에서:

codex

「List this directory and explain the project structure」 같은 간단한 작업을 입력해 정상 응답이면 설정 완료.

CC Switch로 제공자를 바꾼 뒤에는 Codex 재시작이 필요합니다. 이후 전환은 메인 창 또는 시스템 트레이에서.

모델 변경

4AICode 제공자를 편집해 Default model에 모델 입력. 현재 4AICode가 노출하는 모델; 대시보드 모델 목록·계정 풀 상태가 기준:

Model	권장 용도
`gpt-6-astra`	차세대 플래그십; 공식 가격의 15% 과금
`gpt-5.6-sol`	복잡한 엔지니어링·최강 추론
`gpt-5.6-terra`	일상 코딩; 기본 권장
`gpt-5.6-luna`	빠르고 경제적
`gpt-5.5`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.3-codex`	기존 워크플로

gpt-5.6-sol은 max reasoning effort 지원. 다른 모델은 xhigh 권장. max는 reasoning 연산·응답 시간·비용이 더 큼. 저장 후 제공자 다시 Enable하고 Codex 재시작.

설정 참고

CC Switch는 서드파티 API-key 제공자용 토큰을 아래 예와 동일한 의미로 auth.json에 저장합니다. 공식 ChatGPT 로그인 모드는 tokens·last_refresh가 있는 별도 인증 구조이며, CC Switch는 제공자 유형별로 관리합니다. 제공자 ID·섹션 이름은 다를 수 있습니다.

auth.json:

{
  "OPENAI_API_KEY": "sk-4ai-xxxxxxxxxxxxxxxx"
}

config.toml:

model_provider = "custom"
model = "gpt-5.6-terra"
model_reasoning_effort = "xhigh"

[model_providers.custom]
name = "4AICode"
base_url = "https://relay.4aicode.com/v1"
wire_api = "responses"
requires_openai_auth = true

requires_openai_auth = true는 이 제공자가 auth.json에서 API key를 읽도록 합니다.

문제 해결

증상	조치
Codex가 이전 제공자 사용	4AICode 카드에 “Currently enabled” 확인, Codex 완전 종료 후 새 터미널 또는 앱 재시작
`401`	대시보드에서 API key 전체·활성 여부 확인
`404`	Base URL이 `/v1`로 끝나고 Full URL mode 꺼짐 확인
CC Switch 로컬 프록시 경유	Responses format 선택, 로컬 라우팅 takeover 비활성
가이드 필드 없음	CC Switch 업그레이드; 필드 라벨은 앱 버전 따름

설치 스크립트, Codex App 모바일, SDK 예제는 ChatGPT / Codex 설정 참고.

CC Switch 설정