Kimi Cookbook

This chapter is available in Chinese only. The content below has not been translated.

— 08 / 第八章

写码 & 接 API · 把 Kimi 配进你的 Agent.

Kimi Code 已支持 K3.1 Pro, 开放平台也原生支持 OpenAI Responses; Codex 现在可以直连, 不再必须经过 CC-Switch。这章按 2026 年 10 月的官方文档重核最小配置、模型 ID 与账户边界。

12 分钟 · 发布 2026.06 · 更新 2026.10

MD海报
如果你完全不碰代码, 这章可以跳过 —— 这正是我把它单拎出来的原因。 这一章我给开发者摆三道门: 一道是 Kimi Code, 跑在终端、对标 Claude Code 的第一方编码 agent; 一道是开放平台 API —— OpenAI Chat Completions / Responses 与 Anthropic Messages 三种兼容格式, 改几行配置就能把已经在用的 agent 接过来; 还有一道是可选的 CC-Switch, 把多套供应商配置收进一个面板。「国内可达 + 多协议 + 开放权重」这三样, 对国内开发者仍是少有的顺。

— I

Kimi Code 是第一方的终端 agent.

它不是在聊天里贴代码, 是直接进你的仓库改 —— 读文件、跑命令、提改动。 Kimi Code 是跑在终端里的命令行工具, 对标 Claude Code: 它在你的项目目录里直接读多个文件、跑命令、改文件, 一个完整的「改、跑、看、再改」循环, 不用你在浏览器和编辑器之间来回搬。1注 1Kimi Code CLI 官方文档 —— macOS / Linux 可用官方安装脚本或 npm install -g @moonshot-ai/kimi-code（Node.js ≥ 22.19.0）; /login 支持 Kimi Code（OAuth）会员授权与 Kimi Platform API 密钥。复核于 2026-10。模型列表现在是 K3.1 Pro（及高速版）、K3（及 256K 版）、K2.8 Preview 和 K2.7 Code Highspeed; 官方客户端用 /model 切换, 第三方工具要填对应模型 ID, 不要把显示名称当 ID。18注 18Kimi Code 官方文档 · 模型配置 —— 当前提供 k3.1-pro / k3.1-pro-highspeed / k3 / k3-256k / kimi-for-coding（K2.8 Preview）/ kimi-for-coding-highspeed。新套餐 Plus 起可用 K3.1 Pro 与 K3, Pro 起解锁高速版与 1M 上下文; 旧套餐对应 Moderato / Allegretto 门槛。K3.1 Pro 仅支持思考, reasoning_effort 为 low / high / max。复核于 2026-10。 
# 官方脚本
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
 
# 或 npm(需 Node.js ≥ 22.19.0)
npm install -g @moonshot-ai/kimi-code
 
kimi --version   # 验证

安装 Kimi Code CLI(macOS / Linux 二选一;Windows 用官方 PowerShell 脚本, 见文档)

装完用 /login 登录, 两条路任选: 会员 OAuth(走你的 Kimi 会员订阅额度)或 开放平台 API Key(走按量计费)。1注 1Kimi Code CLI 官方文档 —— macOS / Linux 可用官方安装脚本或 npm install -g @moonshot-ai/kimi-code（Node.js ≥ 22.19.0）; /login 支持 Kimi Code（OAuth）会员授权与 Kimi Platform API 密钥。复核于 2026-10。会员那条的模型与上下文按档位解锁: 新套餐 Plus 起可用 K3.1 Pro / K3, Pro 起解锁高速版与 1M 上下文; 旧套餐对应 Moderato / Allegretto 门槛。新套餐取消 Code 周限额, 新旧套餐都有滚动 5 小时窗口并受月度共享池限制。18注 18Kimi Code 官方文档 · 模型配置 —— 当前提供 k3.1-pro / k3.1-pro-highspeed / k3 / k3-256k / kimi-for-coding（K2.8 Preview）/ kimi-for-coding-highspeed。新套餐 Plus 起可用 K3.1 Pro 与 K3, Pro 起解锁高速版与 1M 上下文; 旧套餐对应 Moderato / Allegretto 门槛。K3.1 Pro 仅支持思考, reasoning_effort 为 low / high / max。复核于 2026-10。要记牢的是: 会员 coding 端点(api.kimi.com/coding)与开放平台(api.moonshot.cn)是两个完全独立的账号体系, Key 互不通用 —— 加上开放平台内部还分国内 / 国际两套, Kimi 一侧其实有三套账户, 配错哪一个都是 401。2注 2Kimi 帮助中心 · Kimi Code —— 会员专用端点为 OpenAI 兼容 https://api.kimi.com/coding/v1 与 Anthropic 兼容 https://api.kimi.com/coding/, 走会员订阅额度; api.kimi.com 与 api.moonshot.cn 是独立账号体系, API Key 互不通用。

