Codex 接入 Kimi 模型配置与使用教程

Wed, 19 Aug 2026 16:59:13 +0800

Codex 默认使用 OpenAI 自家的模型，但也支持通过 model provider 接入第三方模型。Kimi Code 提供了兼容 Codex Responses API 的接口，下面记录一下使用 Kimi K3 作为 Codex 模型的配置方法。

前置要求

已安装 Codex CLI：npm i -g @openai/codex
已通过 https://www.kimi.com/code 进入 Kimi Code 控制台并创建 API Key
当前终端可以正常运行 Codex，并且能够访问 https://api.kimi.com/coding/v1

配置文件

Codex 的用户级配置目录位于 ~/.codex。创建 kimi.config.toml，将 Kimi Code 配置为一个模型供应商：

model = "k3"
model_provider = "kimi"
model_context_window = 1048576
model_supports_reasoning_summaries = false
web_search = "disabled"

[model_providers.kimi]
name = "Kimi Code"
base_url = "https://api.kimi.com/coding/v1"
env_key = "KIMI_API_KEY"
wire_api = "responses"
stream_idle_timeout_ms = 600000

这里的配置文件名和 profile 名称对应。kimi.config.toml 放在 $CODEX_HOME 下时，就可以通过 --profile kimi 加载；如果没有设置 CODEX_HOME，默认目录就是 ~/.codex。

几个关键配置的作用如下：

model = "k3"：使用 Kimi K3 模型。
model_provider = "kimi"：引用下面的 [model_providers.kimi] 配置。
model_context_window = 1048576：声明模型支持的上下文窗口大小，适合处理较大的代码库和较长的任务上下文。
model_supports_reasoning_summaries = false：关闭 reasoning summaries 能力声明，避免客户端按不兼容的格式处理响应。
web_search = "disabled"：关闭 Codex 的网页搜索能力，当前配置只使用 Kimi 的编码接口。
base_url：Kimi Code 的 Responses API 地址。
env_key：告诉 Codex 从哪个环境变量读取 API Key。
wire_api = "responses"：使用 Responses API 协议。
stream_idle_timeout_ms = 600000：将流式响应空闲超时设置为 600000 毫秒，也就是 10 分钟，给较长的编码任务留出更充足的等待时间。

配置 API Key

在 ~/.zshrc 或 ~/.bashrc 中添加：

export KIMI_API_KEY="your-kimi-api-key"

然后重新打开终端，或者执行下面的命令使配置生效：

source ~/.zshrc

如果使用的是 Bash，则执行 source ~/.bashrc。API Key 只通过环境变量传递，不要直接写进提交到 Git 仓库的配置文件或 alias 中。

使用

配置完成后，通过 --profile 参数启动 Kimi 版 Codex：

codex --profile kimi

启动后，Codex 会加载 $CODEX_HOME/kimi.config.toml，并通过 https://api.kimi.com/coding/v1 请求 Kimi K3。如果想使用 Codex 默认的 OpenAI 模型，直接运行不带 profile 的命令即可：

codex

灵活切换 - alias 快捷命令

每次输入 --profile kimi 有点麻烦，可以在 Shell 配置中定义 alias：

alias codexkimi="codex --profile kimi"

之后输入 codexkimi 就会启动 Kimi 版 Codex，输入 codex 则使用默认模型，不需要反复修改 TOML 配置文件。

实际体验

这套配置的重点不是修改 Codex 本身，而是利用 model provider 机制把请求切换到 Kimi Code。Kimi K3 的百万 Token 上下文窗口更适合代码库较大、上下文较长的任务；stream_idle_timeout_ms 设置为 10 分钟后，长任务也不容易因为一段时间没有流式输出而过早超时。

需要注意的是，web_search = "disabled" 表示 Codex 不会使用网页搜索能力。如果任务依赖最新的网页资料，需要先自行准备资料，或者在不使用该 profile 时采用其他搜索工具。API 请求产生的费用也由 Kimi Code 账号承担，使用前应确认账户余额和服务条款。

写在最后

Codex 的 model provider 配置让切换 Kimi Code 变得很直接：准备好 API Key，放入 KIMI_API_KEY 环境变量，再用 kimi.config.toml 和 --profile kimi 启动即可。对需要较大上下文窗口、又希望使用 Kimi 编码模型的场景，这是一种比较省事的接入方式。

Kimi | 进击之路 - Alan的个人博客