三种方式把 Kimi K3 接入你的 AI 编程工作流：从 /model 到 config.toml 完整配置

Kimi K3 是月之暗面（Moonshot AI）于 2026 年 7 月 17 日发布的新一代旗舰大模型，参数规模达 2.8 万亿，是目前全球规模最大的开源模型，在多项权威基准测试中宣称超越同期美国顶尖系统，编程、长程推理和多模态任务是其核心能力，运行成本约为同级竞品的三分之一。Kimi Code（KFC）是月之暗面专为开发者打造的 AI 编程工具套件，包含 CLI 终端代理和 VS Code 插件，K3 上线后已可在 Kimi Code 中直接调用。本文完整梳理三种接入方式：官方 CLI 内一条命令切换模型、编辑 config.toml 将 K3 设为默认模型、以及通过 Kimi Platform API Key 将 K3 接入第三方工具（Claude Code、Codex 等），并附上会员要求、思考强度配置和常见踩坑排查。

Kimi K3 与 Kimi Code：两件事先搞清楚

Kimi K3 是底层大模型，模型 ID 为 k3，最高支持 1M token 上下文（需 Allegretto 及以上会员），支持 low / high / max 三档思考强度。关闭 thinking 后请求会自动降级路由到 K2.6，因此在 Kimi Code 中使用 K3 时建议保持思考模式开启。

Kimi Code CLI 是调用入口，包名 @moonshot-ai/kimi-code，配置文件在 ~/.kimi-code/config.toml。K3 需要 Moderato 及以上会员才能调用，低于此级别会返回 HTTP 401。

方式一：CLI 内用 /model 命令切换（最快）

适用场景：已登录 Kimi Code，临时在某次会话切换到 K3，不需要永久修改配置。

进入任意项目目录，启动 Kimi Code CLI：

kimi

进入交互界面后输入：

/model

从弹出的模型列表中选择 K3。如果列表中未出现 K3（可能因为 CLI 版本较旧或缓存未刷新），依次执行：

/logout
/login

重新授权后 K3 即出现在列表中。

注意：/model 切换仅对当前会话生效，重新启动 CLI 后恢复 config.toml 里的 default_model 设置。

方式二：config.toml 设为默认模型（推荐）

适用场景：想让每次启动 Kimi Code CLI 都默认使用 K3，无需每次手动切换。

编辑 ~/.kimi-code/config.toml，加入或修改以下字段：

# 设置 K3 为默认模型
default_model = "kimi-code/k3"

# 托管供应商配置（/login 后自动写入，通常无需手动填写）
[providers."managed:kimi-code"]
type = "kimi"
base_url = "https://api.kimi.com/coding/v1"
api_key = ""

# K3 模型定义
[models."kimi-code/k3"]
provider = "managed:kimi-code"
model = "k3"
max_context_size = 1048576
capabilities = ["thinking", "always_thinking", "image_in", "tool_use"]
display_name = "K3"
support_efforts = ["max"]
default_effort = "max"

# 思考强度设置
[thinking]
enabled = true
effort = "high" # 可选 low / high / max
keep = "all"

关键字段说明：

• default_model：必须和 [models.<alias>] 中的别名完全一致（区分大小写）
• max_context_size：不是 context_window，字段名拼错会导致配置无效，单位是 token，填 1048576 等于 1M
• model：发送给 API 的实际模型 ID，必须填 "k3"，不要填显示名称
• default_effort：K3 思考强度默认，建议 "high"（"max" 更准确但消耗更高）
• thinking.keep = "all"：在多轮对话中保留历史轮次的思考内容，对复杂工程任务有帮助

修改完成后，在 CLI 内执行 /reload 让配置生效，无需退出重启。

方式三：Kimi Platform API Key 接入第三方工具

适用场景：不使用 Kimi Code CLI，而是通过 Claude Code、Codex、Cursor、CC Switch 等其他工具调用 Kimi K3。

获取 API Key

接入配置

Kimi K3 API 支持 OpenAI 兼容协议，任何支持自定义 base_url 的工具均可接入：

在 Kimi Code CLI 中使用 Kimi Platform API Key

如果你不想用 OAuth 登录，可以直接在 config.toml 中配置 Platform API Key：

default_model = "kimi-platform/k3"

