Codex의 주간 제한에 걸렸기 때문에, OpenCode Go를 계약하여 각종 모델을 Codex app에서 이용할 수 있도록 설정했습니다.

Codex App의 모델 메뉴에 Kimi K3를 추가하였고, 실제로 응답하는 것까지 확인을 마쳤습니다.

설정이 완료되면, Codex App의 평소 사용하던 모델 메뉴에서 Kimi K3를 선택하여 사용할 수 있습니다. Grok 4.5나 GLM-5.2 등도 동일한 메뉴에 추가할 수 있습니다.

이하는 제 환경에서 진행한 설정 기록입니다. 터미널은 사용하지 않고, CC Switch 화면만으로 설정했습니다.

이번에 사용한 것

• 평소 사용 중인 Codex App
• OpenCode Go의 API Key
• CC Switch

만약을 위한 메모

CC Switch 본체 측에서 Codex의 설정이 일부 누락되는 경우가 있다는 보고가 있습니다. 제 환경에서도 비슷한 현상이 있었기 때문에, 작업 전에 다음 두 파일을 복제해 두었습니다.

• Finder를 엽니다.
• 상단 메뉴에서 「이동」 → 「폴더로 이동」을 선택합니다.
• ~/.codex 라고 입력하고 Return 키를 누릅니다.
• config.toml 과 auth.json 을 선택하고, command + D로 복제합니다.

1. CC Switch에 OpenCode Go 추가하기

CC Switch를 공식 사이트 또는 공식 GitHub의 Releases에서 입수하여 실행한 뒤, 화면 상단에서 「Codex」를 선택했습니다.

이어서 「＋」를 누르고, 목록 중에서 「OpenCode Go」를 선택한 뒤 「추가」를 누릅니다.

목록 아래쪽에 있는 「OpenCode Go」를 선택하고, 오른쪽 아래의 「추가」를 누릅니다.

2. API Key와 4가지 항목 설정하기

OpenCode Go에서 발행한 API Key를 붙여넣습니다.

이번에 설정한 값은 다음 4가지입니다.

• 프로바이더 명 (Provider Name): OpenCode Go
• API 요청 URL (API Request URL): https://opencode.ai/zen/go/v1
• 기본 모델 (Default Model): kimi-k3
• 상류 포맷 (Upstream Format): Chat Completions (라우팅 필수)

API 요청 URL은 위의 문자열 그대로이며, 끝에 /chat/completions는 붙이지 않았습니다.

상류 포맷은 편집 화면을 아래로 스크롤하여 「고급 옵션 (Advanced Options)」을 열면 찾을 수 있습니다. 마지막으로 오른쪽 아래의 「저장」을 누릅니다.

도중에 「OpenAI Response 호환 서비스 엔드포인트를 입력해 주세요」라는 경고가 나왔지만, 상류 포맷을 위와 같이 설정하고 다음 라우팅 설정을 진행하니 실제로 접속할 수 있었습니다.

원래 있던 「OpenAI Official」은 원래의 접속으로 되돌릴 때 사용하기 위해 남겨두었습니다.

「OpenAI Official」을 남겨둔 채 「OpenCode Go」를 추가한 상태입니다.

3. 라우팅 스위치 2개를 켜기

CC Switch 왼쪽 하단의 톱니바퀴 아이콘에서 「설정 (Settings)」을 열고, 상단의 「라우팅 (Routing)」을 선택합니다. 이번에는 다음과 같이 설정했습니다.

• 「라우팅 총 스위치 (Routing Master Switch)」를 켬
• 「라우팅 유효 (Routing Enabled)」 중에서 「Codex」만 켬
• 화면 하단의 「사용 중 (In Use)」에서 Codex의 오른쪽이 「OpenCode Go」로 되어 있는지 확인

Claude와 Gemini는 이번에 사용하지 않으므로 꺼둔 상태입니다.

