Kimi Codex CLI

상위 문서: ← Kimi Integrations 출처: Kimi API Platform 공식 문서 — Use Kimi K3 in Codex CLI 한글화 (2026-07-22) 공급사: Moonshot AI (月之暗面)

이 가이드는 CC Switch를 통해 Codex CLI를 Kimi Open Platform에 연결하고, kimi-k3 모델을 사용하는 방법을 설명합니다.

Codex CLI는 현재 텍스트/이미지 입력은 지원하지만 네이티브 비디오 입력 채널은 제공하지 않습니다. 비디오 분석이 필요하면 ffmpeg으로 키프레임을 추출한 뒤 오디오 전사와 결합해 전달하세요. 이는 Kimi K3 모델의 한계가 아니라 Codex CLI 입력 계층의 한계입니다. Kimi K3는 비디오 입력을 네이티브로 지원합니다 — Vision Input 가이드대로 kimi-k3를 직접 호출하면 수동 프레임 추출 없이 비디오를 분석할 수 있습니다.

사전 준비

Codex CLI 공식 문서에 따라 설치하고 최소 한 번 실행
Kimi Open Platform에서 API Key 생성
CC Switch 공식 안내에 따라 OS에 맞는 버전 설치

CC Switch는 서드파티 오픈소스 도구이며 Kimi Open Platform과 별개입니다. 사용 전 회사 보안/컴플라이언스 요건에 맞게 평가하세요. API Key와 Codex 요청/응답은 로컬 라우터에서 처리됩니다.

설치 후 CC Switch를 열고 아래 단계로 진행합니다.

1단계: Codex 라우팅 활성화

CC Switch에서 Settings > Routing으로 이동해:

Routing Master Switch를 켜서 로컬 라우팅 서비스 시작
Routing Enabled에서 Codex 활성화

Codex CLI는 Responses API를, Kimi Open Platform은 OpenAI 호환 Chat Completions API를 사용합니다. CC Switch 로컬 라우팅이 두 프로토콜 간 요청/스트리밍 응답을 변환합니다. Kimi 프로바이더 사용 중에는 CC Switch와 Codex 라우팅을 모두 켜둔 상태로 유지하세요.

2단계: Kimi 프로바이더 추가

CC Switch 홈 화면에서 상단 Codex 탭 선택
우측 상단 + 클릭 → 프로바이더 추가
Codex Provider 페이지에서 검색창에 Kimi 입력 → 프리셋 목록에서 Kimi 선택
다음 설정 입력:

설정	값
API request URL (Base URL)	`https://api.moonshot.ai/v1`
API key	Kimi Open Platform에서 생성한 API Key
Default model	`kimi-k3`

Default model을 kimi-k3로 바꾼 뒤 Add to mapping 클릭
아래로 스크롤해 다음 고급 설정 확인:

설정	값
Upstream format	`Chat Completions (routing required)`
Prompt cache routing	`Auto (recommended)`
Supports thinking mode	On
Supports reasoning effort	On
Menu display name	`kimi-k3`
Actual request model	`kimi-k3`
Context window	`1048576`

확인 후 우측 하단 Add 클릭

3단계: Kimi 프로바이더 활성화

Codex 프로바이더 목록으로 돌아가 추가한 Kimi 프로바이더의 Enable 클릭. 다음을 확인:

Codex 탭의 active 프로바이더가 Kimi
CC Switch 로컬 라우팅이 실행 중
Routing 설정의 Codex가 활성화 상태

4단계: Codex CLI 시작

Codex CLI가 이미 실행 중이라면 세션을 종료하고, 작업할 프로젝트 디렉토리로 이동해 다시 시작합니다:

cd /path/to/your/project
codex

Codex CLI가 CC Switch가 쓴 최신 프로바이더/모델 설정을 로드하려면 재시작이 필요합니다.

시작 후 Codex CLI가 kimi-k3를 현재 모델로 표시하면, 간단한 요청을 보냅니다:

hello

Codex CLI가 응답을 반환하고 상태 표시줄에 kimi-k3가 보이면 설정이 정상입니다. CC Switch 라우팅 카운터나 요청 로그에서 새 Codex 요청이 잡히는지 확인할 수도 있습니다.

변경 이력

날짜	변경
2026-07-22	초판 작성 (공식 Codex CLI 통합 가이드 한글화)
2026-07-22	제목에 "Kimi" 접두사 추가, 본문 H1 중복 제거