AREX Feed Article
Kimi API 兼容 OpenAI 与 Anthropic 两种接口格式,Codex 和 Claude Code 可直连 kimi-k3
据 9 月 2 日 20:54 报道,月之暗面当天宣布:Kimi API 现已同时支持 OpenAI Responses API 与 Anthropic Messages API 两种请求格式,开发者无需转换格式、也不用架本地代理,即可通过 Codex 或 Claude Code 直连 Kimi 模型。
可直连的不止一款。公告列出的模型清单是 kimi-k3、kimi-k2.7-code-highspeed、kimi-k2.7-code、kimi-k2.6,接入方式为自定义 model provider(模型供应商);官方文档已放出两套教程,覆盖 Codex CLI、Codex 桌面客户端(官方文档写作 Codex / ChatGPT 桌面客户端)和 Claude Code。Responses API 这条通道目前支持文本和图片输入,暂不支持视频。
只换 base_url 和 API Key,其余代码不动
页面的协议兼容性表里并列三行:OpenAI Chat Completions 走 /v1/chat/completions,OpenAI Responses 走 /v1/responses,Anthropic Messages 走 /anthropic/v1/messages。页面给迁移场景的说明很简短:原本在使用 OpenAI 或 Anthropic 官方 API 的项目,只需把 base_url 和 API Key 替换为 Kimi 的配置即可迁移,无需修改其他代码。
两份新教程各对应一条线。开篇写明:Kimi 开放平台原生支持 Codex 使用的 Responses API,Codex 可以直接使用 kimi-k3 模型,无需协议转换或本地代理。把接入点定义为 Kimi 的 Anthropic 兼容端点(Messages API)。两家编程代理各自认的请求协议,Kimi 平台现在原样提供。
Codex 桌面端与 CLI 共用一份 config.toml
Codex 侧的改动集中在一个文件:在 ~/.codex/config.toml 里加一个模型供应商块。model 设为 kimi-k3,base_url 指向 https://api.moonshot.cn/v1,env_key 填 KIMI_API_KEY,wire_api 设为 responses,文档称这是 Codex 与 Kimi 直接通信的关键配置。model_context_window 需要显式写成 1,048,576,与 kimi-k3 的 1M 上下文窗口对齐;不配置时 Codex 会套用默认模型元数据,文档提醒可能影响表现。
底层请求发往 POST https://api.moonshot.cn/v1/responses。Codex 桌面端与 CLI 共用同一份用户级配置,改完后退出并重启桌面端,在模型选择器里选 kimi-k3,界面此时可能显示「自定义」,实际请求仍走配置的 kimi-k3。API Key 通过环境变量传入,文档要求不要写进 config.toml,输入时用不回显的方式,避免 Key 被记入命令历史。
FAQ 里有一条针对性的预告:启动时出现「Model metadata for kimi-k3 not found」警告属于预期现象,不影响使用,原因是 kimi-k3 还不在 Codex 内置的模型目录里。
少配一个档位,Claude Code 的对应场景会静默失败
Claude Code 的配置落在 ~/.claude/settings.json 的 env 字段。文档示例把 ANTHROPIC_BASE_URL 指向 https://api.moonshot.cn/anthropic,ANTHROPIC_AUTH_TOKEN 填 Kimi API Key,主对话模型 ANTHROPIC_MODEL 写成 kimi-k3[1m]。
麻烦在档位变量。Claude Code 内部按场景调用不同模型:主对话、后台摘要、子 Agent 分别读 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_FABLE_MODEL、CLAUDE_CODE_SUBAGENT_MODEL 等变量。示例配置把 HAIKU 档给了 kimi-k2.7-code,其余档位全部用 kimi-k3[1m]。文档警告,只配置部分变量会让对应场景静默失败,那些场景会拿 Kimi 端点无法识别的模型名去发请求。
settings.json 里的 env 会覆盖终端里的 export,残留的旧配置会干扰新设置,文档为此提供了一段清理脚本;文件里的 API Key 是明文,不要提交进 git 仓库。
验证分两步:先用 curl 请求 https://api.moonshot.cn/anthropic/v1/messages 确认端点与 Key 可用,再在 Claude Code 里输入 /status。教程配的验证截图里,Status 页的 Anthropic base URL 一栏显示 api.moonshot.cn/anthropic,Model 一栏显示 kimi-k3[1m]。
三款模型在 Claude Code 里的思考行为也不一样:kimi-k3 思考默认开启、可关闭;kimi-k2.6 思考可选,文档把它定位成适合对延迟敏感的简单任务;kimi-k2.7-code 思考强制开启且不可关闭,未开启 Thinking 时请求会被拒绝,返回 400「invalid thinking: only type=enabled is allowed for this model」。
四款模型可选,视频进不了 Codex 通道
四款可直连模型里,对 kimi-k3 的定位是面向长程编程与端到端知识工作的旗舰模型,1M token 上下文;kimi-k2.7-code 及高速版主打编程、多模态与思考模式,上下文 256K;kimi-k2.6 支持文本、图片与视频理解,上下文同为 256K。
视频是目前的边界。Responses API 支持文本和图片输入、暂不支持视频;Codex 教程把原因拆开讲:Codex CLI 没有原生视频输入通道,这是 Codex CLI 输入层的限制,不是 Kimi K3 模型的能力限制。Kimi K3 API 原生支持视频输入,按视觉输入直接调用 kimi-k3 即可完成视频理解,无需手动抽帧。想从 Codex 界面喂视频,暂时没有入口;想用 kimi-k3 理解视频,直接调 API 就能做。
先关旧路由,再写新配置
两份教程都默认读者从零开始,存量用户的问题被放进了 FAQ。Codex 教程两次点名本地路由工具 CC Switch:之前通过 CC Switch 等本地路由接入的用户,要先确认 base_url 不再指向 127.0.0.1 之类的本地地址,再到 CC Switch 的设置里关闭 Codex 路由,否则它会持续改写 config.toml,把新写好的直连配置覆盖回去。
8 月 31 日下线的老模型,官方让它们迁到 Kimi K3
平台显示,8 月 31 日 16:00,kimi-k2.5 与 moonshot-v1 全系列(含 -vision-preview)已在国内外全平台下线,调用返回 404,官方把迁移目标写作「请迁移至 Kimi K3」。两天后放出的 Codex 直连教程,标题就叫「在 Codex 中使用 Kimi K3」。