CC-Switch Codex
이 페이지에서는 CC Switch를 통해 Codex 제공자(Provider)를 관리하는 방법을 설명합니다. Codex 클라이언트나 Codex CLI에서 직접 설정하는 것과는 다르며, CC Switch에서 제공자를 먼저 등록 및 관리한 후 Codex에 적용하는 방식입니다.
공식 정보 다운로드 및 공식 문서는 공식 사이트를 참고하세요.
이 페이지에서 설명하는 내용
Codex는 주로 OpenAI 또는 OpenAI 호환 인터페이스를 통해 동작하므로 Base URL, Key, 모델 이름 세 가지 항목을 중점적으로 확인해야 합니다. Base URL에 /v1이 포함되어야 하는지 여부는 제공자 관리자 콘솔에 표시된 안내를 따릅니다.
시작 전 확인 사항
| 확인 항목 | 확인 방법 | 이유 |
|---|---|---|
| Codex 정상 실행 여부 | 먼저 Codex CLI 또는 해당 클라이언트 자체가 정상 실행되는지 확인 | CC Switch가 Codex 자체를 설치해 주지는 않음 |
| 제공자의 OpenAI 호환 인터페이스 지원 여부 | 관리자 콘솔에서 API 주소, Base URL, OpenAI 호환 관련 안내 확인 가능 | Codex가 호환 인터페이스로 요청을 보낼 수 있어야 함 |
| Codex 시나리오에서 사용 가능한 모델인지 여부 | 관리자 콘솔의 모델 목록에서 사용 가능한 모델명 확인 가능 | Claude/Gemini 모델명을 Codex에 입력하지 마세요 |
| Key 상태 정상 여부 | 관리자 콘솔의 토큰이 만료/비활성화되지 않았고 잔액이 정상인지 확인 | 대부분의 401 오류는 Key 확인부터 시작해야 함 |
항목 입력 방법
| 설정 항목 | 입력 방법 | 초보자 주의사항 |
|---|---|---|
| 제공자 이름 (Provider Name) | 제공자 이름 또는 용도 입력 | 예: '메인 OpenAI 호환 제공자' |
| 대상 도구 / 프리셋 (Target Tool / Preset) | Codex 또는 OpenAI/Codex 관련 프리셋 선택 | Claude Code 또는 Gemini를 선택하지 마세요 |
| Base URL | 제공자 관리자 콘솔에 안내된 API 주소 복사 | 일반적으로 제공자가 제공하는 API 주소이며, /v1 포함 여부는 콘솔 예시를 따름 |
| API Key | 전체 Key 복사 | 앞뒤에 불필요한 공백을 넣지 말고, 메모/이름을 복사하지 않도록 주의 |
| 모델 이름 (Model Name) | 관리자 콘솔의 모델명을 그대로 복사 | 모델 목록 자동 불러오기가 실패하면 직접 수동 추가하되, 콘솔의 모델명과 일치시킬 것 |
Codex에 적용하기
- CC Switch를 열고 제공자(Provider) 관리 화면으로 이동합니다.
- 새 제공자를 추가하거나 기존 OpenAI 호환 제공자를 선택합니다.
- 대상 도구로 Codex 또는 OpenAI/Codex 관련 프리셋을 선택합니다.
- Base URL, API Key, 모델 이름을 입력하고 저장합니다.
- Apply / Switch를 실행하여 해당 제공자를 Codex에 적용합니다.
- 현재 터미널 창을 닫고 다시 연 후 테스트합니다.
정상 작동 테스트
먼저 가장 간단한 질문으로 요청이 제대로 전송되는지 테스트합니다. 테스트가 성공하면 실제 프로젝트에서 사용하세요.
Codex 최소 테스트
codex "Please reply only: CC-Switch Codex is active"모델이 존재하지 않는다는 오류가 반환되면 모델 이름을 먼저 확인하고, 권한 없음(Unauthorized) 오류가 발생하면 Key를, 연결 시간 초과 시에는 Base URL과 네트워크를 먼저 확인하세요.