天工开物KAIWU AI
工具指南 › Kimi Code › Kimi Code 使用指南(完整全套)
核实于 2026-11-07
工具指南·其八核实于 2026-11-07

Kimi Code 使用指南(完整全套)

适用对象
想快速了解工具定位、核心功能和上手路径的中文用户
核对日期
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 CodeClaude CodeCodexGitHub Copilot
出品方月之暗面AnthropicOpenAIGitHub / 微软
默认模型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、GeminiCLI 或桌面端里添加第三方供应商第 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说明
Go49 元468 元(39 元)不含文档、PPT、深度研究、建站
Plus99 元948 元(79 元)含Kimi Code、Agent 集群
Pro199 元1908 元(159 元)含加目标模式、专属 Kimi Claw、更多额度
Max699 元6708 元(559 元)含更多额度、更多并行任务
Ultra1399 元13428 元(1119 元)含额度是 Max 的 2 倍

不同档位能用哪些模型(新套餐 / 老套餐)[官4][官5]

模型模型 ID需要的档位上下文
K3.1 Prok3.1-proPlus / Moderato 及以上Plus 256K;Pro / Allegretto 及以上 1M
K3.1 Pro Highspeedk3.1-pro-highspeedPro / Allegretto 及以上1M,速度约 2~3 倍,消耗约 2 倍
K3k3Plus 及以上同 K3.1 Pro
K3 256Kk3-256kPlus 及以上256K,只能看图不能看视频
K2.8 Previewkimi-for-coding老套餐 Andante 也能用1M
K2.7 Code Highspeedkimi-for-coding-highspeedPro / 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。

  1. 在官方文档「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]。

  2. 第一次启动选界面语言和主题。

  3. 按提示完成 Kimi 账号授权(也可以先跳过,之后点左下角账号区域登录)。中国大陆登录 kimi.com,其他地区登录 kimi.ai。

  4. 新建会话 → 点输入框上方的文件夹名 → 选你的项目文件夹。空会话不选工作区是发不了消息的。

  5. 打开没信任过的文件夹时会问是否信任;选不信任就不能发消息 [官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]。这一步会改变系统的脚本执行策略,自己确认后再做。

第三步:检查有没有装好

  1. 关掉终端,重新打开一个。

  2. 运行 kimi --version,能打印版本号就行 [官2]。用 npm 装的,再看一下 node --version 是不是 22.19.0 以上。

  3. 提示找不到命令,说明安装目录不在 PATH 里。素材 [3] 给的修法(~/.local/bin 加进 PATH)针对的是旧 Python 版,新版脚本装在哪官方没写明,未核实。可以先用 which kimi(macOS/Linux)或 Get-Command kimi(Windows)看看系统找不找得到。

  4. 配置改坏了、启动报错,运行 kimi doctor 检查 config.toml 和 tui.toml 写得对不对,它不会改文件 [4]。

第四步:第一次启动和登录

bash
cd your-project
kimi
图 1 Kimi Code CLI 第一次启动的欢迎界面,提示运行 /login 或 /provider

图源:[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]

  1. 按上面装好新版。

  2. 第一次运行 kimi 时,它会自动发现 ~/.kimi/ 下的旧数据并提示迁移;也可以随时手动运行 kimi migrate。

  3. 选 Config only(只迁配置)或 Config + N sessions(连会话一起迁)。

  4. 迁移内容:config.toml、MCP 配置、输入历史、选中的会话。不迁:登录凭据、MCP 授权、旧插件。迁完要重新 /login,重新授权 MCP。

  5. 旧数据不会被改动或删除,旧版照样能用。迁过来的会话带 [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]。

  1. 去 code.visualstudio.com 下载安装 VS Code,一路下一步 [2]。

  2. File → Open Folder 打开项目文件夹。要选「下一层就是项目文件」的那个文件夹,别选外面套了好几层的,不然 AI 看到的项目不对 [2]。

图 2 打开文件夹时,选中下一层就是项目文件的那个文件夹