— II

拿 Key 与三种协议格式(地基).

所有接法都从同一块地基开始: 一个 Key、三种兼容格式。先把地基打对, 后面每个 agent 都只是填空。 先去控制台建 Key: 国内在 platform.kimi.com(人民币, 微信 / 支付宝充值), 国际在 platform.kimi.ai(美元)。两套账户与 Key 完全独立, 混用直接 401 —— 官方 FAQ 的原话是「不能混用」, 这也是接入失败最常见的原因。3注 3Kimi 开放平台 · 快速开始与常见问题 —— 国内控制台 platform.kimi.com 与国际控制台 platform.kimi.ai 的账户和 Key 完全独立, 混用会报 401; 国内与海外应使用各自端点。 同一个 Key, 对应三种兼容格式。OpenAI Chat Completions 与 OpenAI Responses 共用国内 https://api.moonshot.cn/v1、国际 https://api.moonshot.ai/v1, 分别请求 /chat/completions 和 /responses; 鉴权都是 Authorization: Bearer, 官方惯用环境变量 MOONSHOT_API_KEY。4注 4Kimi 开放平台 · API 总览 —— 当前兼容三种格式: OpenAI Chat Completions（/v1/chat/completions）、OpenAI Responses（/v1/responses）与 Anthropic Messages（/anthropic/v1/messages）; 国内 base_url 分别为 https://api.moonshot.cn/v1 与 https://api.moonshot.cn/anthropic, 鉴权为 Authorization: Bearer。复核于 2026-10。Anthropic Messages 则用国内 https://api.moonshot.cn/anthropic、国际 https://api.moonshot.ai/anthropic。Codex 走原生 Responses, Claude Code 走 Anthropic, 都不需要协议转换。 
# 控制台: https://platform.kimi.com/console/api-keys
export MOONSHOT_API_KEY="YOUR_KIMI_API_KEY"
# OpenAI 兼容
export OPENAI_BASE_URL="https://api.moonshot.cn/v1"
# Anthropic 兼容(给 Claude Code 系用)
export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"
# 控制台: https://platform.kimi.ai/console/api-keys
export MOONSHOT_API_KEY="YOUR_KIMI_API_KEY"
# OpenAI 兼容
export OPENAI_BASE_URL="https://api.moonshot.ai/v1"
# Anthropic 兼容(给 Claude Code 系用)
export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"

两套账户速查: Key 在哪建, 就用哪套端点(占位符 YOUR_KIMI_API_KEY 换成你的 Key)

地基里还埋着一个限速坑: 速率按账户累计充值分档, 并发、RPM、TPM、TPD 与联网搜索 QPS 都可能成为瓶颈, 代金券不计入累计充值。别把旧教程里的某个 tier 数字当永久配置; 接入前看官方当前表格, 上线后在真实请求里处理 429 并做指数退避, SDK 自动重试也会消耗速率额度。5注 5Kimi 开放平台 · 充值与限速 —— 速率按账户累计充值为档位, 代金券不计入累计充值; 实际并发、RPM、TPM、TPD 与联网搜索 QPS 以当前表格为准。复核于 2026-10。

— III

把 Key 配进你已经在用的 agent.

我按「官方文档写得有多明白」给它们排序, 每个附一份最小可用配置, 注意事项跟在配置后面。

#Claude Code(Anthropic 兼容, 官方有指南).

