要在 Codex 中使用 Kimi K3，需要 Kimi 开放平台的 API Key、Codex 的自定义模型配置，以及一次能核对模型与工具调用的试运行。网页端 Kimi 会员和开放平台 API 是不同产品，会员订阅不能直接代替 API Key。以下步骤依据 2026 年 10 月 1 日的Kimi 官方 Codex 接入文档整理，未使用你的账号实际调用。
先准备两个条件
- 按Codex 官方安装说明安装并至少启动一次 Codex；桌面版也可以使用同一份用户配置。
- 登录Kimi 开放平台密钥页面创建 API Key。确认它属于
platform.kimi.ai，因为不同区域平台的 Key 与接口地址不能混用。 - 核对账号余额和
kimi-k3权限。K3 官方说明指出该模型需要成功充值后解锁；仅创建 Key 不代表一定可调用。
请不要把 Key 写进项目、聊天记录或 config.toml。在 Windows PowerShell 中，可用以下方式隐藏输入并只设置当前终端会话的变量。关闭终端后需重新设置；桌面程序必须从能读取该变量的环境启动，设置后重启程序。
$secureKey = Read-Host "输入 Kimi API Key" -AsSecureString
$env:KIMI_API_KEY = [System.Net.NetworkCredential]::new('', $secureKey).Password配置模型提供方
打开 %USERPROFILE%\.codex\config.toml（macOS/Linux 为 ~/.codex/config.toml）。保留原文件备份，并将已有顶层 model、model_provider 与下面配置合并，避免出现重复键：
model = "kimi-k3"
model_provider = "kimi"
model_context_window = 1048576
[model_providers.kimi]
name = "Kimi"
base_url = "https://api.moonshot.ai/v1"
env_key = "KIMI_API_KEY"
wire_api = "responses"wire_api = "responses" 指定 Codex 使用 Kimi 原生支持的 Responses API；base_url 必须保留 /v1。官方文档写明该请求实际发往 POST https://api.moonshot.ai/v1/responses，接口细节可对照Responses API 参考。
验证首次调用
- 完全退出再启动 Codex 桌面版，或重新打开 Codex CLI。模型选择器中确认
kimi-k3；桌面界面可能显示“Custom”，此时以配置和后续请求结果为准。 - 先发送
hi。正常返回只能证明基本连通。 - 再在一个可读取的测试项目中发送“读取此项目的目录结构，并概述主要模块”。确认 Codex 调用工具后仍能给出最终回答。这一步才覆盖了智能体工具回合。
- 在 Kimi 平台查看用量，核对这次调用是否产生对应记录。只看到聊天框有答案，不足以证明请求发往预期账号。
连不上时按状态码排查
- 401：检查变量是否在启动 Codex 的进程里可见、Key 是否来自
platform.kimi.ai，以及接口是否为api.moonshot.ai/v1。 - 404 /v1/responses：优先检查
base_url是否缺少/v1，或是否还经过旧代理。 - 没有工具结果：先确认基本问答已通，再执行仓库读取任务；不要把只回复
hi视为工具调用验证。
上述排查依据官方接入文档的故障章节。配置值、模型可用性和界面会变化；若页面与本文不同，以当前平台文档和账号权限为准。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/31032.html
