Kimi Code 有三条使用路径:终端里的 CLI、VS Code 插件、桌面端,三者共用一份会员额度。最短的是装好 CLI 敲 kimi,输入 /login 登录,然后直接用自然语言说任务。前提是会员档位够——新套餐 Plus 及以上才能用,Go 档没有 coding 额度。 Kimi Code是什么,和开放平台有什么区别
它是 Kimi 会员权益里面向开发者的智能编程服务,不单独售卖。客户端有几个:终端里的 CLI、VS Code 插件、桌面端,另外能接进 Claude Code、Codex、OpenCode 这类第三方工具。这些入口发出去的请求,都算在同一个额度池里。 容易搞混的是它和「Kimi 开放平台」的关系。这是两套并行系统,计费、Base URL、Key 的创建入口全不一样:
| | |
|---|
| | |
| https://api.kimi.com/coding/v1 | https://api.moonshot.cn/v1 |
| https://api.kimi.ai/coding/v1 | https://api.moonshot.ai/v1 |
| | |
| https://www.kimi.com/code/docs | https://platform.kimi.com/docs |
两套 Key 不通用。开放平台的 Key 填进去,或者反过来,都会认证失败。官方 FAQ 专门把这条拎出来讲,踩的人不少。
还有一点。Kimi 会员套餐 2026 年改过版,新老档位名称完全不同:新版用 Plus / Pro,老版是 Moderato / Allegretto 这套音乐术语。查资料时看到「Allegretto 才能用 1M 上下文」这种说法,那是写给老套餐的,新套餐对应的是 Pro 及以上;老套餐里连 K3.1 Pro 的基本调用都要 Moderato。
安装Kimi Code CLI:脚本方式最省事
CLI 用 TypeScript 写,走 npm 分发,跑在 Node.js 上。装法两条,官方推荐脚本那条,省掉预装 Node.js 的麻烦。
方式一:官方安装脚本
脚本会拉最新版、校验 checksum,把 kimi 写进 PATH。装完敲 kimi --version 确认一下。
Windows 要多做一步,先装 Git for Windows,CLI 拿它的 Git Bash 当 Shell。Git Bash 装在非标准路径的话,把 KIMI_SHELL_PATH 指到 bash.exe 的绝对路径。
方式二:npm 全局安装
这条要求 Node.js 22.19.0 以上,版本不够直接报错。先 node --version 看一眼。
CLI 是全交互式 TUI,终端最好支持真彩色和连字,Kitty、Ghostty 这类观感更完整。系统自带终端也能跑,只是粗糙点。
首次登录:/login 怎么选平台
进项目目录直接敲 kimi,首次启动会要求配置 API 来源。/login 弹出的平台选择器里有两种授权方式:
- Kimi Code(OAuth):验证码流程。在任意设备打开弹出的链接,登录后把验证码填回去就授权好了,不用碰 API Key。
- Kimi Platform API 密钥:填入在 platform.kimi.com 或 platform.kimi.ai 创建的 Key。
选择器里选哪个平台,必须和 Key 的实际来源一致,否则校验必失败。官方文档把这条标成了警告。
登录后会读当前账户可用的模型让你挑。选完的配置会存下来,下次启动不用重配。换模型用 /model,换账号走 /logout 再 /login。
想知道通没通,敲 /status 看会话状态,再发一句「帮我看一下这个项目的目录结构」。能正常回话就是通了。
六个核心模型与档位门槛
目前给 6 个模型,按 Model ID 区分。写配置或填第三方工具时用 ID,写「K3.1 Pro」这种版本名会被兜底到无思考版的 K2.8 Preview。
| | | | | |
|---|
| | | | | Moderato 可用,Allegretto 解锁 1M |
| | | | | |
| | | | | Moderato 可用,Allegretto 解锁 1M |
| | | | | |
| | | | | |
kimi-for-coding-highspeed | K2.7 Code 高速版(约 6 倍速,3 倍消耗) | | | | |
几个容易翻车的点。K3.1 Pro 系列只支持思考模式,传 none 或 disabled 会被 400 拒掉。k3 和 k3-256k 是同一个模型的两个上下文版本,官方标注 1M 版的消耗约为 256K 版的两倍,上下文够用就别硬上 1M。高速版确实更快,可它只加速模型输出,读写文件、执行命令这些工具耗时一点没变,脚本任务占大头时提速很难感知。
省钱上有个细节:在历史会话里来回切模型或切思考档位,已有上下文缓存会失效,重新预填充又是一笔 token。要换就在新会话里换。
额度怎么算,超了怎么办
编码额度和 Kimi 会员的月总额度绑在一起,所有登录设备和 API Key 共用一份配额。新套餐取消了周额度,只留每 5 小时的滚动窗口;老套餐还是每 7 天刷一次,没用完不累积。
月额度打满后 coding 额度会冻结,只能等重置或升级。这时有两个选择:等,或者开加油包。加油包只有订阅会员能开,网页版 Kimi 和 Kimi Code 共用同一份余额,费率接近开放平台的按量价格,用量大时升级订阅更划算。单次最低充 25 元,每日最多 10 次、累计 3000 元,余额上限 1 万元。
查用量:CLI 里敲 /usage,或者进 Kimi Code 控制台看剩余额度和频限状态。超过 30 天没活跃的设备会自动解绑,重新 /login 就回来了。
配置文件与常用命令
长期偏好写在 ~/.kimi-code/config.toml,首次运行自动生成。数据目录想搬走,用 KIMI_CODE_HOME 指过去。字段名一律 snake_case,名字带 . 的要用引号包住,比如 [models."gpt-4.1"]。
接非 Kimi 的供应商也在这份文件里改。providers 表的 type 决定用哪套协议:kimi 走 OpenAI 兼容、anthropic 走 Anthropic Messages、openai 走 Chat Completions、openai_responses 走 Responses、google-genai 和 vertexai 走 Google 那两套。不想手写 TOML 就在 TUI 里敲 /provider,加删都在管理器里点。
命令分两类。终端里的 kimi 管启动和批处理,TUI 里的斜杠命令管会话内操作。
| |
|---|
| |
| |
| 非交互跑一次,结果直接写到 stdout,适合塞进脚本 |
| |
| |
| |
会话里最该先记住的几个:/new 清空开新会话、/model 换模型、/compact 压缩上下文、/init 扫代码库生成 AGENTS.md、/sessions 翻历史会话、/help 看全部命令。Shift-Tab 切 Plan 模式,Ctrl-C 中断,连按两次退出。
--yolo 和 --auto 会跳过文件写入和 Shell 命令的人工确认,只在受信任的目录里用。Plan 模式的退出审批不受影响,不会被跳过。
用起来之前先确认这六条
- 两个平台的 Key 别混用:会员体系和开放平台的 Key、Base URL、计费各自独立,混填必认证失败。
- 模型要填 ID 不填名字:写 k3.1-pro,别写「K3.1 Pro」,写错会静默兜底到 K2.8 Preview 无思考版。
- 403 多半是档位不够:能登录不等于能用某个模型,1M 上下文和高速版都有单独的档位门槛。
- 不要在旧会话里换模型:缓存失效要重新预填充,白烧 token,还可能让不同模型的思维链互相干扰。
- K3.1 Pro 关不掉思考:传 disabled 直接 400,想省钱就降 effort 到 low,别想关掉。
- 慎用 --yolo 和 --auto:跳过审批意味着文件写入和 Shell 命令不再问你,只在自己信任的目录里开。
常见报错与排查方法
报错分两类,模型调用错误和工具调用错误,来源不同,处理方式也不同。第三方客户端可能把错误码重新包装过,官方建议以报错文字为主去匹配关键词。
看懂 HTTP 码的分工能省一半排查时间:401 是凭证没过,不用重试,先把 Key 和 Base URL 修对;403 是身份过了但档位不够,官方原话是重试无意义,只能升级订阅或改请求;429 是配额和并发问题,等或者充值;400 是请求本身写错了。
| | |
|---|
The API Key appears to be invalid or may have expired | | Key 失效或填错。还要查一下 KIMI_API_KEY / OPENAI_API_KEY 环境变量有没有把配置文件里的 Key 覆盖掉 |
Your current subscription does not have access to k3.1-pro | | |
supports only k3.1-pro up to 256K context | | 档位解锁了模型但没解锁 1M,先 compact 压到 256K 内 |
unable to verify your membership benefits | | |
You've reached your 5-hour usage limit | | |
You've reached your monthly usage limit | | |
Your model id does not exist, recognized as other | | |
total message size exceeds limit 2097152 | | 请求体积超 2MB,先 /compact 或拆任务 |
thinking is enabled but reasoning_content is missing | | 多轮里丢了思考内容,把 reasoning_content 一并回传 |
The engine is currently overloaded | | |
客户端本身的问题归另一类。CLI 装不上、IDE 连不上、MCP 配错,这些去 FAQ 里查。/login 时提示「No models available for the selected platform」,通常是 Key 和所选平台对不上,或者网络到不了 api.kimi.com。
/login 只能在空闲状态执行。正在生成或跑任务时会拦下来,先按 Esc 或 Ctrl-C 中断再试。
VS Code、桌面端与第三方工具怎么接
不太用终端的话,VS Code 插件上手最快。在 Marketplace 搜装,重启窗口生效。认证有两种:点登录按钮走浏览器授权,或者直接跳过登录用 API Key 模式,齿轮图标随时切换。装好后 Ctrl+Shift+K(Mac 上是 Cmd+Shift+K)聚焦输入框,用 @ 引用文件或文件夹,改完在 diff 视图里逐块批准或回退。
桌面端从 kimi.com/code 下载,输入框里有模型选择器,粘贴图片前记得在设置里开「粘贴图片自动提及」。
接第三方工具得在控制台建 Key,再填 Base URL 和模型 ID。协议支持 OpenAI 的 Responses、Chat Completions,也支持 Anthropic 兼容,用哪个地址看工具吃哪套协议:
| | |
|---|
OpenAI(Responses / Chat Completions) | https://api.kimi.com/coding/v1 | https://api.kimi.ai/coding/v1 |
| https://api.kimi.com/coding/ | https://api.kimi.ai/coding/ |
支持 Responses API 的工具优先走原生 Responses,用代理做协议转换容易让效果抖。Claude Code、Codex、OpenCode 这几个官方都出了分步接入文档,照着填就行。 Kimi Code 常见问题
Q:免费能用吗?
A:不单独收费,但需要会员。新套餐 Go 档没有 coding 额度,Plus 及以上才能用;老套餐要 Andante 及以上。
Q:不装 CLI 能直接用吗?
A:能。VS Code 插件和桌面端都能用,认证方式和 CLI 一样,走账号授权或 API Key 都行。
Q:会员额度和开放平台的 API 额度能互通吗?
A:不能。会员额度只服务于这套官方客户端,开放平台按量计费,余额和 Key 互不相干。
Q:为什么登录成功却提示用不了 k3.1-pro?
A:登录只验证账号,模型权限看档位。K3.1 Pro 要 Plus 及以上,1M 上下文要 Pro 及以上,高速版也要 Pro。
Q:能不能接 Claude Code 或 Codex?
A:可以。在 Kimi Code 控制台建 Key,把 Base URL 填成 https://api.kimi.com/coding/(Anthropic 协议),模型填 k3.1-pro 之类的 ID。
Q:老套餐要不要升级到新套餐?
A:不强制。老套餐继续可用,档位、额度、自动续费都维持原样。新套餐取消了周额度,改用 5 小时滚动窗口。
Q:装在 Windows 上报错找不到 bash?
A:先装 Git for Windows,CLI 靠它的 Git Bash 当 Shell。装在非默认路径的话,设 KIMI_SHELL_PATH 指向 bash.exe 的绝对路径。
Q:怎么把 Claude Code 的历史会话搬过来?
A:用 /import-sessions 或 kimi import-sessions,支持导入最近 15 天或 30 天的 Claude Code 和 Codex 会话。
模型、档位和价格调整得比较勤,正式使用前建议在 Kimi Code 控制台确认一遍当期规则。Kimi Code 后续有新版本或新模型上线,本站会跟着更新。