这是官方文档写得最全的一条: 把 ANTHROPIC_BASE_URL 指到 Kimi 的 Anthropic 兼容端点、用 ANTHROPIC_AUTH_TOKEN 鉴权, Claude Code 就把 Kimi 当后端。6注 6Kimi 开放平台 · 在 Claude Code 中使用 Kimi —— 当前示例将主模型与 OPUS / SONNET / FABLE 配为 kimi-k3[1m], HAIKU 配为 kimi-k2.7-code, 并设置 CLAUDE_CODE_SUBAGENT_MODEL、CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000 与 CLAUDE_CODE_EFFORT_LEVEL=max; 当前指南不再要求 ENABLE_TOOL_SEARCH=false。settings.json 的 env 会覆盖 shell 同名变量, 修改后需重启。复核于 2026-10。两个变量名别搞混 —— ANTHROPIC_AUTH_TOKEN 走 Authorization: Bearer 头, ANTHROPIC_API_KEY 走 X-Api-Key 头; 两者同时存在会冲突, 之前配过 ANTHROPIC_API_KEY 的先删掉。7注 7Anthropic 官方文档 · Claude Code 环境变量 —— ANTHROPIC_AUTH_TOKEN 走 Authorization: Bearer 头, ANTHROPIC_API_KEY 走 X-Api-Key 头, 二者同时存在会冲突; 旧 ANTHROPIC_SMALL_FAST_MODEL 已由各档位模型变量取代。写进 ~/.claude/settings.json 长期生效: 
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_KIMI_API_KEY",
    "ANTHROPIC_MODEL": "kimi-k3[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k3[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k3[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k2.7-code",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "kimi-k3[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "kimi-k3[1m]",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

~/.claude/settings.json —— 当前官方示例(国内站;国际站替换 BASE_URL 域名)

三条注意事项, 都来自当前官方指南: ① 各档模型变量要配全, 缺了对应场景(后台摘要、子 agent)会失败; ② settings.json 的 env 会覆盖 shell 同名变量, 修改后重启, 再用 /status 与 /model 核对; ③ 换用强制思考的 kimi-k2.7-code 时, 要在 Claude Code 里开启 Thinking, 否则请求被 400 拒绝。旧教程里的 ENABLE_TOOL_SEARCH=false 已不在当前最小配置中, 不要继续机械照抄。6注 6Kimi 开放平台 · 在 Claude Code 中使用 Kimi —— 当前示例将主模型与 OPUS / SONNET / FABLE 配为 kimi-k3[1m], HAIKU 配为 kimi-k2.7-code, 并设置 CLAUDE_CODE_SUBAGENT_MODEL、CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000 与 CLAUDE_CODE_EFFORT_LEVEL=max; 当前指南不再要求 ENABLE_TOOL_SEARCH=false。settings.json 的 env 会覆盖 shell 同名变量, 修改后需重启。复核于 2026-10。

#OpenCode(有内置 Moonshot, 最省事).

OpenCode 内置了 Moonshot AI(国际)与 Moonshot AI (China)(中国区)两个供应商: 运行 /connect 选对应那个、粘贴 Key 即可, 不用手写配置。10注 10OpenCode 官方文档与 Kimi 官方 OpenCode 指南 —— 内置 Moonshot AI（国际）与 Moonshot AI (China) 两个供应商; 自定义供应商走 opencode.json 与 @ai-sdk/openai-compatible。想自己管配置(比如团队共享), 就在 opencode.json 里声明一个 OpenAI 兼容供应商: 
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "kimi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Kimi (Moonshot CN)",
      "options": {
        "baseURL": "https://api.moonshot.cn/v1",
        "apiKey": "{env:MOONSHOT_API_KEY}"
      },
      "models": {
        "kimi-k3.1-pro": { "name": "Kimi K3.1 Pro", "limit": { "context": 1048576, "output": 131072 } },
        "kimi-k3": { "name": "Kimi K3", "limit": { "context": 1048576, "output": 65536 } }
      }
    }
  },
  "model": "kimi/kimi-k3.1-pro"
}

opencode.json —— 自定义供应商(国内站;国际站换 baseURL 与内置供应商 Moonshot AI)

#Codex CLI(原生 Responses, 现在可以直连).

旧结论是「Codex 只支持 Responses, Kimi 只有 Chat Completions, 所以要转换」。现在后半句已经变了: Kimi 原生提供 Responses API, 自定义 provider 的 wire_api 填 responses 即可直连 kimi-k3.1-pro, 不再需要 CC-Switch 或本地代理。8注 8OpenAI 官方文档 · Codex 配置参考 —— 自定义 model_providers 支持 name / base_url / env_key / wire_api 等键, wire_api 使用 responses。复核于 2026-10。9注 9Kimi 开放平台 · 在 Codex 中使用 Kimi K3.1 Pro —— Kimi 已原生支持 Responses API, Codex 可通过自定义 provider 直连 kimi-k3.1-pro, 无需协议转换或本地代理; base_url 为 https://api.moonshot.cn/v1, wire_api 为 responses, model_context_window 为 1048576。复核于 2026-10。先在终端设置 KIMI_API_KEY, 再写 ~/.codex/config.toml: 
model = "kimi-k3.1-pro"
model_provider = "kimi"
model_context_window = 1048576
 
