- 适用对象
- 想快速了解工具定位、核心功能和上手路径的中文用户
- 核对日期
- 2026-11-07
本页目录
本指南综合了 10 篇公众号文章(2026-04-17 ~ 11-03),文中 [1]~[10] 对应文末「参考原文」。每张图下方注明出处。素材之间说法不一致、或已经过时的地方,用 ⚠️ 标出。
Kimi Code 这一年改动很大:命令行从 Python 版换成了 Node.js 版,模型从 K2.5/K2.6 一路换到 K3.1 Pro,会员档位也从 Andante/Moderato 改成了 Go/Plus/Pro。4~7 月的教程有不少已经过时。安装、会员与 API、接入其他工具这几部分以 Kimi Code 官方文档为准,标 [官1]~[官28],查阅日期 2026-11-07。
一、定位:它是什么,适合谁
Kimi Code 是月之暗面(Moonshot AI)出的编程 Agent,2026 年 1 月 27 日正式发布 [3]。它不只是补全代码:你用大白话说要做什么,它会自己读代码、改文件、跑命令,出错了看日志接着修 [3][5]。官方把它定义为「Kimi 会员权益中面向开发者的编程服务」,订阅用户还能拿到 API Key,把 Kimi 的模型接到别的编程工具里用 [官1]。
一个产品,四种用法
| 入口 | 是什么 | 适合谁 |
|---|---|---|
| 桌面端 Kimi Code Desktop | 图形界面,自带改动面板、终端、内置浏览器。9 月 17 日正式发布,macOS / Windows / Linux 都有 [官28][6] | 不想碰终端的新手;做网页要边改边看效果的人 |
| 命令行 Kimi Code CLI | 在终端里输入 kimi 启动。功能最全,能写脚本、进 CI、远程控制 [官2] | 程序员;服务器和远程环境 |
| VS Code 扩展 | 编辑器侧边栏里的聊天面板,改动用 VS Code 自己的 diff 视图审 [官15] | 主要在 VS Code 里写代码的人 |
| API Key(接入第三方工具) | 在 Kimi Code 控制台建 Key,填到 Claude Code、OpenCode、Codex、Hermes 等工具里 [官5] | 已经习惯别的 Agent,只想换成 Kimi 模型的人 |
JetBrains(IDEA、PyCharm 等)、Zed 这类编辑器,通过命令行版的 ACP 协议接入,见第二节第 6 小节 [官14]。
适合谁
国内开发者:国内网络直接能用,不用折腾账号和网络环境 [1][2]。素材 [2] 的作者觉得入门价大约是 GPT、Claude 的三分之一。
不写代码的人:素材 [2] 的作者在 VS Code 里跑通了一个「读 PDF 计划书、出一页纸方案」的项目;素材 [9] 用它读本地素材、拆旧 PPT,生成了一份 16 页的
.pptx。接手老项目、做重复开发的人:让它先读目录、画调用链,再补测试、补文档、批量改字段 [1][5]。
做 3D 和游戏的人:11 月起官方推了「游戏开发与创意工作解决方案」,Kimi Code 可以改 Godot、Unity、Blender 工程(见第四节第 11 小节)[10]。
不太适合谁
完全不想付费的人:没订阅 Kimi 会员的账号用不了官方模型,最便宜的 Go 档也不含 Kimi Code [官4][官17]。命令行版可以接别家模型,但那样就要付别家的钱。
生产环境想全自动跑的团队:权限模式开到「完全自动」时,它不会再问你,连
rm -rf这类危险命令也不拦(第五节)[官12]。
和同类工具怎么比(2026-11 的情况,以各家官方信息为准)
| Kimi Code | Claude Code | Codex | GitHub Copilot | |
|---|---|---|---|---|
| 出品方 | 月之暗面 | Anthropic | OpenAI | GitHub / 微软 |
| 默认模型 | K3.1 Pro 等 Kimi 模型 [官5] | Claude 系列 | GPT 系列 | 多家可选 |
| 入口 | 桌面端、CLI、VS Code、ACP 接 JetBrains/Zed [官1] | 桌面端、CLI、IDE 插件、网页 | 桌面端、CLI、IDE 插件、网页 | IDE 为主,另有 CLI |
| 国内直接用 | 能 | 官方服务不能,可接国内模型 | 官方服务不能,可接国内模型 | 需要 GitHub 账号 |
| 收费 | Kimi 会员 Plus 99 元/月起 [官6] | 订阅或按 token | 订阅或按 token | 有免费档,订阅制 |
| 接别家模型 | CLI 和桌面端都能接(Anthropic、OpenAI、Gemini 等)[官7][官17] | 能(Anthropic 兼容接口) | 能 | 有限 |
| 特色 | 视频输入、Swarm 多 Agent、Tower 编排、远程控制、内置浏览器 [官12][官13][6] | 生态最成熟 | — | 和 GitHub 深度结合 |
⚠️ 素材 [3](4 月)的对比表写「Claude Code 用 Claude 3.5/4」「Cursor 不能在终端运行」「Copilot 不支持多模态」,素材 [5](7 月)写「Claude Code 只能用 Anthropic 的模型」,这些都是旧情况或不准确,本表没有采用。素材 [5] 说「K3 的编程能力已经追平 GPT-5.6 Sol」是作者的判断,未核实。
二、准备与安装
0. 先选路线:你属于哪种情况
| 你的情况 | 推荐路线 | 看哪几步 |
|---|---|---|
| 不写代码,想用图形界面 | 开会员 → 桌面端 | 第 1、2 步 → 第三节 |
| 主要用 VS Code | 开会员 → VS Code 扩展 | 第 1、4 步 → 第三节 |
| 程序员,习惯终端 | 开会员 → 命令行 CLI | 第 1、3 步 |
| 用 JetBrains、Zed | 先装 CLI 登录好,再配 ACP | 第 1、3、6 步 |
| 已经在用 Claude Code / Codex / OpenCode,只想换成 Kimi 模型 | 开会员 → 控制台建 API Key → 配到原工具里 | 第 1、5 步 → 第四节第 9 小节 |
| 不想开会员,按量付费 | Kimi 开放平台 API Key → CLI 里 /login 选 Kimi Platform | 第 3 步 → 第四节第 8 小节 |
| 想在 Kimi Code 里用 DeepSeek、Claude、GPT、Gemini | CLI 或桌面端里添加第三方供应商 | 第 3 步 → 第四节第 8 小节 |
| 以前装过 Python 版 kimi-cli | 装新版,运行 kimi migrate 迁移 | 第 3 步第七条 |
1. 账号与费用
先弄清两个概念:会员和开放平台是两套系统 [官26][官27]
| Kimi Code(会员) | Kimi 开放平台 | |
|---|---|---|
| 怎么付费 | Kimi 会员订阅,含额度 | 按量付费 |
| 在官方客户端里怎么用 | 用 Kimi 账号登录(OAuth) | CLI 里 /login 选「Kimi Platform API Key」[官2] |
| 给第三方工具用的 Key | 在 Kimi Code 控制台(kimi.com/code/console)创建 | 在开放平台官网(platform.kimi.com / platform.kimi.ai)创建 |
| 接口地址 | Anthropic 兼容:国内 https://api.kimi.com/coding/,海外 https://api.kimi.ai/coding/;OpenAI 兼容:后面加 v1 | 国内 https://api.moonshot.cn/v1,海外 https://api.moonshot.ai/v1 |
两边的 Key 和地址不能混用,混用最常见的结果是 401 Invalid Authentication [官27]。素材 [1] 也提醒:/login 时「会员和 API Key 是两条路,别混着填。新手最容易卡在这里」。
会员价格(官方帮助中心,价格截图日期 2026-10-19)[官6]
| 档位 | 月付 | 年付(折合每月) | 含 Kimi Code | 说明 |
|---|---|---|---|---|
| Go | 49 元 | 468 元(39 元) | 不含 | 文档、PPT、深度研究、建站 |
| Plus | 99 元 | 948 元(79 元) | 含 | Kimi Code、Agent 集群 |
| Pro | 199 元 | 1908 元(159 元) | 含 | 加目标模式、专属 Kimi Claw、更多额度 |
| Max | 699 元 | 6708 元(559 元) | 含 | 更多额度、更多并行任务 |
| Ultra | 1399 元 | 13428 元(1119 元) | 含 | 额度是 Max 的 2 倍 |
不同档位能用哪些模型(新套餐 / 老套餐)[官4][官5]
| 模型 | 模型 ID | 需要的档位 | 上下文 |
|---|---|---|---|
| K3.1 Pro | k3.1-pro | Plus / Moderato 及以上 | Plus 256K;Pro / Allegretto 及以上 1M |
| K3.1 Pro Highspeed | k3.1-pro-highspeed | Pro / Allegretto 及以上 | 1M,速度约 2~3 倍,消耗约 2 倍 |
| K3 | k3 | Plus 及以上 | 同 K3.1 Pro |
| K3 256K | k3-256k | Plus 及以上 | 256K,只能看图不能看视频 |
| K2.8 Preview | kimi-for-coding | 老套餐 Andante 也能用 | 1M |
| K2.7 Code Highspeed | kimi-for-coding-highspeed | Pro / Allegretto 及以上 | 256K,速度约 6 倍,消耗约 3 倍 |
额度怎么算 [官4][官6]
所有会员功能共用一个月度额度池,每月重置,用不完不结转。月额度用完,Kimi Code 也会被冻结。
Kimi Code 另有滚动 5 小时限额。新套餐(Go/Plus/Pro…)没有周限额;老套餐(Andante、Moderato、Allegretto、Allegro)还保留 7 天周限额。
所有登录的设备和所有 API Key 共用同一个额度池。
额度用完可以买「加油包」(Extra Usage):按实际用量扣人民币,价格接近开放平台 API;单笔至少 25 元,余额不过期,一般不退;可以设每月上限。企业版不支持。
查用量:CLI 里输入
/usage,或在控制台查看 [官4]。超过 30 天不活跃的设备会自动解绑,重新
/login即可 [官4]。老套餐买的会员到期前继续有效;升级按剩余天数折算,立即生效 [官4]。
⚠️ 「免费」「无限次」的说法都不对。 素材 [3](4 月)说「会员支持无限次使用 Kimi Code」,素材 [5](7 月)标题写「免费 AI 编程 Agent,0 成本上手」、正文说 OAuth 登录「有免费额度」。按 2026-11 的官方文档:未订阅会员的账号用不了官方模型,Go 档没有编程额度,会员也有 5 小时和月度限额 [官4][官17]。命令行程序本身开源,但模型要付费。素材 [10] 引用的 10-19 价格和本表一致。
2. 桌面端 Kimi Code Desktop(最简单)[官17][官18]
系统要求:macOS 13.0 及以上(Apple 芯片和 Intel 都支持,macOS 12 不再更新);Windows 10 及以上 64 位;Linux x86_64。
在官方文档「Kimi Code Desktop → 快速开始」页面下载安装包。
macOS:分 Apple Silicon 和 Intel 两个包。不知道自己是哪种,点苹果菜单「关于本机」看芯片。下载
.dmg,把 Kimi Code 拖进「应用程序」。Windows:运行
.exe,按向导装。Linux:AppImage 通用;Debian/Ubuntu 用
.deb;Fedora/RHEL 用.rpm。已经装了 CLI 的,也可以在终端输入
kimi install-desktop或会话里输/desktop,直接打开下载页 [官28]。
第一次启动选界面语言和主题。
按提示完成 Kimi 账号授权(也可以先跳过,之后点左下角账号区域登录)。中国大陆登录 kimi.com,其他地区登录 kimi.ai。
新建会话 → 点输入框上方的文件夹名 → 选你的项目文件夹。空会话不选工作区是发不了消息的。
打开没信任过的文件夹时会问是否信任;选不信任就不能发消息 [官28]。
已装 CLI 的,可以在终端用 kimi app 在当前目录开桌面端新会话,kimi app /path/to/project 打开指定目录 [官17]。
素材 [10] 提到的「Mac 要 Apple 芯片、macOS 12 以上」是 Kimi Work(Kimi 电脑客户端的 Work 模式)的要求,不是 Kimi Code 桌面端。两个是不同产品,别搞混。
3. 命令行 CLI 完整安装
系统要求 [官2]
用官方脚本安装:不需要预装 Node.js。
用 npm / pnpm 安装:需要 Node.js 22.19.0 或更高。
Windows:首次启动前先装 Git for Windows,CLI 用它自带的 Git Bash 当 shell [官2][4]。
推荐用支持真彩色的现代终端,比如 Kitty、Ghostty [官2]。
第一步:打开终端
macOS:「终端」或 iTerm2。
Windows:开始菜单搜「PowerShell」。行首显示
PS C:\的才是 PowerShell。Linux / WSL:系统终端。
第二步:运行安装命令(选一种)
| 系统 / 方式 | 命令 |
|---|---|
| macOS / Linux(官方推荐) | curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash |
| Windows PowerShell(官方推荐) | irm https://code.kimi.com/kimi-code/install.ps1 | iex |
| npm(需 Node.js 22.19.0+) | npm install -g @moonshot-ai/kimi-code |
| pnpm(需 Node.js 22.19.0+) | pnpm add -g @moonshot-ai/kimi-code |
来源:官方「开始使用」[官2];脚本和 npm 命令素材 [1][4][7][10] 里也有,写法一致。
WSL 2 里装:打开 WSL 终端,用 macOS / Linux 那条命令。素材 [3] 提到 Windows 用 WSL2 可以减少 PATH 和权限问题,这是作者经验。
Homebrew、WinGet 安装官方页面没写,未核实有没有。
Windows 额外注意
Git Bash 不在默认位置的,设置环境变量
KIMISHELLPATH,值填bash.exe的完整路径 [官2][4]。例如在 PowerShell 里:setx KIMISHELLPATH "D:\Git\bin\bash.exe",然后重开终端。运行脚本时提示「禁止运行脚本」或一闪而过,可以把 PowerShell 执行策略改成
RemoteSigned:Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser[3]。这一步会改变系统的脚本执行策略,自己确认后再做。
第三步:检查有没有装好
关掉终端,重新打开一个。
运行
kimi --version,能打印版本号就行 [官2]。用 npm 装的,再看一下node --version是不是 22.19.0 以上。提示找不到命令,说明安装目录不在 PATH 里。素材 [3] 给的修法(
~/.local/bin加进 PATH)针对的是旧 Python 版,新版脚本装在哪官方没写明,未核实。可以先用which kimi(macOS/Linux)或Get-Command kimi(Windows)看看系统找不找得到。配置改坏了、启动报错,运行
kimi doctor检查config.toml和tui.toml写得对不对,它不会改文件 [4]。
第四步:第一次启动和登录
cd your-project
kimi图源:[7] 小白部署不输《Kimi Code Cli效果惊艳到了我,分享一些使用的指南和小技巧》
第一次启动时模型显示 not set,按提示二选一 [7][官2]:
/login(会员或开放平台):会弹出平台选择 [官2][4]:Kimi Code(OAuth):设备码流程。终端给出一个链接和验证码,在任意设备(电脑、手机都行)打开链接、登录 Kimi 账号、输入验证码,就授权好了。
Kimi Platform API Key:粘贴从 platform.kimi.com 或 platform.kimi.ai 拿到的开放平台 Key,按量计费。
/provider(别家模型):添加 Anthropic、OpenAI、DeepSeek 等第三方供应商,不需要/login(第四节第 8 小节)[4][官7]。
不想进界面登录,也可以直接在终端运行 kimi login,走同样的设备码流程 [官11]。海外账号用 kimi login --region global [官19]。退出登录:会话里输 /logout [官2]。
第五步:先确认一下状态
/status:看版本、当前模型、工作目录、权限模式 [4]。/usage:看 token 用量、上下文占用和剩余额度 [4][官4]。/help:看全部命令和快捷键 [4]。
第六步:更新和卸载
更新:运行
kimi upgrade(别名kimi update),选「Install update now」,它会按你的安装方式升级 [官2][4]。npm 装的也可以npm install -g @moonshot-ai/kimi-code@latest。自动更新:默认开着,开关在
~/.kimi-code/tui.toml的[upgrade] auto_install,也可以在会话里/settings关掉 [官10]。Windows 单文件版从 0.37 起也能自动更新 [官28]。卸载:npm 装的运行
npm uninstall -g @moonshot-ai/kimi-code;脚本装的删掉kimi可执行文件 [官2]。官方没写脚本装到了哪,用which kimi或Get-Command kimi查到再删(官方 IDE 文档示例里的路径是~/.local/bin/kimi[官14])。连配置一起清掉:删除数据目录
~/.kimi-code/(Windows 是C:\Users\你的用户名\.kimi-code)。里面有配置、会话记录、登录凭据和日志,删之前想清楚 [官10]。
第七步:以前装过 Python 版 kimi-cli 的,迁移到新版 [官3]
按上面装好新版。
第一次运行
kimi时,它会自动发现~/.kimi/下的旧数据并提示迁移;也可以随时手动运行kimi migrate。选 Config only(只迁配置)或 Config + N sessions(连会话一起迁)。
迁移内容:
config.toml、MCP 配置、输入历史、选中的会话。不迁:登录凭据、MCP 授权、旧插件。迁完要重新/login,重新授权 MCP。旧数据不会被改动或删除,旧版照样能用。迁过来的会话带
[imported]标记。
⚠️ 别再用 Python / uv 的安装方法。 素材 [3](4 月)写的是
curl -LsSf https://code.kimi.com/install.sh | bash和uv tool install --python 3.13 kimi-cli,系统要求写 Python 3.12~3.14;素材 [5](7 月)甚至推荐新手用 Python 版。官方已经把 CLI 从 Python/uv 换成了 Node.js 版,旧版「将逐渐停止维护」[官3]。素材 [1] 也提醒「别再拿旧教程硬套」。现在的安装地址多了一层/kimi-code/,以上表为准。
4. VS Code 扩展 [2][官15]
要求:VS Code 1.100.0 或更高(扩展市场页面写的)[2];有 Kimi 会员订阅,或者已经配好 API Key [官15]。
去 code.visualstudio.com 下载安装 VS Code,一路下一步 [2]。
File → Open Folder 打开项目文件夹。要选「下一层就是项目文件」的那个文件夹,别选外面套了好几层的,不然 AI 看到的项目不对 [2]。
图源:[2] 元气万事屋Y《不会写代码:第一次用 Kimi Code 跑通一个项目》
VS Code 自带的 AI 聊天窗口(Agent Chat)弹出来的话,先关掉,避免两个 AI 打架 [2]。
按
Ctrl+Shift+X(macOS 是Cmd+Shift+X)打开扩展市场,搜 Kimi Code,认准发布者 moonshot-ai、说明是「Official Kimi Code plugin for VS Code」的那个。市场里有很多名字相近的第三方插件 [2][3]。
图源:[2] 元气万事屋Y《不会写代码:第一次用 Kimi Code 跑通一个项目》
装完重启 VS Code。不显示的话,命令面板(
Ctrl+Shift+P/Cmd+Shift+P)里执行 Developer: Reload Window [官15]。点左侧活动栏里的 Kimi 图标,选登录方式 [2][官15]:
Sign in with Kimi Account:浏览器打开授权页,登录后回到 VS Code。
Skip:已经配好 API Key 的(比如 CLI 里配过供应商),跳过登录,用 API Key 模式。
图源:[2] 元气万事屋Y《不会写代码:第一次用 Kimi Code 跑通一个项目》
登录成功后面板就绪,底部能看到当前模型 [2]。
图源:[2] 元气万事屋Y《不会写代码:第一次用 Kimi Code 跑通一个项目》
扩展和 CLI 的关系:扩展里内置了 Kimi Code 的运行程序。如果它和 CLI 用的是同一个 KIMICODEHOME,两边共享 config.toml、MCP 配置、登录状态和会话(扩展市场说明,见图 02)[2]。也可以在设置里用 kimi.executablePath 指定自己装的 CLI [官16]。不要在两边同时打开同一个会话,跨进程锁不保证可靠 [2]。
常用设置(VS Code 设置里搜「Kimi」)[官16]
| 设置项 | 默认 | 作用 |
|---|---|---|
kimi.yoloMode | false | 自动批准所有工具调用 |
kimi.autosave | true | Kimi 读写文件前自动保存 |
kimi.editorContext | never | 什么时候把当前文件和光标位置告诉 Kimi:never / onConversationStart / onFileChange |
kimi.useCtrlEnterToSend | false | 改成 Ctrl/Cmd+Enter 发送 |
kimi.alwaysExpandThinking | false | 默认展开思考过程 |
kimi.executablePath | 空 | 自定义 CLI 路径,空就用内置的 |
kimi.environmentVariables | {} | 传给 CLI 的环境变量 |
快捷键 [官15]:Ctrl+Shift+K / Cmd+Shift+K 聚焦 Kimi 输入框;Alt+K 插入当前文件引用;↑ / ↓ 翻输入历史。
⚠️ 素材 [3] 写的 VS Code 配置
"kimi-code.serverPath"、"kimi-code.enableACP": true,以及项目里的.kimi/config.json(含temperature、autoFix、codeStyle等字段),在官方文档里都找不到。官方扩展的设置项前缀是kimi.,CLI 配置是~/.kimi-code/config.toml。这几段疑似作者编的,不要照抄。Cursor 能装 VS Code 扩展,素材 [3] 说 Cursor「添加 Kimi Code 作为后端服务」,没有给具体步骤,官方文档也没写 Cursor 的接法,未核实。
5. 拿到会员 API Key(给第三方工具用)
只在要把 Kimi 模型接到 Claude Code、Codex 这类别的工具里时才需要。在 Kimi Code 自家的桌面端、CLI、VS Code 里用,登录账号就够了,不用手动配 Key [官5]。
确认会员是 Plus / Moderato 或以上(Go 没有编程额度)[官5]。
打开 Kimi Code 控制台 kimi.com/code/console。
点 Create API Key(新建 API Key),起个名字确认 [官22]。
立刻复制保存。完整的 Key 只显示一次,关掉弹窗就再也看不到了。每个账号最多建 5 个 Key [官23]。会员 Key 以
sk-kimi-开头 [官24]。
图源:[2] 元气万事屋Y《不会写代码:第一次用 Kimi Code 跑通一个项目》。图里的 Weekly usage(周用量)是老套餐 Moderato 才有的,新套餐没有周限额 [官4]。
控制台提示:别分享 Key,也别放进前端代码;检测到泄露会自动禁用 [2]。
这个 Key 和你登录的设备共用同一个额度池 [官4]。
6. JetBrains、Zed 等编辑器(通过 ACP)[官14]
ACP(Agent Client Protocol)是让编辑器驱动外部 Agent 的协议。Kimi Code CLI 用子命令 kimi acp 提供 ACP 服务,编辑器会自己把它当子进程启动,一般不用你手动运行 [4][5][官14]。
前提:先装好 CLI 并在终端里登录。编辑器会复用 CLI 的登录状态。
Zed:编辑 ~/.config/zed/settings.json,加上:
{
"agent_servers": {
"Kimi Code CLI": {
"type": "custom",
"command": "kimi",
"args": ["acp"],
"env": {}
}
}
}保存后在 Zed 的 Agent 面板新建对话即可。
JetBrains(IDEA、PyCharm、WebStorm 等):
没有 JetBrains AI 订阅的,连按两次 Shift 搜「Registry」,打开
llm.enable.mock.response,这样才能打开 AI 聊天面板。AI 聊天面板菜单里点 Configure ACP agents,加:
{
"agent_servers": {
"Kimi Code CLI": {
"command": "~/.local/bin/kimi",
"args": ["acp"],
"env": {}
}
}
}command必须写绝对路径,在终端运行which kimi查到后替换。保存后 Agent 选择器里会出现 Kimi Code CLI。
macOS 注意:从程序坞启动的编辑器拿不到终端里的 PATH,kimi 不在 /usr/local/bin 这类系统目录的话,Zed 里也要写绝对路径 [官14]。
排查 [官14]:编辑器提示 agent exited 或 auth required,先在终端跑一次 kimi acp。卡住等输入说明 CLI 没问题,是编辑器配置的事;立刻报错多半是没登录,在终端运行 kimi 完成 /login 再开编辑器。
三、上手流程:跑通第一个任务
1. 用桌面端或 VS Code:最省事的第一次 [2][官17]
打开项目文件夹(桌面端在输入框上方选工作区,VS Code 用 Open Folder)。
看一眼左侧文件目录,确认和你的项目文件夹内容一致。Kimi Code 就在这些文件上干活 [2]。
先确认左下角的模型。素材 [2] 提醒「模型切换到最新的」,按你的会员档位选(第二节第 1 小节的表)。
第一个任务先选只读的,比如「介绍一下这个项目」或「总结一下这个项目的目录结构和主要入口文件」[2][官17]。它只读文件、不改东西。
图源:[2] 元气万事屋Y《不会写代码:第一次用 Kimi Code 跑通一个项目》
再给一个修改型任务。官方示例 [官17]:
创建一个 hello.py,写一个用 f-string 返回问候语的 greet 函数,
让运行 python3 hello.py 时输出 Hello, Kimi!它要改文件或跑命令时会弹审批,看清楚要做什么再批准。第一次用建议权限选「始终询问」[官17]。
检查结果:桌面端右侧改动面板会出现
hello.py和改动内容;会话里命令输出Hello, Kimi!。也可以在底部终端(`Ctrl + ``)自己再跑一次 [官17]。
素材 [2] 的作者总结:记住三件事就够了,项目文件夹要选对、Kimi Code 要登录好、任务要用大白话讲具体。遇到界面和截图不一样,直接问 AI 怎么操作。
2. 用命令行:5 分钟四招 [1]
cd your-project
kimi先登录,别急着提需求:
/login,会员选 Kimi Code,按量付费选 Platform API Key [1]。先生成 AGENTS.md:输入
/init,它会扫描项目,生成一份「写给 AI 看的项目说明书」,写技术栈、目录结构、启动方式、测试命令和代码规范。素材 [1] 的说法:「你现在多写 5 分钟,后面能少解释 50 分钟。」用 @ 锁定文件:别问「限流逻辑在哪」,问「
@src/middleware/rate_limit.py这里的滑动窗口算法有没有漏洞?」。@会补全项目里的文件路径,选中后它直接读这个文件 [1][4]。改代码前先看 diff:比如「把用户注册接口改成邮箱验证码 + 密码双因子认证,并添加防暴力破解机制」。它会先分析影响范围、展示 diff,你可以接受、拒绝或追问「这个字段为什么要加」[1]。
复杂任务先进计划模式:按 Shift-Tab 或输入 /plan,或者用 kimi --plan 启动。它会先出方案,你确认后才改文件 [4][官12]。
3. 一个完整案例:搭企业行政系统的框架 [8]
素材 [8] 的作者是半路出家的程序员,用 Kimi Code 在 VS Code 里搭了一个行政管理系统的框架。值得学的是他的提问方式:
先让 AI 推荐技术架构,最后选了 FastAPI + Vue 的全栈 Python 方案。
把需求和附件(行政同事的工作清单)发给 Kimi Code,结尾加一句:「请先说下你对我需求的理解,看下还有没有什么需要补充,或者让我确认的地方。」
图源:[8] 坐等AI替我上班《使用Kimi Code开发企业级项目》
回答它提的问题,直到双方都没疑问,它才开始编码。
大约 20 分钟后交出阶段性结果:后端框架、RBAC 权限 7 大模块、前端框架、Docker 部署配置,共改动 70 个文件、新增 3012 行。
图源:[8] 坐等AI替我上班《使用Kimi Code开发企业级项目》
作者没用它给的 Docker Compose,而是在 WSL 的 Ubuntu 里自己装 Python 3.12、Node.js,建虚拟环境、装依赖,起数据库、后端和前端,浏览器打开就能访问 [8]。
注意:它自动生成的初始账号是
admin / 123456这种弱口令(见图 09),正式用之前一定要改。
4. 不写代码也能用:本地生成 PPT [9]
素材 [9] 的思路是「ChatGPT 负责想清楚,Kimi Code 负责做出来」:
先和 ChatGPT 聊清楚 PPT 的叙事逻辑,再让它输出一份详细的制作提示词:多少页、每页讲什么、字体字号、颜色、图片占比、禁止项,甚至「案例资料不足时不能编故事」。
把整份提示词交给 Kimi Code,告诉它素材文件夹在哪。
它读要求、读素材、把旧 PPT 拆开取图、按 16 页结构整理,最后写 Python 代码生成
.pptx,还会自己校验页数和图片有没有放对。
图源:[9] AI简学笔记《Kimi好用但太贵,我改用Kimi Code做PPT》
素材 [9] 的作者问过它能不能直接调 Kimi Work 的 PPT 工具,它查了一下说不能,但可以在本地直接生成。
5. 新手入门顺序建议 [4]
先掌握「安装登录 →
kimi启动 → 对话 → 常用斜杠命令」。弄懂三种权限模式的区别(第五节),熟了再开自动模式。
拿个小项目反复试
/init、/plan、kimi -c。记不住就
kimi --help、kimi <子命令> --help、会话里/help,比碎片教程准。启动报错先
kimi doctor。先写小脚本、改 bug,再做大重构。
别怕出错:
/undo能撤销提示词,/fork能分叉,kimi -c能恢复会话。
四、核心功能与进阶
1. AGENTS.md:给它立项目规矩
在项目里运行
/init,自动分析代码库、生成AGENTS.md[1][4]。全局通用的规矩写在
~/.kimi-code/AGENTS.md(只给 Kimi 用),或~/.agents/AGENTS.md(多个工具共享)[官10]。在应用外改了 AGENTS.md、Skill 或配置,输入
/reload立即生效,不用重启 [官28][官13]。素材 [1] 建议:团队没有项目规范文档的,
AGENTS.md可以顺手当第一版研发 SOP。从 Claude Code、Codex 转过来的,内置的
/import-from-cc-codex能把原来的指令、Skills 和 MCP 设置导进来 [官13]。
2. 三种权限模式与计划模式 [官12][官11]
| 模式 | 怎么开 | 行为 |
|---|---|---|
| 始终询问(Always Ask,原 Manual) | 默认 | 只读操作自动放行,改文件、跑命令逐一问你 |
| 必要时询问(Ask When Needed,原 YOLO) | /yolo 或 kimi --yolo | 普通操作自动批准;碰 .env、SSH 私钥、rm -rf、shutdown 这类还是会问 |
| 完全自动(Never Ask,原 Auto) | /auto 或 kimi --auto | 全部自动,不问你,危险命令也直接执行;只有计划模式的计划仍要你审 |
也可以输入
/permission选择 [4]。桌面端在输入框左下角切换(图 11 里显示的「必要时询问」)[6]。审批面板里可以选「Approve for this session」,本次会话同类操作不再问 [官12]。
想长期放行或禁止某些操作,在
config.toml写规则,比如允许读、禁止rm -rf[官8]:
[[permission.rules]]
decision = "allow"
pattern = "Read"
[[permission.rules]]
decision = "deny"
pattern = "Bash(rm -rf*)"新会话默认模式:
config.toml里defaultpermissionmode = "manual"(可选yolo/auto)[官8]。
计划模式(Plan):Shift-Tab 或 /plan 开关,/plan clear 清掉当前计划。它会先输出方案,等你批准、拒绝或要求修改,然后才动文件。从 v2.4.0(10-28)起,计划模式只能由你开启,Agent 不会自己进去;任何权限模式下(包括完全自动)退出计划模式都要你确认 [官12][官28]。
⚠️ 权限模式改过名,旧教程说法不一样。 素材 [4](7 月,按 0.26.0 核对)写
--yolo「跳过普通工具调用的审批」、--auto「审批自动处理,且不会向你提问」,素材 [1] 说 YOLO「会自动批准操作」。v0.40.0(9-02)起,原 YOLO 改名「必要时询问」,敏感文件和危险命令仍会问你;原 Auto 改名「完全自动」,并且从 v0.41.0 起不再拦截危险命令 [官28][官12]。图 01(0.19.2 版)底部的提示「/yolo to skip most approvals」也是旧说法。以官方现行文档为准。
3. 会话管理:继续、分叉、撤销、压缩 [4][官11][官13]
| 操作 | 命令 |
|---|---|
| 继续当前目录最近一次会话 | kimi -c(--continue) |
| 从历史里挑一个 / 按 ID 恢复 | kimi -S / kimi -S <ID>(--session) |
| 恢复时切换权限模式 | kimi -c --auto |
| 开新会话 | /new(别名 /clear) |
| 浏览历史会话 | /sessions(别名 /resume) |
| 分叉一个新会话 | /fork |
| 撤销最近的提示词 | /undo,或 /undo 3;空闲时连按两次 Esc |
| 压缩上下文 | /compact,可带说明,如 /compact 保留数据库迁移的讨论 |
| 开支线问答,不打扰主线 | /btw 你的问题 |
| 给会话起标题 | /title(别名 /rename) |
| 导出 | /export-md 导出 Markdown;/export-debug-zip 或 kimi export 导出诊断包 |
| 导入 Claude Code、Codex 的会话 | /import-sessions 或 kimi import-sessions(近 15 或 30 天)[官28] |
-c和-S不能同时用;/undo撤不回最后一次压缩之前的提示词 [4]。会话保存在
~/.kimi-code/sessions/下,按工作目录分组 [4][官10]。素材 [7] 提到关机后第二天用kimi -S <session_id>照样能接着干。导出的文件可能含代码和命令输出,分享前先检查 [4]。
Fork 的用法(官方号推荐)[6]:同一个问题有两种改法时,先 Fork,原会话分析方案 A,Fork 出来的会话分析方案 B,两边都开计划模式、只出计划不改文件,用同一套标准比较「改哪些模块、影响什么、怎么验证、风险和回退方案」,选定后在对应会话里批准计划继续执行。另一条留着,以后能回看当时为什么没选它。桌面端 v1.3.0 和 CLI v2.5.0(11-04)起还能从某个历史轮次、或者正在运行的会话分叉 [官28]。
图源:[6] 月之暗面 Kimi《Kimi Code 这样用,事半功倍》
4. 目标模式(Goal):让它跨多轮自己推进 [官12][7][6]
普通提示词说「下一步做什么」,目标说「最终要达到什么状态」。适合终点清楚、结果能验证的任务,比如修一批失败的测试 [官12]。
写法:/goal 后面写目标,最长 4000 字。素材 [7] 总结了四要素:
目标:要达成什么。
完成标准:怎么验证做完了。
边界:哪些不做。
停止规则:什么情况下停下来。
素材 [7] 的例子:/goal 帮我完成一个自动化登录测试的小程序,测试网站是:xxxx,能够实现自动化测试登录界面,包括输入账号密码;不要做 request 式的登录;在验证可以运行时停止。
官方号的例子 [6]:「将依赖升级到指定版本,保持现有公共接口不变,确保类型检查、单元测试和生产构建全部通过;如果发现需要更换其他核心依赖,或者修改范围明显扩大,则暂停并说明原因。」
管理命令 [官12]:/goal status 看进展;/goal pause / /goal resume 暂停继续;/goal cancel 取消;/goal replace <新目标> 替换;/goal next <后续目标> 排队。
「找出代码库里所有 bug」这种没有成功标准的目标,它可能马上就报「阻塞」,或者跑得远超预期 [官12]。
在「始终询问」模式下,目标可能停下来等你审批 [官12]。
价格表里目标模式列在 Pro 档的权益里 [官6],Plus 档能不能用 Kimi Code 的
/goal,官方没写清,未核实。
图源:[6] 月之暗面 Kimi《Kimi Code 这样用,事半功倍》
5. 多 Agent:Swarm 和 Tower
Swarm:
/swarm <任务>开启 swarm 模式并发送任务,/swarm on|off只开关 [官13]。适合把一件事拆给几个 Agent 并行做。素材 [7] 的例子:「请让 3 个 Agent 分别分析:1. 项目的依赖是否合理 2. 代码风格是否统一 3. 安全漏洞」。并行会更费额度。Tower:多 Agent 编排模式,每个任务在单独的 git worktree 里做,最后合并到一个 base 分支。
/tower on开启,/tower <分支名>指定要合并到的分支,/tower status看状态 [官13]。v2.4.0 起能给每个任务单独选模型 [官28]。子 Agent 模型:
/secondary-model选子 Agent 默认用哪个模型 [官13]。
6. Shell 模式、@ 引用、粘贴图片和视频 [4][官12]
Shell 模式:空输入框里敲
!进入,比如!git status。输出会写进对话,它后面能看到。命令运行中按Ctrl+B转后台 [4]。可以用!gh auth login登录 GitHub CLI,之后它就能用gh[官12]。@ 引用:git 和非 git 目录都能用,文件夹候选以
/结尾 [官12]。粘贴图片和视频:macOS / Linux 按
Ctrl-V,Windows 按Alt-V。能不能用取决于模型有没有看图(imagein)、看视频(videoin)的能力 [4][官12]。会话里累计的媒体超过 20 MB,最早的会被省略 [官12]。素材 [3] 的用法:上传设计稿让它用 React 实现,上传操作录屏让它分析交互逻辑。提示「Current model does not support image input」:换支持看图的模型,并确认剪贴板里是图片本身而不是文件路径 [官26]。
常用快捷键 [4]
| 快捷键 | 作用 |
|---|---|
Esc | 中断输出 / 关闭弹窗 |
Ctrl-C | 中断;有输入时清空;空输入连按两次退出 |
Shift-Tab | 开关计划模式 |
Shift-Enter / Ctrl-J | 换行 |
Ctrl-S | 它还在跑时插入补充指令 |
Ctrl-O | 展开 / 折叠工具输出 |
Esc Esc | 空闲时打开撤销选择器 |
Ctrl-G | 用外部编辑器写长提示词 |
7. 非交互模式、Web 界面和远程控制
非交互模式(脚本、CI) [4][官11]
kimi -p "总结一下这个项目的目录结构"
kimi -m kimi-code/kimi-for-coding -p "解释一下最新的 diff"
kimi -p "列出变更的文件" --output-format stream-json-p模式不会请你审批,按完全自动的规则处理,但config.toml里的禁止规则仍然生效。-p不能和--yolo、--auto、--plan一起用;--output-format只能配-p。CI 里没人点「信任此文件夹」,项目级 MCP 默认不启用;确认安全后可以设
KIMICODETRUST_WORKSPACE=1[官20]。素材 [10] 的 Godot/Blender 实测就是用非交互模式跑的,它执行命令不会停下来问。
Web 界面 [4]:kimi web 启动本地服务并打开浏览器,kimi web --no-open 不自动打开,kimi server kill 停止。Web 和终端共享本地会话,但界面和部分命令不完全一样。kimi vis 在浏览器里回看会话执行过程(不是实时的,要刷新)。
远程控制 [官19][6]:离开电脑后用手机看进度、批审批、追加指令。
本机运行
kimi rc(或在会话里输/remote-control,或kimi web --remote-control)。桌面端在「设置 → 远程控制」里开 [官28]。终端会打印访问链接(形如
https://code-rc.kimi.com/devices/<设备 ID>/,海外是code-rc.kimi.ai)和二维码,手机扫码。用同一个 Kimi 账号登录,选这台机器,就能看会话、发任务、批审批、中断任务。
需要付费会员;本机要保持开机、联网、不休眠。桌面端 v1.2.0 起有「防止休眠」开关(设置 → 通用)[官28]。
一台机器同时只能开一个实例,每个账号约 3 台设备。
链接等于这台电脑的遥控器,别发给别人或贴到公开地方。
所有计算和文件操作都在本机,网页只是远程窗口。
图源:[6] 月之暗面 Kimi《Kimi Code 这样用,事半功倍》
官方号推荐的长任务组合 [6]:Goal 写清目标和完成条件 → 测试、构建等耗时操作转后台(/tasks 查看)→ 离开前开远程控制。适合全量测试、多端打包检查、批量补测试这类时间长、验收标准明确的任务。
远程环境(v2.5.0 新增):通过 SSH、Docker 或自定义命令声明远程机器,文件和 Shell 操作在远程执行,模型请求和凭据留在本机 [官28]。具体配置见官方「远程环境」页面,本指南未展开。
8. 接入其他模型:在 Kimi Code 里用别家模型或开放平台 Key
Kimi Code 的 CLI 和桌面端都能接第三方模型,不一定非要用 Kimi 会员 [官7][官17]。
8.1 支持哪些协议 [官7]
type | 协议 | 典型用途 | 配置里的凭证键名 |
|---|---|---|---|
kimi | OpenAI 兼容 | Kimi Code 托管服务、Kimi 开放平台 Key | KIMIAPIKEY、KIMIBASEURL |
anthropic | Anthropic Messages | Claude 系列 | ANTHROPICAPIKEY、ANTHROPICBASEURL |
openai | OpenAI Chat Completions | OpenAI 及兼容服务,DeepSeek、Qwen 等 | OPENAIAPIKEY、OPENAIBASEURL |
openai_responses | OpenAI Responses API | OpenAI 新接口 | 同上 |
google-genai | Google GenAI | Gemini | GOOGLEAPIKEY |
vertexai | Vertex AI | Google Cloud | 走 Google 的 ADC 认证 |
Amazon Bedrock、Cohere 这类专有协议不支持 [官7]。
最容易踩的坑:在终端里
export KIMIAPIKEY=xxx是没用的。 Kimi Code CLI 不会自动从 shell 环境变量读 Key,必须写进config.toml,或者在配置里用apikeyenv指明读哪个变量 [官9][官8]。这和 Claude Code 的做法正好相反。
8.2 四种配置方式
方式 A:/provider 交互式添加(最简单) [官7][4]
会话里输入
/provider。在
[ Add New Platform ]行按 Enter。选 Known third-party provider:从公开模型目录 models.dev 里选供应商 → 粘贴 API Key → 选默认模型。网络访问不了目录时,会用内置的快照。
或者选 Custom registry:填自定义的模型目录地址(公司内部网关常用)。
↑↓ 移动,
d删除,/provider refresh刷新模型列表。
用 /login 登录的 Kimi 会员账号不在 /provider 里显示,用 /login、/logout 管 [官7]。
方式 B:命令行(适合脚本化部署) [4]
kimi provider list
kimi provider catalog list
kimi provider catalog add anthropic --api-key sk-ant-...
kimi provider remove <providerId>方式 C:手写 ~/.kimi-code/config.toml [官8][官7]
配置文件在 ~/.kimi-code/config.toml(Windows:C:\Users\你的用户名\.kimi-code\config.toml),首次运行自动生成。分两块:providers 写「连哪」,models 写「用哪个模型」。
示例一:用 Kimi 开放平台的按量 Key(国内地址)。字段按官方文档写法拼的,模型 ID 请从开放平台文档复制:
default_model = "moonshot/你选的模型"
[providers.moonshot]
type = "kimi"
base_url = "https://api.moonshot.cn/v1"
api_key_env = "MOONSHOT_API_KEY" # 从这个环境变量读 Key,Key 不写进文件
[models."moonshot/你选的模型"]
provider = "moonshot"
model = "开放平台文档里的模型ID"
max_context_size = 262144 # 按模型实际上下文填示例二:接一个 OpenAI 兼容的平台(如 DeepSeek、通义),把地址和模型名换成平台文档给的:
[providers.myplatform]
type = "openai"
base_url = "https://平台给的OpenAI兼容地址"
api_key = "sk-xxxxx" # 明文写入,文件别外传
[models."myplatform/模型名"]
provider = "myplatform"
model = "平台文档里的模型ID"
max_context_size = 131072
capabilities = ["thinking", "image_in", "tool_use"] # 自定义模型按需声明能力示例三:Claude(官方示例)[官7]:
[providers.anthropic]
type = "anthropic"
api_key = "sk-ant-xxxxx"
[models."claude-opus-4-7"]
provider = "anthropic"
model = "claude-opus-4-7"
max_context_size = 200000要点 [官8]:
字段名一律下划线写法;别名里有
.要加引号,如[models."gpt-4.1"]。Key 的优先级:
apikey或apikey_env(二选一)>[providers.<名字>.env]子表 > 都没有就启动报错。推理模型(DeepSeek、Qwen 等)的思考内容会自动处理;网关字段名不标准的,用
reasoning_key指定。Gemini 的
base_url只填主机根地址,结尾别带/v1beta[官7]。改完运行
kimi doctor检查格式,会话里/reload生效 [4][官13]。启动时临时换模型:
kimi -m <别名>。
方式 D:只用环境变量临时试一个模型(不改配置文件) [官9]
export KIMI_MODEL_NAME="模型ID"
export KIMI_MODEL_API_KEY="你的Key"
export KIMI_MODEL_BASE_URL="https://平台地址/v1"
export KIMI_MODEL_MAX_CONTEXT_SIZE="262144"
export KIMI_MODEL_CAPABILITIES="image_in,thinking"
kimiWindows PowerShell 把 export X="..." 换成 $env:X = "..."。它只在内存里生效,重启就没了;优先级高于 default_model,低于 -m [官9]。
桌面端:设置 → 模型供应商 → 添加供应商,填名称、API 协议、API Key、Base URL 和模型信息,保存后在输入框里切到这个模型,先发一个只读任务确认能用 [官17][官18]。桌面端和 CLI 共享部分本地配置 [官17]。
VS Code 扩展:和 CLI 共用 config.toml。CLI 里配好供应商后,扩展登录页点 Skip 就能用(图 03)[2][官15]。
8.3 配完怎么验证
新开终端,运行
kimi,输入/status看当前模型是不是你配的 [4]。/model切到这个模型,发一句「你好」。/login时报「No models available for the selected platform」:Key 不对或过期,或网络访问不了api.kimi.com/api.moonshot.cn[官26]。
8.4 换模型后哪些功能受限
看图、看视频:要看模型有没有
imagein/videoin能力;K3 256K 只能看图 [官5][官12]。网页搜索和抓取:默认走 Kimi 自己的服务(
api.kimi.com/coding/v1/search、/fetch)[官8],只接第三方模型时能不能用,官方没写清,未核实。远程控制:需要付费 Kimi 会员 [官19]。
思考档位:第三方模型的思考档位由
supportefforts、defaulteffort等字段决定,不一定和 Kimi 一致 [官8]。中途换模型会让上下文缓存失效、多耗额度。会话里切模型时会弹确认:新建会话、压缩后继续,或直接继续 [官5][官28]。
9. 把 Kimi 模型接到 Claude Code、OpenCode、Codex、Hermes
反过来的用法:继续用你熟悉的工具,只把模型换成 Kimi。前提是会员 Plus 及以上,并在控制台建好 API Key(第二节第 5 小节)。
9.1 接口地址和模型 ID [官5]
| 协议 | 国内 | 海外 |
|---|---|---|
| Anthropic 兼容(给 Claude Code 用) | https://api.kimi.com/coding/ | https://api.kimi.ai/coding/ |
| OpenAI 兼容(Responses / Chat Completions,给 Codex、Hermes 等用) | https://api.kimi.com/coding/v1 | https://api.kimi.ai/coding/v1 |
模型名要填模型 ID(如
k3.1-pro),不是显示名(K3.1 Pro)。ID 填错会被悄悄降级成 K2.8 Preview 的无思考版,效果变差但不报错 [官5]。K3.1 Pro 系列只支持思考模式,工具里把思考关掉会返回 400 [官5]。
官方建议用原生协议、新建会话再用;经过代理做协议转换可能效果不稳 [官5][官22]。
思考档位换算(第三方工具里填的值 → 实际档位)[官5]
| 工具里的值 | 实际 |
|---|---|
| 不设 | 模型默认:K3.1、K3 为 high,K2.8 Preview 为 max |
ultra / max / xhigh | max |
high / medium | high |
low / minimum / light | low |
off / none / disabled | K3.1 系列报 400;K3、K2.8 Preview、K2.7 Highspeed 转给 K2.8 Preview 无思考版 |
| 其他值 | 400 |
9.2 Claude Code [官22]
① 装好 Claude Code 后先别启动。官方提供了一段 node --eval 清理脚本(见 [官22] 第 ② 步),做两件事:在 ~/.claude.json 里写入 hasCompletedOnboarding: true 跳过 Anthropic 登录;删掉 ~/.claude/settings.json 的 env 里残留的旧地址、Key 和模型变量。还要检查 ~/.zshrc、~/.bashrc(Windows 查用户环境变量)里有没有旧的 ANTHROPIC_*,有就删掉。
② 按会员档位选模型:Plus / Moderato 用 k3.1-pro(256K);Pro / Allegretto 及以上可以用 k3.1-pro[1m](1M 上下文)[官22]。
③ 写配置(两种方式选一种,别混用)
方式一(推荐,长期生效):编辑 ~/.claude/settings.json(Windows:C:\Users\你的用户名\.claude\settings.json),文件不存在就新建:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.kimi.com/coding/",
"ANTHROPIC_API_KEY": "你的API Key",
"ANTHROPIC_MODEL": "k3.1-pro",
"ANTHROPIC_DEFAULT_FABLE_MODEL": "k3.1-pro",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "k3.1-pro",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "k3.1-pro",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "k3.1-pro",
"CLAUDE_CODE_SUBAGENT_MODEL": "k3.1-pro",
"CLAUDE_CODE_EFFORT_LEVEL": "high",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "262144",
"CLAUDE_CODE_MAX_CONTEXT_TOKENS": "262144"
}
}用 1M 上下文的:把所有 k3.1-pro 换成 k3.1-pro[1m],两个窗口值换成 1048576 [官22]。保存后重启 Claude Code。
方式二(只对当前终端有效,适合先试试):
macOS / Linux:
export ANTHROPIC_BASE_URL=https://api.kimi.com/coding/
export ANTHROPIC_API_KEY=你的API Key
export ANTHROPIC_MODEL="k3.1-pro"
export ANTHROPIC_DEFAULT_FABLE_MODEL=$ANTHROPIC_MODEL
export ANTHROPIC_DEFAULT_OPUS_MODEL=$ANTHROPIC_MODEL
export ANTHROPIC_DEFAULT_SONNET_MODEL=$ANTHROPIC_MODEL
export ANTHROPIC_DEFAULT_HAIKU_MODEL=$ANTHROPIC_MODEL
export CLAUDE_CODE_SUBAGENT_MODEL=$ANTHROPIC_MODEL
export CLAUDE_CODE_EFFORT_LEVEL=high
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=262144
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=262144
claudeWindows PowerShell:
$env:ANTHROPIC_BASE_URL="https://api.kimi.com/coding/"
$env:ANTHROPIC_API_KEY="你的API Key"
$env:ANTHROPIC_MODEL="k3.1-pro"
$env:ANTHROPIC_DEFAULT_FABLE_MODEL=$env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_OPUS_MODEL=$env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_SONNET_MODEL=$env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL=$env:ANTHROPIC_MODEL
$env:CLAUDE_CODE_SUBAGENT_MODEL=$env:ANTHROPIC_MODEL
$env:CLAUDE_CODE_EFFORT_LEVEL="high"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="262144"
$env:CLAUDE_CODE_MAX_CONTEXT_TOKENS="262144"
claude变量说明 [官22]
| 变量 | 作用 | 不配会怎样 |
|---|---|---|
ANTHROPICBASEURL | 请求发到 Kimi | 发到 Anthropic 官方,鉴权失败 |
ANTHROPICAPIKEY | Kimi 会员 Key。Kimi 用的是这个变量,不是 ANTHROPICAUTHTOKEN | 401 |
ANTHROPIC_MODEL | 主对话模型 | 用 Claude 默认模型名,报模型不存在 |
ANTHROPICDEFAULTOPUS/SONNET/HAIKU/FABLE_MODEL | Claude Code 内部各档模型 | 对应档位的后台任务(生成标题、摘要)失败 |
CLAUDECODESUBAGENT_MODEL | 子 Agent 模型 | 子任务失败或效果变差 |
CLAUDECODEAUTOCOMPACTWINDOW、CLAUDECODEMAXCONTEXTTOKENS | 上下文窗口 | 设小了过早压缩,设大了报超限 |
CLAUDECODEEFFORT_LEVEL | 默认思考档位 | 设太低复杂任务质量下降 |
换模型时,所有模型变量都要一起改 [官22]。
④ 启动和验证:启动后问你要不要用这个 API Key,选确认;再信任项目文件夹。输入 /status,Base URL 显示 https://api.kimi.com/coding/ 就成功了。这时模型名可能还显示成 Claude,实际调的是 Kimi [官22]。会话里用 /effort 换思考档位;K3 系列开关思考的快捷键 macOS 是 Option+T,Windows / Linux 是 Alt+T [官22]。
VS Code 里的 Claude Code 插件 [官22]:
先按方式一写好
settings.json(插件和命令行共用~/.claude的配置)。插件新建会话,在登录页点底部的 Run
claudein terminal。在弹出的终端里依次选 Yes, I trust this folder 和 API Key 确认的 1. Yes。
完全退出 VS Code 再打开。跳过终端确认这一步,插件会一直弹登录页。
Claude Code 常见报错 [官22]
| 现象 | 怎么办 |
|---|---|
| 改了配置不生效 | 查 settings.json 的 env 里有没有旧值(它会覆盖终端变量);改完要重启 Claude Code |
| 401 | 确认 ANTHROPICAPIKEY 是有效的 Kimi Code 会员 Key |
| model not found | 模型名拼写、空格、引号 |
| 后台任务或子 Agent 报错 | 补齐 HAIKU、FABLE、SUBAGENT 三个变量 |
| VS Code 插件一直要登录 | 补做终端里的两步确认 |
其他通用的坑(比如用第三方模型后 Claude Code 的手机遥控、语音不能用)可以参考本库《Claude Code 使用指南》第四节第 8 小节。
9.3 OpenCode [官23]
安装:
curl -fsSL https://opencode.ai/install | bash,或npm install -g opencode-ai。运行
opencode auth login,供应商列表里选 Kimi For Coding,粘贴会员 Key。启动
opencode,输入/models,在 Kimi For Coding 下面选模型。选 K3.1 Pro、K3、K2.8 Preview 的,用
/variants选思考档位:Default/low/high(推荐)/max。
9.4 Codex [官24]
安装 Codex CLI:
npm install -g @openai/codex。新建
~/.codex/models.json(Windows:C:\Users\你的用户名\.codex\models.json),声明k3.1-pro和k3.1-pro-highspeed两个模型(上下文 1048576,思考档位 low/high/max,默认 high)。完整内容见 [官24]。编辑
~/.codex/config.toml:
model = "k3.1-pro"
model_provider = "kimi"
web_search = "live"
model_catalog_json = "~/.codex/models.json"
[model_providers.kimi]
name = "Kimi"
base_url = "https://api.kimi.com/coding/v1"
env_key = "KIMI_API_KEY"
wire_api = "responses"
[desktop]
enabled-reasoning-efforts = ["low", "high", "max"]海外把
base_url换成https://api.kimi.ai/coding/v1。envkey填的是变量名,不是 Key 本身;wireapi必须是"responses"。
设置 Key:
| 系统 | 命令 |
|---|---|
| macOS | echo 'export KIMIAPIKEY="sk-kimi-你的key"' >> ~/.zshrc 然后 source ~/.zshrc |
| Linux | echo 'export KIMIAPIKEY="sk-kimi-你的key"' >> ~/.bashrc 然后 source ~/.bashrc |
| Windows | setx KIMIAPIKEY "sk-kimi-你的key",然后重开终端 |
| macOS 上的 Codex 桌面 App | 额外运行 launchctl setenv KIMIAPIKEY "sk-kimi-你的key",Cmd+Q 完全退出再打开;重启电脑后要重新执行 |
进项目目录运行
codex,发hello。启动信息显示model: k3.1-pro、provider: kimi,并且没有「Model metadata not found」警告,就成功了。/model里选思考档位。
Codex 注意事项 [官24]:Responses 接口只支持文字和图片,不支持视频(要分析视频先用 ffmpeg 抽关键帧);报「Missing environment variable: KIMIAPIKEY」说明进程没读到变量,新开终端再试;换思考档位后最好新建会话。
9.5 Hermes Agent [官25]
设置 Key:
export KIMIAPIKEY="sk-kimi-你的会员Key"。长期生效就加进~/.zshrc或写进~/.hermes/.env。hermes config edit(或直接用编辑器打开~/.hermes/config.yaml),加一个自定义供应商:baseurl: https://api.kimi.com/coding/v1、keyenv: KIMIAPIKEY、apimode: chatcompletions、model: k3.1-pro,reasoning_effort: high,上下文 262144。完整 YAML 见 [官25]。base_url只填到/coding/v1,Hermes 会自己加/chat/completions。
9.6 Kimi 模型 API 常见报错 [官27]
| 报错关键词 | 状态码 | 原因和处理 |
|---|---|---|
The API Key appears to be invalid or may have expired | 401 | Key 输错、过期或被撤销;或者有旧的 KIMIAPIKEY / OPENAIAPIKEY 环境变量盖掉了配置 |
Invalid Authentication | 401 | 最常见:把开放平台的 Key 或地址和会员的混用了 |
Your current subscription does not have access to k3.1-pro | 403 | 档位不够,K3.1 Pro 要 Plus 及以上 |
Your current plan supports only k3.1-pro up to 256K context | 403 | 1M 上下文要 Pro 及以上,换回 256K 配置 |
unable to verify your membership benefits | 403 | 会员过期,或稍后重试 |
You've reached your 5-hour usage limit | 429 | 5 小时限额到了,等窗口滚动或买加油包 |
You've reached your weekly (7-day) usage limit | 429 | 老套餐的周限额 |
You've reached your monthly usage limit | 429 | 月度额度池用完 |
You've reached your concurrent request limit | 429 | 并发太多,比如多个工具同时跑 |
Your model id does not exist | 400 | 模型 ID 写错 |
Your request exceeded model token limit: 262144 | 400 | 上下文超了,压缩或调小窗口设置 |
K3.1 Pro does not support disabled thinking mode | 400 | 把思考打开 |
用第三方工具时,错误码可能被工具改写过,以报错文字为准对照 [官27]。
10. 扩展:Skills、MCP、插件、Hooks
Agent Skills [官21]:一个 Skill 就是一份带 YAML 头的 Markdown,写某项工作流程或规范,可以用斜杠命令调用,也可以让模型需要时自己调用。
存放位置(越具体优先级越高):
项目级:
.kimi-code/skills/、.agents/skills/用户级:
~/.kimi-code/skills/、~/.agents/skills/(~/.agents这个目录多个工具共享)额外目录:
config.toml里extraskilldirs = ["~/team-skills"]
推荐目录形式:
skills/review-pr/SKILL.md,同目录放辅助文件。调用:外部 Skill 用
/skill:<名字>,名字不冲突时可简写/<名字>;内置 Skill 直接/<名字>[4];插件里的 Skill 用<插件ID>:<技能名>(v2.3.0 起)[官28]。
⚠️ 素材 [7] 说「在
~/kimi-code/里面创建 skills 文件夹,加入Web 自动化.md」,再用/skill Web 自动化调用。官方目录是~/.kimi-code/skills/(有个点),调用写法是/skill:<name>,Skill 名用英文短横线更稳妥。以官方为准 [官21][4]。
MCP(接外部工具,如数据库、GitHub、Blender)[官20]
配置文件:用户级
~/.kimi-code/mcp.json,项目级.kimi-code/mcp.json,同名以项目级为准。不想手写 JSON:会话里
/mcp-config交互式添加,/mcp看连接状态,/mcp-config login <名字>做 OAuth 授权 [官20][4]。格式:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
},
"linear": {
"url": "https://mcp.linear.app/mcp"
}
}
}有 command 的是本地 stdio 服务;有 url 的是 HTTP 服务;老式 SSE 要写 "transport": "sse"。
项目里自带的
.kimi-code/mcp.json会在会话开始时执行命令。打开别人的仓库时,信任提示会列出每个服务要启动什么,看清楚再信任 [官20][10]。
插件:/plugins 打开插件管理器。官方内置插件有 Kimi Computer Use、Kimi WebBridge 等 [官28][官13]。
Hooks:在工具调用前后跑自己的脚本,比如 PreToolUse 时检查 Bash 命令,写在 config.toml 的 [[hooks]] 里 [官8]。
其他:数据目录换位置用 KIMICODEHOME;关闭匿名遥测设 KIMIDISABLETELEMETRY=1 或 config.toml 里 telemetry = false [官9][官8]。
11. 桌面端专属:内置浏览器与截屏框选 [6]
做网页时,不用在对话、编辑器、浏览器之间来回切:
Kimi Code 可以在任务里直接启动本地服务、打开页面,自己点击、输入、填表、滚动;你也能随时接管 [6]。
复现页面 bug:把操作路径和预期结果告诉它,让它按步骤复现、分析、修改,再沿同一路径验证 [6]。
截屏框选:问题出现后截下页面,框出异常区域、写明预期效果,交给它继续改(快捷键见图 11,macOS 是
Shift+Cmd+S)[6]。设备尺寸:内置 iPhone、Pixel、Galaxy、iPad、折叠屏和桌面等预设,一键切换检查页面在不同尺寸下有没有错位 [6]。
图源:[6] 月之暗面 Kimi《Kimi Code 这样用,事半功倍》
查阅对比多份技术文档、从多个公开页面收集信息写调研报告、核对设计稿和实际页面,也能用这两个功能 [6]。
12. 进阶场景:改 Godot、Blender 等 3D 和游戏工程 [10]
11 月 2 日,月之暗面发布了「Kimi 游戏开发与创意工作解决方案」,说 Kimi 可以通过插件和工具调用连上 Blender、Unity、Unreal 等软件,直接改已有工程 [10]。
图源:[10] 米花的ai学习《Kimi 能直接改你的游戏工程了:我用 Kimi Code 实测了 Blender 和 Godot》
入口怎么选 [10]
Blender、虚幻引擎、Maya 等需要本地安装插件的,官方说「仅在 Kimi Work 支持」。
Unity、Godot 只写了「Kimi Code 工具调用」。
3ds Max 和 AutoCAD 只支持 Windows。Maya 和 Godot 用的是社区 MCP。
用 Kimi Code 改工程(素材 [10] 实测的路线)
装好命令行版,进工程目录运行
kimi,/login登录。在提示词里告诉它引擎装在哪。它会自己用 Godot 命令行跑游戏,用 Blender 的后台模式改文件、出渲染图,不装插件也行。
想接社区 MCP,用
/mcp-config添加,或写进工程目录的.kimi-code/mcp.json。第一次先让它只读不改。素材 [10] 实测过的提示词:
这是一个 Godot 4 项目。先不要改任何文件:
列出场景树、主要脚本和调用关系,
告诉我"角色受伤闪红"该改哪几个文件。
等我确认再改,改完运行一次截图给我。图源:[10] 米花的ai学习《Kimi 能直接改你的游戏工程了:我用 Kimi Code 实测了 Blender 和 Godot》
实测环境:Kimi Code CLI 2.4.1、K3.1 Pro、思考强度 max,Blender 5.2.1,Godot 4.8 beta [10]。Godot 那次它只读了 8 个文件,判断只需改 1 个,确认后只在 player.gd 里加了 13 行,还自己录了 180 帧检查颜色变化。Blender 那次它发现台灯的金属材质椅子腿也在用,主动提醒不要改 [10]。
但验证有盲区:台灯改暖光,参数都改对了,渲染图上却几乎看不出变化,它只检查了杯子那块就说「检查通过」。作者指出后,它做了 9 次对比渲染,查出光源被包在灯泡和灯杆里面,第三轮才修好 [10]。
图源:[10] 米花的ai学习《Kimi 能直接改你的游戏工程了:我用 Kimi Code 实测了 Blender 和 Godot》
素材 [10] 列的缺点:方案更像给企业的(页面按钮是「联系销售团队」);找不到 3D 插件的公开说明和下载地址,11 月 3 日 Kimi Code 默认插件市场的 6 个插件里没有 3D 或引擎类;官方演示没写花了多少 token、人工介入多少;人物、动物这类精细模型官方自己承认还做不好。也有其他作者质疑 20 小时重建 Unity 原型的案例「至今无第三方复现」[10]。
五、避坑与注意
1. 权限和安全
生产项目别开完全自动。素材 [1] 的说法:把它当一个很快的实习生,能干活,但必须 review。完全自动模式下危险命令不拦截 [官12]。
「必要时询问」只在可信的目录里开 [4][官11]。
MCP 接上数据库、接口、文件系统后,AI 能碰到的东西更多,权限更要收紧 [1]。
打开陌生仓库时,看清它自带的
.kimi-code/mcp.json要启动什么命令再点信任 [官20][10]。API Key 写在配置文件里是明文。
~/.claude/settings.json、~/.kimi-code/config.toml、~/.codex/config.toml都别提交到仓库、别随 dotfiles 公开 [官22][官24]。能用apikeyenv/env_key引用环境变量的,尽量别写明文 [官8][官24]。远程控制链接别外传 [官19]。
改 3D 工程这类二进制文件,先用 git 备份;
.blend、.uasset在 git 里看不出改了哪,可以让它写脚本列出改动前后的物体和材质做对比 [10]。它说「验证通过」时自己看一眼效果,特别是灯光、材质这类「参数对了、画面不一定对」的改动 [10]。
共用的东西(一个材质、一个脚本多处在用)改之前先让它查清楚 [10]。
2. 省额度
上下文快满时
/compact,或者换话题就/new;不相关的小问题用/btw[4]。需求先想清楚再交给它。素材 [9] 先用别的 AI 把 PPT 逻辑和制作要求定好,Kimi Code 只管执行;素材 [8] 先让它复述需求再动手。
/goal写清完成标准和停止规则,避免它跑远 [7][官12]。Swarm 并行、思考强度 max、Highspeed 模型都更费额度 [7][官5]。
同一会话里别频繁换模型和思考档位,会让缓存失效 [官5]。
从 K3(1M)切到 K3 256K 前,上下文超过 256K 或含视频的先压缩 [官5]。
3. 常见问题
| 问题 | 解决 |
|---|---|
| Windows 启动报错找不到 shell | 装 Git for Windows;装在非默认位置的设 KIMISHELLPATH [官2] |
| macOS 第一次运行很慢 | Gatekeeper 在检查,耐心等;或在「系统设置 → 隐私与安全性 → 开发者工具」里加上你的终端 [官26] |
/login 时模型列表为空 | Key 无效或过期,或网络访问不了接口 [官26] |
| 第三方 Key 在终端 export 了却没生效 | Kimi Code CLI 不从 shell 读 Key,写进 config.toml 或用 apikeyenv [官9] |
| VS Code 提示未打开工作区 | 先 Open Folder [官26] |
| VS Code 提示找不到 CLI | 装 CLI,并在设置里填 kimi.executablePath [官26] |
| VS Code 登录失败 | 点 Skip 用 API Key 模式,或检查网络稍后重试 [官26] |
| VS Code 发消息没反应 | 确认 CLI 可用、模型配好、打开了文件夹;看「Kimi Code: Show Logs」[官26] |
| VS Code 30 秒超时 | 网络问题,检查后重试 [官26] |
| 桌面端用不了官方模型 | 没订阅会员或档位不够;或者改接第三方供应商 [官18] |
| 桌面端发不了消息 | 空会话要先选工作区 [官18] |
| 桌面端启动失败、白屏 | 帮助 → 导出诊断信息…,ZIP 在「下载」文件夹,反馈时附上 [官18] |
| 遇到客服问题 | Kimi 网页端左下角头像 → 帮助 → 用户反馈 [官26] |
4. 素材之间的矛盾和过时信息汇总
⚠️ 安装方式:素材 [3][5] 的 Python / uv 安装和旧脚本地址已过时,以 Node.js 版为准(第二节第 3 小节)[官3]。素材 [3] 的 PATH、
uv not found等排错也是针对旧版的。
⚠️ 免费额度:素材 [5] 说免费、有免费额度,素材 [3] 说会员无限次,都和现行官方规则不符(第二节第 1 小节)[官4][官6]。
⚠️ 模型名和会员名换得很快:素材 [3](4 月)写底层是 K2.5/K2.6;素材 [8](4 月)买的是 Moderato 会员、用 K2.6-code-preview;素材 [7](6 月)说「版本已经升级到了 2.6」;素材 [2](7 月)让切到 K3;素材 [10](11 月)用 K3.1 Pro。现在
kimi-for-coding这个 ID 对应的是 K2.8 Preview [官5]。素材 [4] 示例里的kimi-code/kimi-for-coding是 CLI 里的模型别名写法,仍可用,但指向的模型已经变了。以你自己/model里看到的为准。
⚠️ K2.6「连续编码 13 小时、4000 行」:出自素材 [3],是对 4 月 K2.6 发布宣传的转述,本指南未核实,也不代表现行模型。
⚠️ 权限模式名称:素材 [1][4] 的 YOLO / Auto 说法是 9 月改名前的,见第四节第 2 小节 [官28]。
⚠️ 素材 [3] 的配置示例疑似编造:
.kimi/config.json、VS Code 的kimi-code.enableACP等在官方文档里找不到(第二节第 4 小节)。
⚠️ Skills 目录:素材 [7] 写
~/kimi-code/,官方是~/.kimi-code/skills/(第四节第 10 小节)[官21]。
⚠️ GitHub 星数和开源协议:素材 [5] 说 MoonshotAI/kimi-code 4.9k 星、kimi-cli 10.7k 星、MIT 协议、「完全免费」。星数会变,协议本指南未到 GitHub 核实;「免费」只指程序本身,模型要付费。
⚠️ Kimi Work 和 Kimi Code 是两个产品:素材 [9] 用 Kimi Work 做 PPT 嫌额度用得快,换成 Kimi Code。但按官方价格页,所有会员功能共用一个月度额度池 [官6],换工具不等于不花额度,只是做法不同、消耗可能不一样。素材 [10] 里的 Kimi Work 系统要求也不适用于 Kimi Code 桌面端。
六、参考原文
| # | 标题(链接) | 公众号 | 发布 | 用到的内容 | 用图 |
|---|---|---|---|---|---|
| 1 | Kimi Code上手5分钟 | 未哥AI智能体 | 2026-05-29 | 新版安装命令、四招(登录、/init、@ 引用、看 diff)、适用场景、安全提醒 | — |
| 2 | 不会写代码:第一次用 Kimi Code 跑通一个项目 | 元气万事屋Y | 2026-07-20 | VS Code 扩展完整流程、选文件夹、登录、控制台截图 | 02、03、04、05、06、07 |
| 3 | Kimi Code 完全指南:国产AI编程Agent的安装与使用技巧 | 赛博搬砖指南 | 2026-04-27 | 发布时间、定位、多模态用法、执行策略修复。安装方法已过时,配置示例疑似编造,只采用通用内容并标 ⚠️ | — |
| 4 | 从会用到好用 | Kimi Code 命令新手手册:小白可直接上手的基础命令汇总 | 芯智荟 | 2026-07-17 | 安装、登录两种方式、启动参数、会话管理、斜杠命令、快捷键、provider、doctor、学习建议(按 0.26.0 核对,权限模式说法已过时) | — |
| 5 | Kimi Code CLI保姆级教程:GitHub 15.6k星的免费AI编程Agent,5分钟0成本上手 | 知否007 | 2026-07-24 | 能力概述、5 个场景、ACP 集成。推荐旧 Python 版、「免费」说法不准,标 ⚠️ | — |
| 6 | Kimi Code 这样用,事半功倍 | 月之暗面 Kimi(官方号) | 2026-11-02 | 内置浏览器与截屏框选、远程控制 + Goal + 后台任务、Fork(文末有评论区送周边活动) | 11、12、13、14 |
| 7 | Kimi Code Cli效果惊艳到了我,分享一些使用的指南和小技巧 | 小白部署不输 | 2026-06-30 | 首次启动界面、/goal 四要素、/swarm、session 恢复;Skills 目录写法不准,标 ⚠️ | 01 |
| 8 | 使用Kimi Code开发企业级项目 | 坐等AI替我上班 | 2026-04-17 | 先让它复述需求的提问法、行政系统框架案例、本地部署流程 | 08、09 |
| 9 | Kimi好用但太贵,我改用Kimi Code做PPT | AI简学笔记 | 2026-09-05 | 「先想清楚再执行」的 PPT 工作流 | 10 |
| 10 | Kimi 能直接改你的游戏工程了:我用 Kimi Code 实测了 Blender 和 Godot | 米花的ai学习 | 2026-11-03 | 3D/游戏方案的入口、Godot 和 Blender 实测、验证盲区、价格、注意事项 | 15、16、17 |
10 篇全部采用,没有剔除的文章。00_清单里说明已在采集阶段剔除了一篇借教程推第三方 API 中转的文章。
官方文档补充(2026-11-07 查阅;除注明外,均为 Kimi Code 官方文档 https://www.kimi.com/code/docs/ 下的页面)
| 编号 | 页面(链接) | 用到的内容 |
|---|---|---|
| 官1 | 产品概览 | 产品定义、四种入口、安装命令 |
| 官2 | CLI:开始使用 | 系统要求、各平台安装命令、Windows 注意、登录、升级与卸载 |
| 官3 | CLI:从 kimi-cli 迁移 | Python 版停止维护、kimi migrate 迁移内容 |
| 官4 | 会员权益 | 新老套餐档位、额度规则、加油包、设备解绑 |
| 官5 | 模型配置 | 模型 ID、上下文、思考档位换算、接口地址、ID 写错的后果 |
| 官6 | Kimi 帮助中心:会员价格 | Go/Plus/Pro/Max/Ultra 价格(2026-10-19 截图)和权益 |
| 官7 | CLI:平台与模型 | 供应商类型、/provider 用法、各协议配置示例 |
| 官8 | CLI:配置文件 | config.toml 结构、providers/models 字段、权限规则、hooks |
| 官9 | CLI:环境变量 | Key 不从 shell 读取、KIMI_MODEL_*、KIMI_CODE_HOME、遥测开关 |
| 官10 | CLI:数据路径 | ~/.kimi-code/ 目录结构、自动更新开关、全局 AGENTS.md |
| 官11 | CLI:kimi 命令 | 启动参数、冲突规则、非交互模式、kimi login |
| 官12 | CLI:交互与输入 | 三种权限模式、计划模式、Shell 模式、目标模式、媒体粘贴 |
| 官13 | CLI:斜杠命令 | /swarm、/tower、/reload、/import-sessions、内置 Skill 等 |
| 官14 | CLI:在 IDE 中使用 | Zed、JetBrains 的 ACP 配置和排查 |
| 官15 | VS Code:快速开始 | 两种认证模式、快捷键、常见问题 |
| 官16 | VS Code:配置 | kimi.* 设置项 |
| 官17 | Desktop:快速开始 | 系统要求、安装、登录区域、接第三方供应商、首个任务、kimi app |
| 官18 | Desktop:常见问题与故障排除 | 安装包选择、官方模型不可用、导出诊断信息 |
| 官19 | CLI:远程控制 | kimi rc、使用条件、设备限制、安全提醒 |
| 官20 | CLI:Model Context Protocol | mcp.json 位置和格式、工作区信任、CI 下的处理 |
| 官21 | CLI:Agent Skills | Skill 文件格式、存放目录和优先级 |
| 官22 | 在 Claude Code 中使用 | 清理脚本、settings.json 和终端变量两种配置、变量说明、VS Code 插件步骤、报错 |
| 官23 | 在 OpenCode 中使用 | 安装、opencode auth login、/variants、Key 最多 5 个 |
| 官24 | 在 Codex 中使用 | models.json、config.toml、各系统设 Key、验证、不支持视频 |
| 官25 | 在 Hermes Agent 中使用 | Key 设置、config.yaml 自定义供应商 |
| 官26 | 常见问题 | 会员和开放平台的地址对照、登录与 VS Code 常见问题、macOS 首次运行慢 |
| 官27 | 错误参考 | 401/403/429/400 报错关键词和处理 |
| 官28 | 最新动态 | 各版本变化:权限模式改名(v0.40.0)、桌面端发布与 Linux 版、K3.1 Pro 上线、计划模式改为手动开启(v2.4.0)、v2.5.0 / Desktop v1.3.0 |
图片清单
| 文件 | 内容 | 来源 |
|---|---|---|
| images/01-CLI欢迎界面.png | CLI 首次启动界面(0.19.2 版),提示 /login 或 /provider | [7] 第 2 张 |
| images/02-VSCode扩展市场.png | VS Code 扩展市场里的官方 Kimi Code 插件 | [2] 第 4 张 |
| images/03-VSCode插件登录页.png | 插件欢迎页:Sign in with Kimi Account / Skip | [2] 第 5 张 |
| images/04-VSCode插件就绪面板.png | 登录后的插件面板 | [2] 第 7 张 |
| images/05-控制台与APIKey.png | Kimi Code 控制台的用量、权益和 API Keys | [2] 第 6 张 |
| images/06-选对项目文件夹.png | 打开文件夹时选对层级 | [2] 第 2 张 |
| images/07-VSCode中派任务.png | 在插件里问项目是做什么的 | [2] 第 9 张 |
| images/08-先让它复述需求.png | 先让 Kimi Code 复述需求、给架构建议 | [8] 第 1 张 |
| images/09-阶段性成果.png | 行政系统框架的阶段性成果和改动统计 | [8] 第 3 张 |
| images/10-生成PPT完成.png | 生成 PPT 后的自检结果 | [9] 第 8 张 |
| images/11-桌面端任务模式菜单.png | 桌面端输入框的任务模式菜单和权限、模型选择 | [6] 第 5 张 |
| images/12-内置浏览器设备尺寸.png | 内置浏览器的设备尺寸预设 | [6] 第 4 张 |
| images/13-远程控制.gif | 手机上远程查看本机任务 | [6] 第 6 张(动图) |
| images/14-分叉会话.png | 会话右键菜单里的分叉会话 | [6] 第 7 张 |
| images/15-九个专业软件入口.png | 9 个 3D/游戏软件分别走 Kimi Work 还是 Kimi Code | [10] 第 1 张(作者整理图) |
| images/16-Godot只读后再改.png | Godot 实测:先只读、再修改、自己验证 | [10] 第 5 张 |
| images/17-验证盲区排查.png | Blender 实测里的验证盲区和排查过程 | [10] 第 8 张 |