Codex 接入 Kimi 的兼容性检查

当前结论（2026-08 核对）：不提供可确认的 Codex 原生接入配置。 Kimi 官方 API 概览明确说明兼容 OpenAI Chat Completions；Codex 自定义 provider 当前需要 Responses API。两者不是同一种协议。

教程目标

学会判断 Kimi 何时可以原生接入 Codex，并在官方协议未满足前避免写入无效配置或泄露 API Key。

为什么不能直接复制旧配置

Kimi 官方 Base URL https://api.moonshot.cn/v1 可用于其 Chat Completions API，但在 Codex 中配置 base_url 后，Codex 会按 Responses wire API 请求 /responses。只看到“兼容 OpenAI”不足以证明可用。

匿名请求返回 401 也只能说明鉴权发生在路由判断之前，不能证明请求体、流式事件、工具调用和 Codex 完整任务链兼容。

第 1 步：检查官方文档

在 Kimi 官方 API 索引中同时确认：

1. 是否明确列出 POST /v1/responses。
2. 是否有 Responses 请求体与流式事件说明。
3. 目标模型是否支持工具调用和本地代码代理需要的事件。
4. 中国站与国际站的域名、模型和 Key 是否对应。

当前官方 API 概览只确认 Chat Completions，所以应停在这里。

第 2 步：不要写入这类配置

# 当前不要把 Chat Completions 地址当作已验证的 Codex provider
[model_providers.moonshot]
base_url = "https://api.moonshot.cn/v1"
wire_api = "responses"

仅添加 wire_api = "responses" 不会把 Chat 协议自动转换成 Responses 协议。

可选路径

• 使用 Kimi 官方支持的 SDK、Kimi Code 或明确兼容 Chat Completions 的工具。
• 继续使用 Codex 官方支持的模型/provider。
• 使用第三方协议转换层前，先审查源码、权限、日志、密钥存储、更新来源与回滚方式，并把它视为独立安全边界。

以后官方支持时怎么验收

请只读核对 Kimi 官方文档中的 Responses API 端点、认证、模型和流式事件。
只有官方文档明确支持后，才生成 Codex config.toml 草稿。
配置不得包含真实 API Key；先用一句话响应，再做只读项目分析，最后检查 Git 状态。

常见误区

• /chat/completions 能返回，就认为 Codex 能用：协议判断错误。
• /responses 返回 401，就认为完整兼容：未经过账号和事件级验证。
• 使用来历不明的转换器：密钥和代码可能被第三方读取。
• 把 Kimi 网页会员、Coding 套餐和 API 余额混为一谈：计费与授权可能独立。

验收结果

1. 已确认当前官方文档只明确支持 Chat Completions。
2. 未向 Codex 配置写入未经证实的 Kimi provider。
3. API Key 没有出现在聊天、截图、仓库或配置明文中。
4. 知道必须等官方 Responses 文档与实际账号测试都通过后才能改状态。

参考：https://platform.kimi.com/docs/api/overview

下一篇看：Responses API 和 Chat Completions 的区别。