--- title: "Kimi Code CLI 零基础入门 + 关键能力全景（0.8.0）" wiki: cli category: "终端 Agent 工具" slug: kimi-code-introduction url: https://learnagent.wiki/cli/cards/kimi-code-introduction tags: ["Kimi Code", "Moonshot", "国产", "CLI Agent", "入门", "plugin", "scheduled tasks", "Goal mode"] last_updated: 2026-06-04 reading_time: 13 --- > [Kimi Code](https://github.com/MoonshotAI/kimi-code) 是 **Moonshot AI** 出的开源（MIT 协议）终端 AI agent，特点是 **单 binary（一个独立可执行文件，不带运行时依赖）+ OpenAI 兼容协议第一公民 + 高频迭代**（2026 年 4 月到 6 月初从 0.2.0 ship 到 0.8.0 共 7 个 minor）。本卡按 0.8.0（2026-06-02）当前能力集介绍，**不展开 Claude Code 横向对比**——想看对比看[同站 CLI 总览](/cli/cards/terminal-agents-comparison)；想从头入门看下面。 # Kimi Code CLI 零基础入门 + 关键能力全景（0.8.0） [Kimi Code](https://github.com/MoonshotAI/kimi-code) 是 **Moonshot AI** 出的开源（MIT 协议）终端 AI agent，特点是 **单 binary（一个独立可执行文件，不带运行时依赖）+ OpenAI 兼容协议第一公民 + 高频迭代**（2026 年 4 月到 6 月初从 0.2.0 ship 到 0.8.0 共 7 个 minor）。本卡按 0.8.0（2026-06-02）当前能力集介绍，**不展开 Claude Code 横向对比**——想看对比看[同站 CLI 总览](/cli/cards/terminal-agents-comparison)；想从头入门看下面。 > 历史说明：本卡 06-04 改写之前是 `Kimi Code CLI vs Claude Code 横向对比`（旧 slug `kimi-code-vs-claude-code`，已 301 重定向到当前 URL `/cli/cards/kimi-code-introduction`）。新版改为单独介绍 Kimi Code、把 vs Claude Code 改成轻量旁注。 ## 基础概念 Kimi Code 是 **"终端里能自己调工具的 AI agent"**，不是 ChatGPT 装进终端。关键差别一条：**它在你看不到的中间步骤里自己调工具（读文件、跑 shell、调 MCP server），并把结果带回下一轮推理。** 举个例子：你输入"读这个目录的 README 写一段中文摘要存成 `README.summary.md`"—— - **ChatGPT / Kimi Web 模式**：模型只产摘要文本，你复制粘贴去 IDE 自己 `touch + vim` 落地 - **Kimi Code 模式**：agent 自己读 `README.md` → 自己生成摘要 → 自己创建并写入 `README.summary.md`，你只看到"我要做什么"和"我做完了"两段输出 这一条想清楚再往下读；否则你会把它当"高级补全"用，浪费 80% 的能力。 ### 核心能力 | 能力 | 作用 | |------|------| | **单 binary 部署** | curl 一行装，无 Node 依赖；OPS / DevOps / 数据 / SRE 本机没 Node 也能跑 | | **OpenAI 兼容协议第一公民** | 0.3 起自动检测推理字段（`reasoning_content` / `reasoning_details`），DeepSeek / Qwen / One API gateway / 自部 vLLM 都好接 | | **`KIMI_MODEL_*` env 直配** | 0.6 起 provider / base URL / API key / context size / capabilities / thinking 全走环境变量，CI / 容器场景天然兼容 | | **plugin 从 GitHub 直装** | 0.6 起 `kimi plugin install `，plugin manager 按 trust level 三档标注（bundled / curated / third-party） | | **scheduled tasks（stable）** | 0.5 起用 5 字段 cron 让 agent 定时跑；0.7 把 cron 触发事件暴露给 SDK | | **Goal mode（experimental）** | 0.8 起 `KIMI_CODE_EXPERIMENTAL_GOAL_COMMAND=1` opt-in，`/goal status/pause/resume/cancel/replace` 多轮长目标自动推进 | | **video 多模态输入** | 拖一段屏幕录像让 agent "看着复现 bug"，比文字描述快 | ### 工作原理 ```mermaid graph LR Ask["用户输入
(读 README 写摘要)"] Ask --> Web["ChatGPT / Kimi Web"] Ask --> Kimi["Kimi Code (终端 agent)"] Web --> WebHand["你手动:
vim 粘贴 + git add"] Kimi --> KimiTool["agent 自己调工具:
读 + 写 + (可选) git"] KimiTool --> KimiDone["完成: 文件已落地"] ``` 差别不是"AI 更聪明"，是"工具调用这一步在谁手上"。Kimi Code 所有"高级 feature"（plugin / scheduled tasks / Goal mode / `/auto`）本质都在管工具调用的**扩展 / 调度 / 鉴权**三块。 ## 基础用法 ### 一行命令装上 **macOS / Linux**： ```bash curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash ``` **Windows PowerShell**： ```powershell irm https://code.kimi.com/kimi-code/install.ps1 | iex ``` 升级（0.8 起官方推荐手动升而非后台自动）： ```bash kimi upgrade ``` ### 第一次 `/login`：三档 provider 选哪个 | provider 档位 | 怎么走 | 对你意味着什么 | |---|---|---| | **Kimi 官方（默认）** | TUI 里 `/login` → "Kimi Code OAuth"（一种业界通用的鉴权协议，让你用一个账号授权多个应用）或 "Moonshot API Key" | 最少配置；中文场景上下文友好 | | **OpenAI 兼容 gateway**（DeepSeek / Qwen / One API / Together / OpenRouter） | `KIMI_MODEL_*` 环境变量直配：`KIMI_MODEL_PROVIDER` / `KIMI_MODEL_BASE_URL` / `KIMI_MODEL_API_KEY` / `KIMI_MODEL_NAME` | 想用国产模型 / 想集中走一个 gateway 管多模型 → 走这条 | | **自部署 LLM endpoint** | 同样走 `KIMI_MODEL_*` env，外加 0.7 新增 `KIMI_MODEL_ADAPTIVE_THINKING` 强制 adaptive thinking 开关 | 跑了自己的 vLLM / TGI / Ollama / 公司不允许调外部 API 必走这条 | 怎么选：第一次试用 **Kimi 官方 OAuth** 最快；接国产模型 / 自部模型走 `KIMI_MODEL_*` env。0.8 加的 `kimi provider` CLI 让你不进 TUI 也能管 provider，脚本化场景顺手。 ### 跑通第一个任务 ```bash cd ~/some-project kimi > 读这个目录的 README.md，写一段 200 字以内的中文摘要，存成 README.summary.md ``` 期间它会每次工具调用前都问你许可。确认风险可控、想让它一路跑下去，加 `--auto` 启动或 TUI 里 `/auto` 进入 **Auto mode**（agent 不再每个工具调用都问、只在危险操作时问的权限模式）。**第一次跑陌生项目不要直接 `--auto`**——先在能 `git reset` 的目录里观察它动了哪些文件。 ## 装 plugin：从 GitHub 直装 + trust level 三档 Kimi Code **没有官方 marketplace**，plugin 从 GitHub 仓库直接装（0.6+）： ```bash kimi plugin install https://github.com/some-author/some-plugin ``` plugin 可以自带 slash 命令、自带 skill（plugin 自带的可复用知识/动作包，装完自动注册到 agent 上下文）、自带 plugin-owned MCP server——也就是说，**装一个 plugin 等于装它带的全部工具集**。这是为什么要 trust level 这套机制。 `kimi plugin list` 输出示意： ```text NAME VERSION TRUST SOURCE kimi-official-skills 1.2.0 kimi-official bundled git-extras 0.4.1 curated github.com/kimi-curated/git-extras my-team-internal-rag 0.1.0 third-party github.com/acme-corp/internal-rag-plugin some-cool-plugin 0.7.0 third-party github.com/random-dev/some-cool-plugin ``` | trust level | 含义 | 对你意味着什么 | |---|---|---| | **kimi-official** | Moonshot 官方维护，跟 Kimi Code 一起发布 | 跟核心 CLI 一样的可信度；安心装 | | **curated** | 进官方 curated 列表，Moonshot 审过一道 | 仍要看仓库活跃度 + 最近 commit | | **third-party** | 任意 GitHub URL 装；plugin manager 不审源码 | **trust level 只是标签、不是安全保证**；你自己看作者 + commit + issue + 依赖的 MCP 再装 | ## 让 agent 自己跑：三种形态 ### 形态一：一次性子任务（sub-agent） 内置三种 sub-agent（在隔离上下文里跑的子任务 agent，结果带回主对话）： - **coder**：在隔离上下文里写代码 / 改文件 - **explore**：探索代码库 / 收集信息（避免污染主对话） - **plan**：拆任务 / 出执行计划 要按业务命名一堆自定义 sub-agent（如 `db-migration-agent`），Kimi 当前没有等价机制——这是 Claude Code 的强项。 ### 形态二：周期性巡查 / 定时跑（scheduled tasks · stable 0.5+） ```text > /schedule "0 9 * * 1-5" "巡查 staging 环境最近 24h 的报错日志，整理成清单" ✓ scheduled task created /schedule list # 看所有定时任务 /schedule remove # 删一个 ``` 5 字段 cron 表达式（每位代表分钟/小时/日/月/周）。**stable，可放生产**——但注意：调度本身稳，被它唤起的 agent 仍可能调没审过的 plugin / MCP，要单独审被唤起的工具。 ### 形态三：多轮长目标（Goal mode · 0.8 experimental） ```text $ KIMI_CODE_EXPERIMENTAL_GOAL_COMMAND=1 kimi > /goal 把这个项目的 README 翻译成英文并提一个 PR ✓ goal accepted: /goal status / pause / resume / cancel / replace ``` **experimental**（标记为"会变"的 feature，下个版本字段可能改）——只在能随时 `git reset` 的低风险任务上玩，**生产 CI 脚本里别 hardcode `/goal` 命令名**。 ## 五类实战场景的能力组合 | 实战场景 | 推荐能力组合 | 对你意味着什么（stable / experimental） | |---|---|---| | **中文 RAG / 长文本** | Kimi 官方 provider + 自写 RAG plugin（带 plugin-owned MCP） | plugin 系统 stable，放心做 | | **定时巡查 / 日志聚合** | scheduled tasks + plugin 封装"读日志 + 写报告" | stable；可放生产，但要审被唤起工具 | | **接自部 LLM / 国产 gateway** | `KIMI_MODEL_*` env + 0.7 `KIMI_MODEL_ADAPTIVE_THINKING` | stable；公司内 vLLM / Ollama 也走这条 | | **video bug 输入** | Kimi 官方 provider（自家模型支持 video） | stable；其他 CLI agent 多数还只支持图片 | | **长链路多轮任务**（如 monorepo 5 个包都升 React 19） | Goal mode（0.8 experimental）+ `/goal status` 监控 | **experimental — 仅在能 `git reset` 的分支试**，别写进 CI | ## 三条不绑生产的原则 Kimi Code 节奏快（两个月 7 个 minor），避免每次升版本脚本碎一次： 1. **生产 / CI 脚本不 hardcode experimental 字段名**（当前是 Goal mode `/goal *`、`KIMI_CODE_EXPERIMENTAL_GOAL_COMMAND` env）；用一层薄抽象包住，字段改你只改抽象层 2. **scheduled tasks 跑生产前，审一遍它唤起的 plugin / MCP server**——按调到的最危险那个工具的等级控权限 3. **每两周扫一次 [releases 索引](https://github.com/MoonshotAI/kimi-code/releases)**——只看跟你工作流相关的几条；别开后台自动升，新版本字段改了你需要先确认脚本没绑死 ## 什么时候你不该用 Kimi Code | 场景 | 更合适的工具 | |---|---| | 必须用 Anthropic 模型 + 订阅 | Claude Code | | 要 VSCode / JetBrains 第一方 IDE 集成 | Claude Code | | 要企业 managed settings + plugin 白名单集中下发 | Claude Code | | 要按业务命名一堆自定义 sub-agent | Claude Code | | 只是"问个问题、拷个代码" | ChatGPT / Kimi Web（不用终端 agent） | ## 常见误区 | 误区 | 准确理解 | |---|---| | Kimi Code 是 ChatGPT 装进终端 | 是终端里能自己调工具的 agent；差别是"工具调用这一步在谁手上" | | trust level 标签 = 安全保证 | 只是来源标注；third-party plugin 装下来该跑的代码照跑，判断责任在你 | | scheduled tasks 稳 = 可以无人值守跑生产 | 调度本身稳，被唤起的工具链要单独审 | | 0.8 Goal mode 可以写进 CI | experimental — 字段下个版本可能改；只在低风险任务上玩 | | 演进快 = 全部能力都开起来 | 多开一个能力，对版本变化的脆弱度多一档；挑能力按"场景命中"，不按"它有没有" | ## 思考题
初级：为什么 Kimi Code 把 plugin 装源开到 GitHub URL 而不是搞中心化 marketplace？ **参考答案：** 跟它"高频迭代 + 开源 + OpenAI 兼容协议第一公民"的整体哲学一致——marketplace 审核会拖慢长尾 plugin 上架速度，与"快速试错"取舍冲突。代价是把信任判断后置到用户（看作者 / 看 commit / 看依赖），并用 trust level 三档标签提示用户来源。
中级：scheduled tasks 是 stable 的，那是不是可以直接拿它跑生产定时任务？ **参考答案：** 调度本身稳，但被它唤起的 agent 仍会调用 plugin / MCP / 工具——这些工具不一定都适合无人值守跑。审计要点：（1）被调到的最危险那个工具的权限范围；（2）失败 / 卡住的通知机制；（3）出 bug 时能否回滚（用 git 跟踪 + 限制工作目录）。三条都过了再上生产。
## 参考资料 1. Kimi Code 仓库 README（主原文）：https://github.com/MoonshotAI/kimi-code 2. Kimi Code 官方文档：https://code.kimi.com/kimi-code/ 3. Kimi Code 全部 releases 索引（追最新版）：https://github.com/MoonshotAI/kimi-code/releases 4. Kimi Code 0.3.0 release（OpenAI 兼容推理字段自动检测）：https://github.com/MoonshotAI/kimi-code/releases/tag/%40moonshot-ai%2Fkimi-code%400.3.0 5. Kimi Code 0.4.0 release（plugin 系统重构 + plugin-owned MCP）：https://github.com/MoonshotAI/kimi-code/releases/tag/%40moonshot-ai%2Fkimi-code%400.4.0 6. Kimi Code 0.5.0 release（scheduled tasks + `/auto`）：https://github.com/MoonshotAI/kimi-code/releases/tag/%40moonshot-ai%2Fkimi-code%400.5.0 7. Kimi Code 0.6.0 release（`KIMI_MODEL_*` env + GitHub URL 装 plugin）：https://github.com/MoonshotAI/kimi-code/releases/tag/%40moonshot-ai%2Fkimi-code%400.6.0 8. Kimi Code 0.7.0 release（adaptive thinking + `/provider` + cron SDK event）：https://github.com/MoonshotAI/kimi-code/releases/tag/%40moonshot-ai%2Fkimi-code%400.7.0 9. Kimi Code 0.8.0 release（experimental Goal mode + `kimi provider` CLI + `kimi upgrade` + `/undo`）：https://github.com/MoonshotAI/kimi-code/releases/tag/%40moonshot-ai%2Fkimi-code%400.8.0 10. 同站延伸 — [Claude Code 总览](/cli/cards/claude-code-overview) 11. 同站延伸 — [CLI 工具横向对比](/cli/cards/terminal-agents-comparison) 12. 同站延伸 — [配置 MCP in CLI](/cli/cards/configure-mcp-in-cli) --- *Source: https://learnagent.wiki/cli/cards/kimi-code-introduction* *Markdown mirror of https://learnagent.wiki, served as text/markdown for LLM ingestion.*