[model_providers.kimi]
name = "Kimi"
base_url = "https://api.moonshot.cn/v1"
env_key = "KIMI_API_KEY"
wire_api = "responses"

~/.codex/config.toml —— 开放平台国内站直连;国际站替换 base_url 域名

重启 Codex 后选一个真实仓库任务验证。若之前用 CC-Switch 接过, 先关闭它的 Codex 路由, 避免它继续改写配置或把 base_url 指回本地地址; 出现 404 /v1/responses 时, 先检查 base_url 是否恰好保留 /v1。9注 9Kimi 开放平台 · 在 Codex 中使用 Kimi K3.1 Pro —— Kimi 已原生支持 Responses API, Codex 可通过自定义 provider 直连 kimi-k3.1-pro, 无需协议转换或本地代理; base_url 为 https://api.moonshot.cn/v1, wire_api 为 responses, model_context_window 为 1048576。复核于 2026-10。

#Pi(终端 agent, 配置文件驱动).

Pi 是 Mario Zechner 写的终端编码 agent(仓库现为 earendil-works/pi, 原名 pi-mono), 全部供应商配置收在一个 ~/.pi/agent/models.json 里。11注 11Pi 官方文档（earendil-works/pi）—— 自定义供应商写在 ~/.pi/agent/models.json, 支持 openai-completions / anthropic-messages 等协议, apiKey 可填环境变量名; 另内置 Kimi For Coding 供应商。装好后把 Kimi 声明成一个 OpenAI 兼容供应商: 
{
  "providers": {
    "moonshot": {
      "baseUrl": "https://api.moonshot.cn/v1",
      "api": "openai-completions",
      "apiKey": "MOONSHOT_API_KEY",
      "models": [
        { "id": "kimi-k3", "name": "Kimi K3", "reasoning": true, "contextWindow": 1048576, "maxTokens": 65536 },
        { "id": "kimi-k2.7-code", "name": "Kimi K2.7 Code", "reasoning": true, "contextWindow": 262144, "maxTokens": 65536 }
      ]
    }
  }
}

~/.pi/agent/models.json —— apiKey 支持环境变量名 / 字面值 / !命令三种写法; 建议像下面这样填环境变量名, 别把 Key 本体写进文件

保存后在会话里 /model 选择即可, 改配置不用重启。11注 11Pi 官方文档（earendil-works/pi）—— 自定义供应商写在 ~/.pi/agent/models.json, 支持 openai-completions / anthropic-messages 等协议, apiKey 可填环境变量名; 另内置 Kimi For Coding 供应商。走会员订阅那条线的读者: Pi 还内置了 Kimi For Coding 供应商, 设环境变量 KIMI_API_KEY 就能用 —— 注意那套 Key 与开放平台互不通用, 别混。2注 2Kimi 帮助中心 · Kimi Code —— 会员专用端点为 OpenAI 兼容 https://api.kimi.com/coding/v1 与 Anthropic 兼容 https://api.kimi.com/coding/, 走会员订阅额度; api.kimi.com 与 api.moonshot.cn 是独立账号体系, API Key 互不通用。11注 11Pi 官方文档（earendil-works/pi）—— 自定义供应商写在 ~/.pi/agent/models.json, 支持 openai-completions / anthropic-messages 等协议, apiKey 可填环境变量名; 另内置 Kimi For Coding 供应商。

#Cline / Roo Code / Aider(都有现成路径).

Cline 和 Roo Code 都在供应商下拉里内置了 Moonshot: 直选、粘贴 Key、选模型, 三个动作; 也可以选 OpenAI Compatible, 填 Base URL / API Key / Model ID 三个字段。12注 12Cline 官方文档 —— 内置 Moonshot 供应商, 也可选 OpenAI Compatible 填 Base URL / API Key / Model ID; 早期社区 issue 曾报告 K2.6 的 temperature 校验问题, 优先使用内置供应商并以当前版本实测为准。13注 13Roo Code 官方文档 —— 内置 Moonshot 供应商, 也可选 OpenAI Compatible; Roo Code 使用原生 tool calling, 模型须支持 OpenAI 风格工具调用。Cline 有一条社区反馈值得知道: kimi-k2.6 走 OpenAI Compatible 会因 temperature 校验报 400, 优先用内置 Moonshot 供应商(社区 issue, 非官方结论)。12注 12Cline 官方文档 —— 内置 Moonshot 供应商, 也可选 OpenAI Compatible 填 Base URL / API Key / Model ID; 早期社区 issue 曾报告 K2.6 的 temperature 校验问题, 优先使用内置供应商并以当前版本实测为准。Aider 走通用的 OpenAI 兼容环境变量: 
export OPENAI_API_BASE="https://api.moonshot.cn/v1"
export OPENAI_API_KEY="YOUR_KIMI_API_KEY"
aider --model openai/kimi-k3