图源:[2] 元气万事屋Y《不会写代码:第一次用 Kimi Code 跑通一个项目》

  1. VS Code 自带的 AI 聊天窗口(Agent Chat)弹出来的话,先关掉,避免两个 AI 打架 [2]。

  2. 按 Ctrl+Shift+X(macOS 是 Cmd+Shift+X)打开扩展市场,搜 Kimi Code,认准发布者 moonshot-ai、说明是「Official Kimi Code plugin for VS Code」的那个。市场里有很多名字相近的第三方插件 [2][3]。

图 3 扩展市场里搜 kimi code,认准 moonshot-ai 发布的官方插件

图源:[2] 元气万事屋Y《不会写代码:第一次用 Kimi Code 跑通一个项目》

  1. 装完重启 VS Code。不显示的话,命令面板(Ctrl+Shift+P / Cmd+Shift+P)里执行 Developer: Reload Window [官15]。

  2. 点左侧活动栏里的 Kimi 图标,选登录方式 [2][官15]:

    • Sign in with Kimi Account:浏览器打开授权页,登录后回到 VS Code。

    • Skip:已经配好 API Key 的(比如 CLI 里配过供应商),跳过登录,用 API Key 模式。

图 4 Kimi Code 插件欢迎页:用 Kimi 账号登录,或者跳过、用已有的 API 配置

图源:[2] 元气万事屋Y《不会写代码:第一次用 Kimi Code 跑通一个项目》

  1. 登录成功后面板就绪,底部能看到当前模型 [2]。

图 5 登录成功后的 Kimi Code 面板,左下角是模型选择

图源:[2] 元气万事屋Y《不会写代码:第一次用 Kimi Code 跑通一个项目》

扩展和 CLI 的关系:扩展里内置了 Kimi Code 的运行程序。如果它和 CLI 用的是同一个 KIMICODEHOME,两边共享 config.toml、MCP 配置、登录状态和会话(扩展市场说明,见图 02)[2]。也可以在设置里用 kimi.executablePath 指定自己装的 CLI [官16]。不要在两边同时打开同一个会话,跨进程锁不保证可靠 [2]。

常用设置(VS Code 设置里搜「Kimi」)[官16]

设置项默认作用
kimi.yoloModefalse自动批准所有工具调用
kimi.autosavetrueKimi 读写文件前自动保存
kimi.editorContextnever什么时候把当前文件和光标位置告诉 Kimi:never / onConversationStart / onFileChange
kimi.useCtrlEnterToSendfalse改成 Ctrl/Cmd+Enter 发送
kimi.alwaysExpandThinkingfalse默认展开思考过程
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]。

  1. 确认会员是 Plus / Moderato 或以上(Go 没有编程额度)[官5]。

  2. 打开 Kimi Code 控制台 kimi.com/code/console。

  3. 点 Create API Key(新建 API Key),起个名字确认 [官22]。

  4. 立刻复制保存。完整的 Key 只显示一次,关掉弹窗就再也看不到了。每个账号最多建 5 个 Key [官23]。会员 Key 以 sk-kimi- 开头 [官24]。

图 6 Kimi Code 控制台:上面是用量和权益,下面是 API Keys 列表和创建按钮

图源:[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,加上:

json
{
  "agent_servers": {
    "Kimi Code CLI": {
      "type": "custom",
      "command": "kimi",
      "args": ["acp"],
      "env": {}
    }
  }
}

保存后在 Zed 的 Agent 面板新建对话即可。

JetBrains(IDEA、PyCharm、WebStorm 等):

  1. 没有 JetBrains AI 订阅的,连按两次 Shift 搜「Registry」,打开 llm.enable.mock.response,这样才能打开 AI 聊天面板。

  2. AI 聊天面板菜单里点 Configure ACP agents,加:

json
{
  "agent_servers": {
    "Kimi Code CLI": {
      "command": "~/.local/bin/kimi",
      "args": ["acp"],
      "env": {}
    }
  }
}
  1. 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]

  1. 打开项目文件夹(桌面端在输入框上方选工作区,VS Code 用 Open Folder)。

  2. 看一眼左侧文件目录,确认和你的项目文件夹内容一致。Kimi Code 就在这些文件上干活 [2]。

  3. 先确认左下角的模型。素材 [2] 提醒「模型切换到最新的」,按你的会员档位选(第二节第 1 小节的表)。

  4. 第一个任务先选只读的,比如「介绍一下这个项目」或「总结一下这个项目的目录结构和主要入口文件」[2][官17]。它只读文件、不改东西。

