메인 콘텐츠로 건너뛰기

​
준비 사항

  1. ToAPIs Console에서 ToAPIs API 키를 생성합니다.
  2. Codex 공식 문서를 따라 Codex CLI를 설치하거나 다음 명령을 실행합니다.
  3. CC Switch 공식 사이트 또는 공식 GitHub Releases에서 CC Switch를 설치합니다.

​
CC Switch에 ToAPIs 추가

  1. CC Switch를 열고 앱 전환기에서 Codex를 선택합니다.
  2. 오른쪽 위 **+**를 클릭하고 앱 전용 공급자를 선택합니다.
  3. Custom 프리셋을 선택하고 다음 값을 입력합니다.
  1. 추가를 클릭한 뒤 ToAPIs 공급자 카드에서 활성화를 클릭합니다.
  2. 실행 중인 Codex와 터미널을 종료하고 터미널을 다시 엽니다.
ToAPIs는 POST /v1/responses를 기본 지원합니다. Chat Completions 전용 공급자에 사용하는 로컬 라우팅/모델 매핑은 켜지 마세요.

​
실행 및 확인

간단한 작업을 입력합니다.
정상적으로 응답하면 설정이 완료된 것입니다.

​
모델 변경

CC Switch의 모델 가져오기 버튼으로 /v1/models에서 사용 가능한 모델을 확인할 수 있습니다. ToAPIs 모델 목록에서도 모델 ID를 확인할 수 있습니다. 일반적인 코드 작업에는 gpt-5.3-codex, 속도 우선 작업에는 gpt-5.3-codex-spark, 공식 직결 채널이 필요한 경우에는 gpt-5.3-codex-official을 선택하세요. 실제 사용 가능 모델은 CC Switch가 /v1/models에서 가져온 목록을 우선합니다.

​
문제 해결

  • 이전 공급자가 계속 사용됨: Codex와 터미널을 완전히 종료한 후 다시 실행합니다.
  • 401 Unauthorized: API 키, 키 상태, 계정 잔액을 확인합니다.
  • 404 또는 Responses 경로 오류: Base URL, Responses 프로토콜, 로컬 라우팅이 꺼져 있는지 확인합니다.
  • 모델 사용 불가: 같은 키로 /v1/models를 조회합니다.
CC Switch는 ~/.codex/auth.json과 ~/.codex/config.toml을 관리합니다. 이 파일이나 API 키를 Git에 커밋하지 마세요. 자세한 내용은 CC Switch 공식 사용자 매뉴얼을 참고하세요.