Aider 接 Kimi(也可写进 .aider.conf.yml: openai-api-base / openai-api-key / model)

#Cursor(原生 BYOK 与 Kimi Code 扩展是两条路).

Cursor 原生自带 Key(BYOK)仍只支持 OpenAI / Anthropic / Google / Azure OpenAI / AWS Bedrock 五家, 自定义 Key 只覆盖标准聊天模型, Tab 补全继续走 Cursor 内置模型。15注 15Cursor 官方文档 · API Keys —— BYOK 仍只列 OpenAI / Anthropic / Google / Azure OpenAI / AWS Bedrock, 自定义 Key 只覆盖标准聊天模型, Tab 补全继续使用 Cursor 内置模型。复核于 2026-10。但这不等于「Cursor 不能用 Kimi」: 官方另提供 Kimi Code for VS Code / Cursor 的 IDE 路径, 在扩展输入栏选择 Kimi 模型即可。想用 Cursor 原生 Agent 直连任意 Kimi 端点, 与在 Cursor 里使用 Kimi Code 扩展, 是两件不同的事, 别再混成一句「能」或「不能」。19注 19Kimi 官方 K3 产品说明 —— Kimi Code 除 CLI 外也支持兼容 IDE; 官方 FAQ 明确列出 Kimi Code for VS Code 和 Cursor, 可在输入栏模型菜单选择 Kimi。它与 Cursor 原生 BYOK 是两条不同接入路径。

#顺带: 你的 agent 想动浏览器, 装 Kimi WebBridge.

配置再全, 上面这些 agent 也只会读写文件和跑命令 —— 碰不了网页。要让它像真人一样点按钮、填表单、跨站取数, 装一个 Kimi WebBridge: Chrome / Edge 扩展, 跑在你自己的浏览器里、直接继承你的登录态, 本地优先、数据不出设备, 扩展本身不收钱。17注 17Kimi 帮助中心 · Kimi WebBridge 介绍 —— Chrome / Edge 扩展, 继承当前浏览器登录态, 让本地 agent 点击、填表和跨站提取; 本地优先, 可配合 Kimi Code / Claude Code / Cursor / Codex 等工具。Kimi Code、Claude Code、Cursor、Codex 这些本地 agent 都能挂; 装法是给 agent 发一句安装命令, 它自己把本地守护程序和技能装好。它解决的不是「模型接入」, 是「给 agent 一把手」。 常有人问我: Kimi 配在哪个 agent 里表现最好? 我的排序是自己用出来的: 首推 Warp Agent —— 它支持自定义 API 服务商端点, 把第二节那个 OpenAI 兼容端点填进去就能用, 效果非常好; 其次是 Kimi Code 自己 —— 模型稳定性最好, 长跑几乎不中断。

— IV

CC-Switch: 可选的配置面板, 不再是必经桥.

当你只有一套配置, 手动改 env 就够了; 当你在 Kimi、Claude 官方和其他模型之间频繁切换, CC-Switch 这类第三方面板可以少做一些重复劳动。16注 16CC-Switch（farion1231/cc-switch）—— 第三方多供应商配置管理工具, 可维护 Claude Code / Codex 等工具的配置; 它不是 Kimi 官方产品, 也不再是 Codex 接 Kimi 的必经层。旧路由可能改写 Codex 配置, 直连前应检查并关闭。但要更新一个旧认知: Codex 已能走 Kimi 原生 Responses API, CC-Switch 的协议转换不再是必需品。它的价值回到「集中管理配置」, 而不是「没有它就接不上」。macOS 仍可这样安装: 
brew install --cask cc-switch

安装 CC-Switch(macOS;Windows / Linux 在 ccswitch.io 下安装包)

