> ## Documentation Index
> Fetch the complete documentation index at: https://platform.kimi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 在 Codex CLI 中使用 Kimi K3
本文介绍如何通过 CC Switch，将 Codex CLI 接入 Kimi 开放平台并使用 `kimi-k3` 模型。
Codex CLI 目前支持文本和图片输入，但尚未提供原生视频输入通道，无法将视频文件直接作为多模态输入提交给模型。若仅通过 Codex CLI 的现有输入方式分析视频，可以先使用 ffmpeg 提取关键帧，并根据需要结合音频转写后交给模型处理。需要说明的是，这是 Codex CLI 输入层的限制，并非 Kimi K3 模型的能力限制——Kimi K3 API 原生支持视频输入，按 [视觉输入](/guide/use-kimi-vision-model) 直接调用 `kimi-k3` 即可进行完整的视频理解，无需手动抽帧。
## 准备工作
开始前，请完成以下准备工作。安装和账号相关操作请按照对应的官方指引完成，本文不再展开。
按照 Codex 官方文档完成安装，并至少启动一次 Codex CLI。
在 Kimi 开放平台创建并保存 API Key。
按照 CC Switch 官方指引下载并安装适合当前操作系统的版本。
CC Switch 是第三方开源工具，不属于 Kimi 开放平台。使用前，请根据所在组织的安全与合规要求进行评估；API Key 以及 Codex 的请求和响应将由其本地路由处理。
完成安装后，打开 CC Switch，再按照下面的步骤操作。
## 第一步：开启 Codex 路由
在 CC Switch 中进入 **设置 > 路由**，然后：
1. 开启 **路由总开关**，启动本地路由服务。
2. 在 **路由启用** 区域开启 **Codex**。
Codex CLI 使用 Responses API，而 Kimi 开放平台提供 OpenAI 兼容的 Chat Completions API。CC Switch 的本地路由负责转换请求和流式响应，因此使用 Kimi Provider 时必须保持 CC Switch 和 Codex 路由处于运行状态。
## 第二步：添加 Kimi Provider
1. 返回 CC Switch 主界面，选择顶部的 **Codex** Tab。
2. 点击右上角的 **+**，添加供应商。
3. 确认当前位于 **Codex 供应商** 页面，然后在预设供应商列表中选择 **Kimi**。
4. 填写以下配置：
| 配置项 | 值 |
| ------------------ | ---------------------------- |
| API 请求地址（Base URL） | `https://api.moonshot.cn/v1` |
| API Key | 在 Kimi 开放平台创建的 API Key |
| 默认模型 | `kimi-k3` |
5. 将默认模型改为 `kimi-k3` 后，点击 **加入映射**。
6. 向下滚动并确认以下高级配置：
| 配置项 | 值 |
| ------- | ------------------------- |
| 上游格式 | `Chat Completions（需开启路由）` |
| 提示词缓存路由 | `自动（推荐）` |
| 支持思考模式 | 开启 |
| 支持思考等级 | 开启 |
| 菜单显示名 | `kimi-k3` |
| 实际请求模型 | `kimi-k3` |
| 上下文窗口 | `1048576` |
7. 确认配置无误后，点击右下角的 **添加**。
## 第三步：启用 Kimi Provider
添加完成后返回 Codex 供应商列表，在刚添加的 Kimi Provider 上点击 **启用**。
启用后，请确认：
* Kimi 是 Codex Tab 中当前启用的 Provider；
* CC Switch 的本地路由正在运行；
* Codex 路由开关处于开启状态。
## 第四步：启动 Codex CLI
如果 Codex CLI 已经在运行，请先退出当前会话。然后进入需要使用的项目目录，重新启动 Codex CLI：
```bash theme={null}
cd /path/to/your/project
codex
```
重新启动是为了让 Codex CLI 加载 CC Switch 写入的最新 Provider 和模型配置。
启动后，先确认 Codex CLI 顶部显示的模型为 `kimi-k3`，然后发送一个简单请求：
```text theme={null}
hello
```
如果 Codex CLI 正常返回结果，并且底部状态栏显示 `kimi-k3`，说明配置已经生效。
你也可以查看 CC Switch 的路由请求数或请求日志，确认其中出现了新的 Codex 请求。