「서비스 주소 (Service Address)」는 자동으로 다음과 같이 표시되었습니다.

총 스위치와 Codex가 켜져 있고, 「사용 중」은 OpenCode Go로 되어 있습니다.

CC Switch가 중계 역할을 하기 때문에, Kimi K3를 사용하는 동안에는 실행 상태를 유지하고 있습니다.

4. Kimi K3를 모델 메뉴에 추가하기

CC Switch의 첫 화면으로 돌아가 「OpenCode Go」의 편집 화면을 엽니다. 아래로 스크롤하면 「모델 매핑 (Model Mapping)」이 있습니다.

다음 순서로 Kimi K3를 추가했습니다.

• 오른쪽의 「모델 목록 가져오기 (Get Model List)」를 누릅니다.
• 「모델 추가 (Add Model)」를 누릅니다.
• 메뉴 표시 이름에 「Kimi K3」라고 입력합니다.
• 실제 요청 모델에서 kimi-k3를 선택합니다.
• 오른쪽 아래의 「저장」을 누릅니다.

kimi-k3는 직접 입력하지 않고, 가져온 후보 중에서 선택했습니다.

왼쪽이 Codex App에 표시할 이름, 중앙이 실제로 호출하는 모델명입니다.

다른 모델도 추가하고 싶은 경우

획득한 후보에는 GLM 5.2, DeepSeek V4, MiMo V2.5 Pro 등도 있습니다. 이번에는 Kimi K3, Grok 4.5, Qwen3.7 Max도 추가했습니다.

이번에는 Kimi K3의 동작을 확인한 후, 다른 모델들도 추가했습니다.

「상류 포맷 (Upstream Format)」과, 획득 후의 모델 후보를 확인한 화면입니다.

5. Codex App을 재시작하여 테스트하기

CC Switch에서 「저장 (Save)」을 누른 후, Codex App을 일단 완전히 종료했다가 재시작했습니다.

새 채팅을 열면, 모델 메뉴에 「Kimi K3」가 표시되었습니다. Kimi K3를 선택하고, 간단한 요청을 보내봅니다.

테스트에는 예를 들어 다음과 같은 내용을 사용할 수 있습니다.

이 폴더에 무엇이 있는지, 파일을 변경하지 않고 간단히 알려주세요.

답변이 온 후, CC Switch의 「설정 (Settings)」 → 「이용 통계 (Usage Statistics)」를 확인하면 다음과 같은 내용이 기록되어 있었습니다.

• 앱: Codex

• 프로바이더 (Provider): OpenCode Go

• 상류 모델 (Upstream Model):
  kimi-k3

• 성공한 요청 수 (Successful Requests)가 증가함

제 환경에서는 Kimi K3로의 요청이 기록되었고, Codex App에서도 답변을 확인할 수 있었습니다.

실제로 확인한 포인트

모델 메뉴 반영

CC Switch에서 저장만 해서는 반영되지 않으며, Codex App을 완전히 종료하고 재시작하면 Kimi K3가 표시되었습니다. 모델 매핑은 「Kimi K3 / kimi-k3」입니다.

라우팅 (Routing) 상태

연결 시에는 CC Switch를 실행된 상태로 유지하고, 「라우팅 총 스위치 (Routing Total Switch)」와 「Codex」를 켜고, 「사용 중 (In Use)」을 OpenCode Go로 설정했습니다.

OpenAI Official로 되돌릴 때

• CC Switch의 Codex 화면에서 「OpenAI Official」을 선택
• 「설정 (Settings)」 → 「라우팅 (Routing)」에서 Codex를 끔
• Codex App을 재시작

요약

동일한 설정으로부터 Grok 4.5나 GLM-5.2 등도 Codex App의 모델 메뉴에 추가할 수 있었습니다.

다른 플랫폼이나 모델로 시도해 보신 분이 있다면 알려주시면 감사하겠습니다.

참고 자료

Discussion