很多 Codex 第三方模型教程,最后都被压缩成一句话。
填 Key,改 Base URL,重启。
看起来只有三步,真做起来却很容易卡住。因为这里至少有四个对象。Key 负责认证,Endpoint 决定请求走向,Provider 决定通信协议,Model ID 决定平台最终调用哪个模型。它们长得都像一串配置,但压根不是一回事。
AI Code With 已经提供了 Kimi 模型接入 Codex 的明确教程,因此这里属于已确认的接入场景。它能提供模型入口、Key 与调用记录,但 Codex 的执行能力仍然来自 Codex,Kimi 的模型能力也仍然属于 Kimi。别把三层东西揉成一个产品故事。
先把四个字段对上
Codex 场景使用的专用 Endpoint 是:
https://api.aicodewith.ai/chatgpt/v1
Provider 需要按 Responses 协议配置。AI Code With 文档中的示例使用 wire_api = "responses"。Model 则必须填写当前实际有效的 Model ID,不能只凭后台卡片上的展示名猜。
一个安全的配置骨架可以写成这样:
model = "<CURRENT_KIMI_MODEL_ID>"model_provider = "aicodewith-codex"[model_providers.aicodewith-codex]base_url = "https://api.aicodewith.ai/chatgpt/v1"wire_api = "responses"requires_openai_auth = true
这里故意没有写死 Kimi 的 Model ID。产品事实库确认后台目前展示 Kimi K2.6、Kimi K3 与 Kimi K2.7 Code,但展示名、教程 ID 与真实调用 ID可能变化。发布教程时,应该从当前模型页或接入文档复制,而不是拿旧文章里的字符串下注。
配置顺序别反过来
先在 AI Code With 创建或选择 API Key,检查它是否限制了模型、渠道或额度。然后备份 Codex 当前配置,只新增一个 Provider 和一个模型。不要一上来删掉原来的官方登录路线,更不要把完整 Key 直接写进仓库。
保存之后,先运行一个没有副作用的小任务。例如让 Codex解释一个只读文件,不要直接上来重构整个项目。
成功标准也别只看终端有没有红字。至少要同时满足三件事。
- Codex 正常返回结果。
- AI Code With Usage Records 出现同一时间的请求。
- 记录里的 Key、模型与费用符合这次测试。
报错时按层排,不要乱换 Key
401 先查 Key 是否有效、是否被停用、是否被环境读取。404 先查 Endpoint 与协议,不要看到 404 就认定模型下线。model not found 再核对 Model ID 与 Key 的模型限制。
如果 Codex 有输出,但 Usage Records 没有对应记录,说明请求可能根本没走这条 Provider。此时继续换 Kimi 型号没意义,应该回头看配置是否生效。
说到底,接 Kimi K3 并不难。难的是别把四个字段当成同一件事。
把 Key、Endpoint、Provider、Model 一层层对齐,再用一条真实记录验收。配置这件事,终于就从玄学变成了工程。