[providers.kimi-platform]
type = "kimi"
base_url = "https://api.moonshot.ai/v1"
api_key = "sk-你的密钥"

[models."kimi-platform/k3"]
provider = "kimi-platform"
model = "kimi-k3"
max_context_size = 1048576
capabilities = ["thinking", "image_in", "tool_use"]
display_name = "K3 (Platform)"

在 CC Switch 中一键接入

CC Switch支持统一管理 Claude Code、Codex、Gemini CLI 等工具的推理后端，添加 Kimi K3 供应商只需在 CC Switch 的供应商管理界面填入上表中的 Base URL、Model ID 和 API Key，一次配置同步到所有已启用的 AI 编程工具。

K3 vs K2.7 Code：什么时候该切换？

建议策略：

• 大型项目、跨文件分析、需要思考链时 → K3
• 需要快速响应、简单任务、会员档位不支持 K3 时 → K2.7 Code（-highspeed 版延迟更低）
• 同一会话内避免在 K3 和其他模型之间反复切换，否则会使上下文缓存失效，导致 token 消耗增加

思考强度选择指南

K3 的 effort 参数直接影响推理深度和 token 消耗：

切换 effort 会使上下文缓存失效，同一任务建议全程保持同一档位。

在 config.toml 中设置全局默认值：

[thinking]
enabled = true
effort = "high"

在 CLI 内临时切换（仅当前会话生效）：

/model k3 –effort max

常见问题排查

Q：配置了 default_model = "kimi-code/k3" 但 CLI 仍使用旧模型

A：配置文件修改后需要在 CLI 内执行 /reload 让配置生效，或退出后重新运行 kimi。确认别名拼写和 [models."kimi-code/k3"] 中的别名完全一致。

Q：调用 K3 返回 HTTP 401

A：当前账号的会员档位低于 Moderato，K3 不可用。在 Kimi Code CLI 内执行 /usage 查看当前套餐，Andante（基础版）需升级才能使用 K3。

Q：已是 Moderato 会员，但 1M 上下文不生效

A：1M 上下文需要 Allegretto 及以上会员，Moderato 上限是 256k。此外还需确认 max_context_size 字段已正确设置为 1048576，字段名拼写错误不会报错但也不会生效。

Q：K3 关闭 thinking 后速度变慢反而更慢

A：关闭 thinking（effort = "none" 或 enabled = false）后，请求会路由到 K2.6 而非 K3 lite 版本，K2.6 在某些场景下不如 K2.7 Code 高速版快。建议关闭 thinking 时直接切换到 kimi-for-coding-highspeed 模型，而非依赖 K3 的 thinking-off 降级。

Q：max_context_size 和 context_window 哪个是正确字段名？

A：正确字段名是 max_context_size，单位为 token，整数类型，必须 ≥ 1。context_window 不是合法字段，写错后配置文件不会报错，但字段会被静默忽略，实际使用的上下文大小取决于供应商默认值。

Q：在 Kimi Code 之外的工具（如 Codex、Claude Code）如何使用 K3？

A：通过 Kimi Platform API Key（platform.kimi.ai）以 OpenAI 兼容协议接入，Base URL 填 https://api.moonshot.ai/v1，Model ID 填 kimi-k3。无论哪款编程工具，只要支持自定义 base_url 和 api_key 就能调用。对于需要统一管理多工具后端的开发者，七牛云 AI 平台提供了多模型统一接入方案，支持在同一套 API Key 体系下灵活切换各家主流大模型，适合同时使用多款编程工具的团队。详见 七牛云 AI 模型广场。

小结

Kimi K3 接入 Kimi Code 有三条路：CLI 内 /model 临时切换（不改配置文件，适合偶尔用）、config.toml 设置为默认模型（一次配置永久生效）、Kimi Platform API Key 接入第三方工具（不限于 Kimi Code 生态）。核心坑点只有两个：字段名必须用 max_context_size 而非 context_window，会员档位低于 Moderato 时 K3 直接返回 401。其余按本文配置示例操作即可。

参考资料

• 七牛云 AI 模型广场含KimiK3模型

数据截止：2026 年 7 月 20 日。Kimi K3 于 2026 年 7 月 17 日正式发布，会员要求与 API 规格以官方文档为准。