三种方式把 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。

会员档位	K3 可用性	最大上下文
Andante（基础）	❌ 不可用	—
Moderato	✅ 可用	256k
Allegretto 及以上	✅ 可用	1M（需手动配置 1048576）

---

方式一：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

1. 前往kimi控制台或七牛云AI大模型广场
2. 创建 API Key（每个账号最多 5 个）
3. 仅在创建时显示一次，请立即复制保存

接入配置

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

参数	值
Base URL	https://api.moonshot.ai/v1
Model ID	kimi-k3
API Key	你在控制台创建的密钥

在 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	K2.7 Code
模型 ID	k3	kimi-for-coding
上下文	最高 1M token	256k
思考强度	low / high / max 三档	思考开/关
速度	常规	标准版常规；高速版约 5–6 倍（kimi-for-coding-highspeed）
最低会员要求	Moderato	所有会员
适合场景	复杂架构分析、大型代码库重构、长程推理任务	日常代码补全、快速 debug、对延迟敏感的场景

建议策略：

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

---

思考强度选择指南

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

effort	适合场景	特点
low	简单问题、代码格式化、文档生成	速度最快，消耗最低
high	日常编程任务、代码审查、中等复杂度的 bug 修复	均衡默认推荐
max	算法设计、系统架构分析、需要多步推理的复杂问题	最准确，消耗最高

切换 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 规格以官方文档为准。