发布日期2026-07-22 | 话题AI 编程工具 / Kimi K3 / Codex 配置Kimi K3 是月之暗面Moonshot AI于 2026 年推出的新一代推理大模型拥有 1M tokens 超长上下文窗口完全兼容 OpenAI API 格式支持reasoning_effort参数low / high / max 三档默认 max控制推理深度Codex 是 OpenAI 推出的 AI 编程智能体支持通过~/.codex/config.toml接入任意 OpenAI 兼容的第三方模型——这意味着把 Kimi K3 接入 Codex 只需要几行配置完成后 CLI 终端界面和 macOS 桌面应用共享同一份配置两端均可通过模型选择器切换到 Kimi K3。本文从 API Key 获取到全局配置再到 CLI 动态切换/model命令和桌面端 UI 切换以及 Profile 隔离多模型方案完整覆盖两种接入路径帮助开发者在 5 分钟内完成配置并开始使用。为什么把 Kimi K3 接入 CodexCodex 默认绑定 OpenAI 的编码模型对于国内开发者来说有两个常见痛点访问延迟和费用。Kimi K3 作为完全兼容 OpenAI API 格式的国产推理模型天然可以作为 Codex 的底层模型替换方案。Kimi K3 的几个关键参数值得关注上下文窗口 1M tokens远超 Codex 默认模型处理大型代码仓库时不易截断reasoning_effort 三档可调低延迟场景用low深度推理用max适配不同编码任务国内直接访问api.moonshot.cn无需额外网络配置OpenAI SDK 完全兼容无需修改任何调用代码直接替换 base_url 即可Codex 支持通过model_providers配置块定义自定义 API 提供方之后无论是 CLI 还是桌面端都会读取同一份配置。第一步获取 Kimi API Key访问 Kimi API 开放平台登录后进入API Keys页面创建一个新的 Key平台地址见文末延伸阅读。创建完成后将 Key 设置为环境变量。建议写入 shell 配置文件以持久生效# 写入 ~/.zshrc 或 ~/.bashrcexportMOONSHOT_API_KEY你的 Kimi API Key# 立即生效source~/.zshrc验证环境变量是否已生效echo$MOONSHOT_API_KEY注意请勿将 API Key 直接硬编码到配置文件中始终通过环境变量传入。第二步配置 Codex 自定义 ProviderCodex 的用户配置文件位于~/.codex/config.toml。如果该文件不存在首次运行codex时会自动创建。打开配置文件添加以下内容# 默认使用 Kimi K3 model kimi-k3 model_provider kimi # 配置 Kimi 为自定义 Provider [model_providers.kimi] name Kimi K3 (Moonshot AI) base_url https://api.moonshot.cn/v1 env_key MOONSHOT_API_KEY保存后即可生效无需重启任何服务。备选方案直接覆盖内置 OpenAI Provider如果你不需要多模型切换只想把所有请求重定向到 Kimi可以用更简洁的openai_base_url方案model kimi-k3 openai_base_url https://api.moonshot.cn/v1然后将 Kimi API Key 赋值给OPENAI_API_KEYexportOPENAI_API_KEY你的 Kimi API Key这种方式配置最少但会覆盖内置 OpenAI Provider不便于同时维护多个 Provider。推荐第一种model_providers方案灵活性更高。第三步CLI 启动与动态切换配置完成后在终端启动 Codex 即可直接使用 Kimi K3codex在会话内动态切换模型——无需退出在 TUI 输入框内输入/model并回车会弹出模型选择器选择kimi-k3即可切换/model切换后可用/status确认当前模型/status单次运行覆盖模型——如果只想针对某次任务临时使用 Kimi K3不修改全局配置codex--modelkimi-k3--configmodel_providerkimi第四步桌面端接入桌面端有两种方式视你使用的客户端选其一。方式一config.toml 共享配置Codex macOS AppCodex 桌面应用和 CLI 共用同一份~/.codex/config.toml完成第二步的配置后桌面端无需任何额外操作。打开 App 后点击顶部或左下角的模型名称弹出模型选择器已配置的kimi-k3会出现在列表中点击切换即可。如果列表中没有看到kimi-k3检查以下三点配置文件语法错误在终端运行codex --strict-config确认配置无误环境变量未加载确认MOONSHOT_API_KEY已写入~/.zshrc重新打开终端后再用codex app命令启动桌面 AppApp 缓存未刷新完全退出后重新启动方式二cc switch 供应商面板零配置如果你使用的桌面端 AI 编程工具支持 cc switch 供应商管理功能接入 Kimi K3 可以完全不碰配置文件全程 GUI 操作。打开供应商管理面板通常在设置 → 模型 → 添加新供应商可以看到预置了大量国内外 AI 服务商其中包括Kimi和Kimi For Coding两个选项Kimi接入 Kimi K3 通用推理模型适合需要深度推理的代码分析、架构设计类任务Kimi For Coding接入 Kimi K2.7 Code 系列高速模型适合高频代码补全和快速生成操作步骤在供应商列表中找到Kimi或Kimi For Coding点击选中在弹出的配置框中填入你的 Kimi API KeyMOONSHOT_API_KEY点击右下角 添加供应商即刻生效返回聊天界面点击模型切换按钮从列表中选择刚添加的 Kimi 模型即可如果列表里没有预置 Kimi也可以点击左上角自定义配置手动填写API Base URLhttps://api.moonshot.cn/v1模型名称kimi-k3API Key你的 Moonshot API Key进阶Profile 隔离多模型如果你同时使用 OpenAI 原生模型和 Kimi K3推荐使用 Profile 方案——不修改全局配置单独维护一个 Kimi 配置层创建~/.codex/kimi.config.toml# ~/.codex/kimi.config.toml model kimi-k3 model_provider kimi model_context_window 1048576启动时加载 Kimi Profilecodex--profilekimi不加--profile时Codex 恢复默认配置OpenAI 原生模型。Profile 支持随时切换适合需要同时维护多个模型的场景。Kimi K3 专属参数说明在 Codex 中使用 Kimi K3 时有几个参数需要注意。reasoning_effort 推理力度Kimi K3 通过请求顶层的reasoning_effort参数控制推理深度接受low/high/max三档默认max。Codex 的model_reasoning_effort配置枚举是minimal | low | medium | high | xhigh两者有交集但不完全一致。建议如下不设置model_reasoning_effortKimi K3 默认使用max推理力度适合大多数编码任务。只在需要降低延迟时设置high或low这两个值 Codex 和 Kimi K3 都接受# 需要加速时使用日常编码、简单补全 model_reasoning_effort high # 极速轻量场景 model_reasoning_effort low注意Codex 的minimal、medium、xhigh这三档值不被 Kimi K3 识别传入会导致 API 报错。使用 Kimi K3 时仅填写low或high或直接留空以使用 Kimi K3 默认的max推理档位。temperature 固定不可修改Kimi K3 的temperature固定为1.0传入其他值会报错。Codex 本身不强制设置 temperature但如果你的项目配置或 AGENTS.md 里有 temperature 相关指令需要确认不会传递给 Kimi K3。上下文窗口Kimi K3 支持 1M tokens 上下文远超默认值。Codex 不会自动感知第三方 Provider 的上下文大小建议在 Profile 中手动声明以避免过早截断model_context_window 1048576代码高速模型的替换如果你的任务是纯代码生成不需要深度推理可以用kimi-k2.7-code-highspeed替代 K3输出速度更快model kimi-k2.7-code-highspeed model_provider kimi常见问题配置后 Codex 报 API 认证错误怎么办最常见的原因是环境变量未被桌面 App 读取到。在终端中先运行echo $MOONSHOT_API_KEY确认 Key 存在然后从同一个终端窗口启动 Codexcodex或codex app。如果是桌面 App 双击打开它可能从系统环境继承变量而非 shell 配置文件。解决方案在~/.zshrc中设置变量后重启终端再用codex app命令打开桌面 App。同一台机器上如何快速在 Kimi K3 和 OpenAI 原生模型之间切换两种方式一是使用 Profilecodex --profile kimivscodex二是在 TUI 会话内用/model斜杠命令临时切换。Profile 方式持久化到下次启动/model仅影响当前会话。Kimi K3 接入 Codex 后PR 审查和 issue 处理功能还能正常工作吗Codex 的工程功能PR 生成、issue 处理、代码重构依赖模型的工具调用Function Calling能力。Kimi K3 支持tool_choice auto/none/required兼容 Codex 的工具调用格式主要工程功能可以正常使用。但需注意Kimi K3 的reasoning_content字段在多轮对话中需要原样回传如果工具链对响应结构有严格解析偶尔可能出现兼容性问题。延伸阅读KimiK3 API 接入https://www.qiniu.com/ai/plan
