跳转到主要内容
本文介绍如何通过 CC Switch,将 Codex CLI 接入 Kimi 开放平台并使用 kimi-k3 模型。
Codex CLI 目前支持文本和图片输入,但尚未提供原生视频输入通道,无法将视频文件直接作为多模态输入提交给模型。若仅通过 Codex CLI 的现有输入方式分析视频,可以先使用 ffmpeg 提取关键帧,并根据需要结合音频转写后交给模型处理。需要说明的是,这是 Codex CLI 输入层的限制,并非 Kimi K3 模型的能力限制——Kimi K3 API 原生支持视频输入,按 视觉输入 直接调用 kimi-k3 即可进行完整的视频理解,无需手动抽帧。

准备工作

开始前,请完成以下准备工作。安装和账号相关操作请按照对应的官方指引完成,本文不再展开。

安装 Codex CLI

按照 Codex 官方文档完成安装,并至少启动一次 Codex CLI。

创建 API Key

在 Kimi 开放平台创建并保存 API Key。

安装 CC Switch

按照 CC Switch 官方指引下载并安装适合当前操作系统的版本。
CC Switch 是第三方开源工具,不属于 Kimi 开放平台。使用前,请根据所在组织的安全与合规要求进行评估;API Key 以及 Codex 的请求和响应将由其本地路由处理。
完成安装后,打开 CC Switch,再按照下面的步骤操作。

第一步:开启 Codex 路由

在 CC Switch 中进入 设置 > 路由,然后:
  1. 开启 路由总开关,启动本地路由服务。
  2. 路由启用 区域开启 Codex
开启 CC Switch 本地路由和 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. 点击右上角的 +,添加供应商。
进入 Codex Tab 并添加供应商
  1. 确认当前位于 Codex 供应商 页面,然后在预设供应商列表中选择 Kimi
选择 Kimi 预设供应商
  1. 填写以下配置:
  1. 将默认模型改为 kimi-k3 后,点击 加入映射
填写 Kimi API Key、请求地址和默认模型
  1. 向下滚动并确认以下高级配置:
  1. 确认配置无误后,点击右下角的 添加
配置 Kimi 上游格式、思考能力和模型映射

第三步:启用 Kimi Provider

添加完成后返回 Codex 供应商列表,在刚添加的 Kimi Provider 上点击 启用 启用 Kimi Provider 启用后,请确认:
  • Kimi 是 Codex Tab 中当前启用的 Provider;
  • CC Switch 的本地路由正在运行;
  • Codex 路由开关处于开启状态。

第四步:启动 Codex CLI

如果 Codex CLI 已经在运行,请先退出当前会话。然后进入需要使用的项目目录,重新启动 Codex CLI:
重新启动是为了让 Codex CLI 加载 CC Switch 写入的最新 Provider 和模型配置。 启动后,先确认 Codex CLI 顶部显示的模型为 kimi-k3,然后发送一个简单请求:
如果 Codex CLI 正常返回结果,并且底部状态栏显示 kimi-k3,说明配置已经生效。 在 Codex CLI 中验证 kimi-k3 你也可以查看 CC Switch 的路由请求数或请求日志,确认其中出现了新的 Codex 请求。