图 7 在 VS Code 里问「这个项目是做什么的」,它读了 README、AGENTS.md、ROADMAP 后回答,并给出下一步选项

图源:[2] 元气万事屋Y《不会写代码:第一次用 Kimi Code 跑通一个项目》

  1. 再给一个修改型任务。官方示例 [官17]:

text
创建一个 hello.py,写一个用 f-string 返回问候语的 greet 函数,
让运行 python3 hello.py 时输出 Hello, Kimi!
  1. 它要改文件或跑命令时会弹审批,看清楚要做什么再批准。第一次用建议权限选「始终询问」[官17]。

  2. 检查结果:桌面端右侧改动面板会出现 hello.py 和改动内容;会话里命令输出 Hello, Kimi!。也可以在底部终端(`Ctrl + ``)自己再跑一次 [官17]。

素材 [2] 的作者总结:记住三件事就够了,项目文件夹要选对、Kimi Code 要登录好、任务要用大白话讲具体。遇到界面和截图不一样,直接问 AI 怎么操作。

2. 用命令行:5 分钟四招 [1]

bash
cd your-project
kimi
  1. 先登录,别急着提需求:/login,会员选 Kimi Code,按量付费选 Platform API Key [1]。

  2. 先生成 AGENTS.md:输入 /init,它会扫描项目,生成一份「写给 AI 看的项目说明书」,写技术栈、目录结构、启动方式、测试命令和代码规范。素材 [1] 的说法:「你现在多写 5 分钟,后面能少解释 50 分钟。」

  3. 用 @ 锁定文件:别问「限流逻辑在哪」,问「@src/middleware/rate_limit.py 这里的滑动窗口算法有没有漏洞?」。@ 会补全项目里的文件路径,选中后它直接读这个文件 [1][4]。

  4. 改代码前先看 diff:比如「把用户注册接口改成邮箱验证码 + 密码双因子认证,并添加防暴力破解机制」。它会先分析影响范围、展示 diff,你可以接受、拒绝或追问「这个字段为什么要加」[1]。

复杂任务先进计划模式:按 Shift-Tab 或输入 /plan,或者用 kimi --plan 启动。它会先出方案,你确认后才改文件 [4][官12]。

3. 一个完整案例:搭企业行政系统的框架 [8]

素材 [8] 的作者是半路出家的程序员,用 Kimi Code 在 VS Code 里搭了一个行政管理系统的框架。值得学的是他的提问方式:

  1. 先让 AI 推荐技术架构,最后选了 FastAPI + Vue 的全栈 Python 方案。

  2. 把需求和附件(行政同事的工作清单)发给 Kimi Code,结尾加一句:「请先说下你对我需求的理解,看下还有没有什么需要补充,或者让我确认的地方。」

图 8 Kimi Code 先复述需求、给出技术架构建议,等用户确认

图源:[8] 坐等AI替我上班《使用Kimi Code开发企业级项目》

  1. 回答它提的问题,直到双方都没疑问,它才开始编码。

  2. 大约 20 分钟后交出阶段性结果:后端框架、RBAC 权限 7 大模块、前端框架、Docker 部署配置,共改动 70 个文件、新增 3012 行。

图 9 阶段性成果清单,底部显示 70 个文件改动

图源:[8] 坐等AI替我上班《使用Kimi Code开发企业级项目》

  1. 作者没用它给的 Docker Compose,而是在 WSL 的 Ubuntu 里自己装 Python 3.12、Node.js,建虚拟环境、装依赖,起数据库、后端和前端,浏览器打开就能访问 [8]。

注意:它自动生成的初始账号是 admin / 123456 这种弱口令(见图 09),正式用之前一定要改。

4. 不写代码也能用:本地生成 PPT [9]

素材 [9] 的思路是「ChatGPT 负责想清楚,Kimi Code 负责做出来」:

  1. 先和 ChatGPT 聊清楚 PPT 的叙事逻辑,再让它输出一份详细的制作提示词:多少页、每页讲什么、字体字号、颜色、图片占比、禁止项,甚至「案例资料不足时不能编故事」。

  2. 把整份提示词交给 Kimi Code,告诉它素材文件夹在哪。

  3. 它读要求、读素材、把旧 PPT 拆开取图、按 16 页结构整理,最后写 Python 代码生成 .pptx,还会自己校验页数和图片有没有放对。

图 10 Kimi Code 生成 PPT 后自检,列出每页实现情况和需要人工确认的三件事

图源:[9] AI简学笔记《Kimi好用但太贵,我改用Kimi Code做PPT》

素材 [9] 的作者问过它能不能直接调 Kimi Work 的 PPT 工具,它查了一下说不能,但可以在本地直接生成。

5. 新手入门顺序建议 [4]

  1. 先掌握「安装登录 → kimi 启动 → 对话 → 常用斜杠命令」。

  2. 弄懂三种权限模式的区别(第五节),熟了再开自动模式。

  3. 拿个小项目反复试 /init、/plan、kimi -c。

  4. 记不住就 kimi --help、kimi <子命令> --help、会话里 /help,比碎片教程准。

  5. 启动报错先 kimi doctor。

  6. 先写小脚本、改 bug,再做大重构。

  7. 别怕出错:/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]:

toml
[[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]。

图 11 桌面端会话右键菜单里的「分叉会话」

图源:[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,官方没写清,未核实。

图 12 桌面端输入框的「+」菜单:文件、截屏、目标、计划、Swarm、Tower

图源:[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]

bash
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]:离开电脑后用手机看进度、批审批、追加指令。

  1. 本机运行 kimi rc(或在会话里输 /remote-control,或 kimi web --remote-control)。桌面端在「设置 → 远程控制」里开 [官28]。

  2. 终端会打印访问链接(形如 https://code-rc.kimi.com/devices/<设备 ID>/,海外是 code-rc.kimi.ai)和二维码,手机扫码。

  3. 用同一个 Kimi 账号登录,选这台机器,就能看会话、发任务、批审批、中断任务。

  • 需要付费会员;本机要保持开机、联网、不休眠。桌面端 v1.2.0 起有「防止休眠」开关(设置 → 通用)[官28]。

  • 一台机器同时只能开一个实例,每个账号约 3 台设备。

  • 链接等于这台电脑的遥控器,别发给别人或贴到公开地方。

  • 所有计算和文件操作都在本机,网页只是远程窗口。

图 13 远程控制:在手机上查看本机 Agent 的进度、改动文件和后台任务

图源:[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协议典型用途配置里的凭证键名
kimiOpenAI 兼容Kimi Code 托管服务、Kimi 开放平台 KeyKIMIAPIKEY、KIMIBASEURL
anthropicAnthropic MessagesClaude 系列ANTHROPICAPIKEY、ANTHROPICBASEURL
openaiOpenAI Chat CompletionsOpenAI 及兼容服务,DeepSeek、Qwen 等OPENAIAPIKEY、OPENAIBASEURL
openai_responsesOpenAI Responses APIOpenAI 新接口同上
google-genaiGoogle GenAIGeminiGOOGLEAPIKEY
vertexaiVertex AIGoogle 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]

  1. 会话里输入 /provider。

  2. 在 [ Add New Platform ] 行按 Enter。

  3. 选 Known third-party provider:从公开模型目录 models.dev 里选供应商 → 粘贴 API Key → 选默认模型。网络访问不了目录时,会用内置的快照。

  4. 或者选 Custom registry:填自定义的模型目录地址(公司内部网关常用)。

  5. ↑↓ 移动,d 删除,/provider refresh 刷新模型列表。

用 /login 登录的 Kimi 会员账号不在 /provider 里显示,用 /login、/logout 管 [官7]。

方式 B:命令行(适合脚本化部署) [4]

bash
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 请从开放平台文档复制:

toml
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、通义),把地址和模型名换成平台文档给的:

toml
[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]:

toml
[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]

bash
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"
kimi

Windows 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 配完怎么验证

  1. 新开终端,运行 kimi,输入 /status 看当前模型是不是你配的 [4]。

  2. /model 切到这个模型,发一句「你好」。

  3. /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/v1https://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 / xhighmax
high / mediumhigh
low / minimum / lightlow
off / none / disabledK3.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),文件不存在就新建:

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:

bash
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
claude

Windows PowerShell:

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 官方,鉴权失败
ANTHROPICAPIKEYKimi 会员 Key。Kimi 用的是这个变量,不是 ANTHROPICAUTHTOKEN401
ANTHROPIC_MODEL主对话模型用 Claude 默认模型名,报模型不存在
ANTHROPICDEFAULTOPUS/SONNET/HAIKU/FABLE_MODELClaude 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]:

  1. 先按方式一写好 settings.json(插件和命令行共用 ~/.claude 的配置)。

  2. 插件新建会话,在登录页点底部的 Run claude in terminal。

  3. 在弹出的终端里依次选 Yes, I trust this folder 和 API Key 确认的 1. Yes。

  4. 完全退出 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]

  1. 安装:curl -fsSL https://opencode.ai/install | bash,或 npm install -g opencode-ai。

  2. 运行 opencode auth login,供应商列表里选 Kimi For Coding,粘贴会员 Key。

  3. 启动 opencode,输入 /models,在 Kimi For Coding 下面选模型。

  4. 选 K3.1 Pro、K3、K2.8 Preview 的,用 /variants 选思考档位:Default / low / high(推荐)/ max。

9.4 Codex [官24]

  1. 安装 Codex CLI:npm install -g @openai/codex。

  2. 新建 ~/.codex/models.json(Windows:C:\Users\你的用户名\.codex\models.json),声明 k3.1-pro 和 k3.1-pro-highspeed 两个模型(上下文 1048576,思考档位 low/high/max,默认 high)。完整内容见 [官24]。

  3. 编辑 ~/.codex/config.toml:

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"。

  1. 设置 Key:

系统命令
macOSecho 'export KIMIAPIKEY="sk-kimi-你的key"' >> ~/.zshrc 然后 source ~/.zshrc
Linuxecho 'export KIMIAPIKEY="sk-kimi-你的key"' >> ~/.bashrc 然后 source ~/.bashrc
Windowssetx KIMIAPIKEY "sk-kimi-你的key",然后重开终端
macOS 上的 Codex 桌面 App额外运行 launchctl setenv KIMIAPIKEY "sk-kimi-你的key",Cmd+Q 完全退出再打开;重启电脑后要重新执行
  1. 进项目目录运行 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]

  1. 设置 Key:export KIMIAPIKEY="sk-kimi-你的会员Key"。长期生效就加进 ~/.zshrc 或写进 ~/.hermes/.env。

  2. 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]。

  3. base_url 只填到 /coding/v1,Hermes 会自己加 /chat/completions。

9.6 Kimi 模型 API 常见报错 [官27]

报错关键词状态码原因和处理
The API Key appears to be invalid or may have expired401Key 输错、过期或被撤销;或者有旧的 KIMIAPIKEY / OPENAIAPIKEY 环境变量盖掉了配置
Invalid Authentication401最常见:把开放平台的 Key 或地址和会员的混用了
Your current subscription does not have access to k3.1-pro403档位不够,K3.1 Pro 要 Plus 及以上
Your current plan supports only k3.1-pro up to 256K context4031M 上下文要 Pro 及以上,换回 256K 配置
unable to verify your membership benefits403会员过期,或稍后重试
You've reached your 5-hour usage limit4295 小时限额到了,等窗口滚动或买加油包
You've reached your weekly (7-day) usage limit429老套餐的周限额
You've reached your monthly usage limit429月度额度池用完
You've reached your concurrent request limit429并发太多,比如多个工具同时跑
Your model id does not exist400模型 ID 写错
Your request exceeded model token limit: 262144400上下文超了,压缩或调小窗口设置
K3.1 Pro does not support disabled thinking mode400把思考打开

用第三方工具时,错误码可能被工具改写过,以报错文字为准对照 [官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]。

  • 格式:

json
{
  "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]。

图 14 内置浏览器的设备尺寸预设

图源:[6] 月之暗面 Kimi《Kimi Code 这样用,事半功倍》

查阅对比多份技术文档、从多个公开页面收集信息写调研报告、核对设计稿和实际页面,也能用这两个功能 [6]。

12. 进阶场景:改 Godot、Blender 等 3D 和游戏工程 [10]

11 月 2 日,月之暗面发布了「Kimi 游戏开发与创意工作解决方案」,说 Kimi 可以通过插件和工具调用连上 Blender、Unity、Unreal 等软件,直接改已有工程 [10]。

图 15 九个专业软件分别从哪个入口用:Work 是 Kimi Work 客户端,Code 是 Kimi Code

图源:[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] 实测的路线)

  1. 装好命令行版,进工程目录运行 kimi,/login 登录。

  2. 在提示词里告诉它引擎装在哪。它会自己用 Godot 命令行跑游戏,用 Blender 的后台模式改文件、出渲染图,不装插件也行。

  3. 想接社区 MCP,用 /mcp-config 添加,或写进工程目录的 .kimi-code/mcp.json。

  4. 第一次先让它只读不改。素材 [10] 实测过的提示词:

text
这是一个 Godot 4 项目。先不要改任何文件:
列出场景树、主要脚本和调用关系,
告诉我"角色受伤闪红"该改哪几个文件。
等我确认再改,改完运行一次截图给我。
图 16 Godot 实测:第一步只读画出场景树,确认后只改 1 个文件、加 13 行,自己跑游戏录帧验证

图源:[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]。

图 17 它说「检查通过」,实际台灯周围几乎没变化;指出后它一步步排查出原因

图源:[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 桌面端。


六、参考原文

#标题(链接)公众号发布用到的内容用图
1Kimi Code上手5分钟未哥AI智能体2026-05-29新版安装命令、四招(登录、/init、@ 引用、看 diff)、适用场景、安全提醒—
2不会写代码:第一次用 Kimi Code 跑通一个项目元气万事屋Y2026-07-20VS Code 扩展完整流程、选文件夹、登录、控制台截图02、03、04、05、06、07
3Kimi Code 完全指南:国产AI编程Agent的安装与使用技巧赛博搬砖指南2026-04-27发布时间、定位、多模态用法、执行策略修复。安装方法已过时,配置示例疑似编造,只采用通用内容并标 ⚠️—
4从会用到好用 | Kimi Code 命令新手手册:小白可直接上手的基础命令汇总芯智荟2026-07-17安装、登录两种方式、启动参数、会话管理、斜杠命令、快捷键、provider、doctor、学习建议(按 0.26.0 核对,权限模式说法已过时)—
5Kimi Code CLI保姆级教程:GitHub 15.6k星的免费AI编程Agent,5分钟0成本上手知否0072026-07-24能力概述、5 个场景、ACP 集成。推荐旧 Python 版、「免费」说法不准,标 ⚠️—
6Kimi Code 这样用,事半功倍月之暗面 Kimi(官方号)2026-11-02内置浏览器与截屏框选、远程控制 + Goal + 后台任务、Fork(文末有评论区送周边活动)11、12、13、14
7Kimi Code Cli效果惊艳到了我,分享一些使用的指南和小技巧小白部署不输2026-06-30首次启动界面、/goal 四要素、/swarm、session 恢复;Skills 目录写法不准,标 ⚠️01
8使用Kimi Code开发企业级项目坐等AI替我上班2026-04-17先让它复述需求的提问法、行政系统框架案例、本地部署流程08、09
9Kimi好用但太贵,我改用Kimi Code做PPTAI简学笔记2026-09-05「先想清楚再执行」的 PPT 工作流10
10Kimi 能直接改你的游戏工程了:我用 Kimi Code 实测了 Blender 和 Godot米花的ai学习2026-11-033D/游戏方案的入口、Godot 和 Blender 实测、验证盲区、价格、注意事项15、16、17

10 篇全部采用,没有剔除的文章。00_清单里说明已在采集阶段剔除了一篇借教程推第三方 API 中转的文章。

官方文档补充(2026-11-07 查阅;除注明外,均为 Kimi Code 官方文档 https://www.kimi.com/code/docs/ 下的页面)

编号页面(链接)用到的内容
官1产品概览产品定义、四种入口、安装命令
官2CLI:开始使用系统要求、各平台安装命令、Windows 注意、登录、升级与卸载
官3CLI:从 kimi-cli 迁移Python 版停止维护、kimi migrate 迁移内容
官4会员权益新老套餐档位、额度规则、加油包、设备解绑
官5模型配置模型 ID、上下文、思考档位换算、接口地址、ID 写错的后果
官6Kimi 帮助中心:会员价格Go/Plus/Pro/Max/Ultra 价格(2026-10-19 截图)和权益
官7CLI:平台与模型供应商类型、/provider 用法、各协议配置示例
官8CLI:配置文件config.toml 结构、providers/models 字段、权限规则、hooks
官9CLI:环境变量Key 不从 shell 读取、KIMI_MODEL_*、KIMI_CODE_HOME、遥测开关
官10CLI:数据路径~/.kimi-code/ 目录结构、自动更新开关、全局 AGENTS.md
官11CLI:kimi 命令启动参数、冲突规则、非交互模式、kimi login
官12CLI:交互与输入三种权限模式、计划模式、Shell 模式、目标模式、媒体粘贴
官13CLI:斜杠命令/swarm、/tower、/reload、/import-sessions、内置 Skill 等
官14CLI:在 IDE 中使用Zed、JetBrains 的 ACP 配置和排查
官15VS Code:快速开始两种认证模式、快捷键、常见问题
官16VS Code:配置kimi.* 设置项
官17Desktop:快速开始系统要求、安装、登录区域、接第三方供应商、首个任务、kimi app
官18Desktop:常见问题与故障排除安装包选择、官方模型不可用、导出诊断信息
官19CLI:远程控制kimi rc、使用条件、设备限制、安全提醒
官20CLI:Model Context Protocolmcp.json 位置和格式、工作区信任、CI 下的处理
官21CLI:Agent SkillsSkill 文件格式、存放目录和优先级
官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欢迎界面.pngCLI 首次启动界面(0.19.2 版),提示 /login 或 /provider[7] 第 2 张
images/02-VSCode扩展市场.pngVS 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.pngKimi 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-九个专业软件入口.png9 个 3D/游戏软件分别走 Kimi Work 还是 Kimi Code[10] 第 1 张(作者整理图)
images/16-Godot只读后再改.pngGodot 实测:先只读、再修改、自己验证[10] 第 5 张
images/17-验证盲区排查.pngBlender 实测里的验证盲区和排查过程[10] 第 8 张
更新于 2026-11-07来源:用户提供《工具指南_完整全套_含所有MD与图片.zip》;正文保留原文参考来源