它会维护供应商 profile, 并把启用中的配置写入对应工具的配置文件。代价是「谁在改配置」多了一层: 如果手动直连与面板路由同时开着, 后写入的一方可能覆盖前一方。Claude Code 改完用 /status 核, Codex 改完检查 config.toml 的 base_url 和实际启动模型; 旧 Codex 路由不用了就关掉。6注 6Kimi 开放平台 · 在 Claude Code 中使用 Kimi —— 当前示例将主模型与 OPUS / SONNET / FABLE 配为 kimi-k3[1m], HAIKU 配为 kimi-k2.7-code, 并设置 CLAUDE_CODE_SUBAGENT_MODEL、CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000 与 CLAUDE_CODE_EFFORT_LEVEL=max; 当前指南不再要求 ENABLE_TOOL_SEARCH=false。settings.json 的 env 会覆盖 shell 同名变量, 修改后需重启。复核于 2026-10。9注 9Kimi 开放平台 · 在 Codex 中使用 Kimi K3.1 Pro —— Kimi 已原生支持 Responses API, Codex 可通过自定义 provider 直连 kimi-k3.1-pro, 无需协议转换或本地代理; base_url 为 https://api.moonshot.cn/v1, wire_api 为 responses, model_context_window 为 1048576。复核于 2026-10。16注 16CC-Switch（farion1231/cc-switch）—— 第三方多供应商配置管理工具, 可维护 Claude Code / Codex 等工具的配置; 它不是 Kimi 官方产品, 也不再是 Codex 接 Kimi 的必经层。旧路由可能改写 Codex 配置, 直连前应检查并关闭。 和手动改 env 怎么选? 一套配置走天下 → 手动就够, 第二、三节都给了。多套之间频繁切、或要给团队演示 → 再评估 CC-Switch。别为了使用一个配置面板, 反过来把已经能直连的链路重新绕回代理。

— V

终端循环不是给所有人的.

它替我写, 替不了我审 —— 你看不懂它的 diff, 它的速度只会让你更快地把错误合进去。 我划三条边界。完全不写代码 → 跳过这章, 用 Agent 模式做表、做站就够。会写、但只改一两行 → 对话框里贴代码更快, 不必请出终端。值得请出终端 agent: 多文件、长链条、要反复跑测试的改动 —— 投入越重, 终端循环越划算。 还有一类藏得更深的甜区: 不像代码的文件工作。我自己前两天的一次: 给这本书做宣传物料 —— 我把需求说清, 它写了 HTML 海报母版、用 Playwright 逐张渲染成图, 又把两小时的直播回放按时间线剪成 59 秒的竖版短片（ffmpeg 切片、压字幕、拼首尾卡）。全程我没打开过设计软件或剪辑软件, 只做了两件事: 说清楚要什么, 和验收。海报、视频、批量处理素材 —— 产出是文件、过程可复算的活, 都归它。很多人用了半年, 都没想起来它能干这个。 一个值得请出它的真实场景: 给一个跨十几个文件的功能加开关。我的用法是, 不一句「加个 feature flag」就放手, 先把范围、测试和安全边界交代清楚, 让它先报方案再动手:
提示词kimi-k3.1-pro
任务: 给现有的导出功能加一个 feature flag「EXPORT_V2」。

【先报方案】先列出你打算改哪些文件、为什么, 等我确认再动手, 别直接改。
【做法】flag 默认关闭; 关闭时行为和现在完全一致。
【测试】改完跑一遍现有测试; 为新分支补至少两条(开 / 关各一)。
【安全】不要改数据库 schema、不要删文件、不要碰 CI 配置; 每步说清要执行什么命令。
任务: 给现有的登录接口加一个限流中间件「RATE_LIMIT_LOGIN」, 每 IP 每分钟最多 10 次。

【先报方案】先列出你打算改哪些文件、为什么, 等我确认再动手, 别直接改。
【做法】用配置开关控制, 默认关闭; 关闭时行为和现在完全一致。
【测试】改完跑一遍现有测试; 为限流逻辑补至少两条(未超限放行 / 超限返回 429)。
【安全】不要改数据库 schema、不要删文件、不要碰 CI 配置; 每步说清要执行什么命令。
01

用刚配好的线跑一件真改动, 全程盯着

小仓库、真需求, 看它的每一步, 该拦就拦 —— 第一次别放它自己跑。
02

记一次过的比例和回滚次数

对比自己动手的时间, 给它定一条「值得请出它」的线。

它替我写, 替不了我审.

它替我写, 替不了我审.

Kimi x Zhaphar

— 讨论

讨论.

评论区初始化中…