Kimi 外援 linxule/kimi-plugin-cc

Kimi for Claude Code、Codex 和 DeepSeek Harness

用 Kimi 解释代码、审查改动、质疑设计方案，或者朝某个目标推进——在你已经打开的 Claude Code、Codex 或 DeepSeek Harness 会话里，拿到来自另一个模型家族的独立第二意见。

Kimi Ambassador — academia

我是 Kimi Ambassador（学术界）。Kimi（Moonshot AI）通过这个身份支持本项目。

最新版本 · npm 包 · 路线图 · 报告问题 · Apache-2.0 许可证

Claude Code running /kimi:review on this repository, with Kimi's findings verified claim by claim in the same session

Claude Code 在本仓库上运行 /kimi:review——Kimi 审查 diff，宿主在同一会话里逐条核对每个结论。

Codex running $kimi-ask to explain this project's entry point

Codex 运行 $kimi-ask——只读解释本项目的入口，从入口 shell 脚本到各个命令模块。

选择语言，展开阅读 · Choisissez votre langue · 言語を選んで開いてください

English — Get started

在编码任务中使用 Kimi

让 Kimi 解释代码、审查改动、质疑设计方案，或者做一处针对性的修复。你可以在 Claude Code、Codex 或 DeepSeek Harness（DSH）里使用这个插件。

插件会在你的电脑上运行 Kimi Code CLI。它使用你的 Kimi 订阅，或者你在 Kimi 里配置的服务商。调用会计入该订阅或 API 账户。宿主应用的登录状态保持不变。选定的服务商会收到完成任务所需的提示词和代码。

先从提问或审查开始。这两类模式的工具规则允许读取文件，禁止写文件和执行 shell 命令。其他模式可以改动文件。DSH 提供同样的七种操作，写边界也一致。让 Kimi 动手改动之前，先读一遍安全限制。

安装之前

你需要：

- macOS 或 Linux
- 支持插件的 Claude Code、Codex 或 DSH
- Node.js 22.5 或更高版本（DSH 需要 24.9 或更高版本）
- Kimi Code CLI 2.4.1（已认证；2.4.0、2.3.3、2.3.2、2.3.1 和 2.3.0 也已认证）目前尚不支持 Windows。你可以参与 no-model Windows 诊断检查，帮我们补上这块。在终端里查看版本：

node --version
kimi --version

需要命令行的话，参考 Kimi Code 安装指南。用这个插件不需要 Bun，也不需要构建步骤。

我们按精确的命令行版本测试兼容性。命令行版本更新，可能需要更新的插件。详见支持的版本与升级。

在终端里运行 kimi。用 /login 登录 Kimi 订阅，或用 /provider 配置 API 服务商。凭据填在 Kimi 里，绝不要填进助手对话。配置完成后退出 Kimi。如果你设置了 KIMI_CODE_HOME，Kimi 和插件要用同一个位置。

在 Claude Code 中安装

在项目里打开 Claude Code。在 Claude Code 中输入这些命令：

/plugin marketplace add linxule/kimi-plugin-cc
/plugin install kimi@kimi-marketplace
/kimi:setup
/kimi:setup --check

安装过程会装一个钩子，按插件规则检查 Kimi 的工具调用。Probe: 行应显示 ok。如果失败，按下面的安装指引处理。

试一个不改文件的问题：

/kimi:ask Explain how this project's main entry point works.

在 Codex 中安装

在终端里运行这些命令：

codex plugin marketplace add linxule/kimi-plugin-cc
codex plugin add kimi@kimi-marketplace

在项目里新建一个 Codex 任务。让它安装插件：

Use $kimi-setup to install the safety hook, then check readiness.

钩子按插件规则检查 Kimi 的工具调用。Probe: 行应显示 ok。如果失败，按下面的安装指引处理。然后试试：

Use $kimi-ask to explain how this project's main entry point works.

如果你用多个宿主，每个宿主都要跑一遍安装。每个应用在共享的 Kimi 配置里各有自己的钩子。

在 DeepSeek Harness 中安装

DSH 需要打过补丁的宿主和配置档依赖（zod >=4.6.6、undici >=8.12.2）。安装本插件前，先按宿主安装与审计说明操作。

DSH 插件包提供与其他宿主相同的七个操作：kimi_ask、kimi_review、kimi_challenge、kimi_rescue、kimi_pursue、kimi_swarm 和 kimi_swarm_write。它们共用同一套伴随运行时、安全钩子、任务、预算和产物。rescue 和 pursue 会修改选中的工作区；swarm-write 只返回补丁，不应用、不提交。

在这个仓库的检出目录里运行：

dsh plugin --profile web add ./plugins/kimi-dsh

如果要用已发布的 npm 包，改运行 dsh plugin --profile web add kimi-plugin-cc。

在 DSH Discover 里，启用 Custom plugin indexes，然后把 https://raw.githubusercontent.com/linxule/kimi-plugin-cc/main/dsh/index.json 添加为索引源。
需要时重启 DSH，然后运行 /kimi-setup 和 /kimi-setup --check。让 DSH 用七个工具中的一个完成一项自包含任务。作业控制命令是 /kimi-status、/kimi-result 和 /kimi-cancel。/kimi-setup --models 列出已配置的模型，/kimi-setup --uninstall 只移除 DSH 钩子。

DSH 要求 Node.js 24.9 或更新版本，以及 DSH >=0.2.1-rc.5 <0.3.0。配置档级别的模型、思考、预算、review-base 及其他配置，见 DSH bundle 指南。

npm 分发（可选）

上文列出的 marketplace 命令仍是 Claude Code 和 Codex 的默认方式。已发布的版本也可以从 npm 上的 kimi-plugin-cc 获取，其中包含全部三个编译好的插件分发。使用这个包不需要 Bun、TypeScript 或安装脚本。Kimi Code CLI 和 Node 仍是前置条件。

如需一个明确指定版本的本地 Claude Code 插件，下面这个示例固定使用 2.5.1 包：

npm install --prefix ~/.local/share/kimi-plugin-cc kimi-plugin-cc@2.5.1
claude --plugin-dir ~/.local/share/kimi-plugin-cc/node_modules/kimi-plugin-cc

在该 Claude Code 会话中运行 /kimi:setup，然后运行 /kimi:setup --check。每台主机只安装一份插件；不要同时加载本地副本和已启用的 marketplace 副本。这个包是插件，不能替代上游的 kimi 可执行文件，也不提供 npx kimi-plugin-cc 命令。

要更新这份本地副本，把目标 npm 版本安装到同一前缀，重启会话，再运行 setup/check。Codex 用户应继续使用上文的 GitHub marketplace 说明。维护者请见registry releases。

选择任务

| 任务 | Claude Code 命令 | Codex 技能 | 文件访问 |
| 解释代码 | /kimi:ask | $kimi-ask | 只读 |
| 审查代码改动 | /kimi:review | $kimi-review | 只读 |
| 质疑设计或方案 | /kimi:challenge | $kimi-challenge | 只读 |
| 做针对性修复 | /kimi:rescue | $kimi-rescue | 可编辑你的项目 |
| 一次审查多个区域 | /kimi:swarm | $kimi-swarm | 只读 |
| 并行准备改动 | /kimi:swarm --write | $kimi-swarm-write | 仅在临时 Git worktree 中；返回补丁供你应用 |
| 跨多轮朝目标推进 | /kimi:pursue | $kimi-pursue | 可编辑你的项目；实验性 |

review 和 challenge 会检查你的 Git diff。关于仓库的一般性问题，用 ask。

pursue 和 swarm 有时间限制。swarm 并行运行任务，因此可能比单个任务消耗更多 token。

Claude Code 还有一个可选的审查门。它在 Claude 结束一轮时检查工作，默认关闭。

在 Kimi 中查看会话

插件会话共用 Kimi Code Desktop 和 kimi web 的历史记录。新的 native-v2 会话会拿到一个可读的兜底标题，Kimi 之后可以用生成的标题替换它。手动重命名会保留。缺失的旧会话和 native Gen Title 操作，见会话可见性与标题。

选择模型

新的 Kimi 会话使用你配置的默认模型。只有想换别的模型时才需要选。

在 Claude Code 里运行 /kimi:setup --models。在 Codex 里让 $kimi-setup 列出已配置的模型。这一步读取你本地的模型列表，不联系服务商，也不测试凭据。列表里的模型仍可能因认证、访问权限或工具支持而失败。

从列表里复制模型别名，把 provider/model 换成该别名：

/kimi:review -m 'provider/model' Check error handling in this diff.

在 Codex 里说「Use $kimi-review with my configured model named …」。两个应用都支持用自然语言指定模型。如果匹配到多个模型，助手会让你选。它不会猜模型 ID，也不会在出错后悄悄切换模型。

要测试列表里的某个模型，用它的别名跑一个小任务。这会以你的账号发起一次服务商调用。

为单个任务做的选择不会改动你保存的默认值。要改默认值，运行 kimi 再用 /model。

恢复的会话沿用之前的模型，除非你用 -m 传入别的别名。swarm 场景下，-m 选的是协调者的模型。worker 可能使用 Kimi 次级模型设置里的其他模型。见模型选择与服务商配置。

查看或取消任务

用这些命令跟进任务：

| 操作 | Claude Code 命令 | Codex 技能 |
| 查看进度 | /kimi:status | $kimi-status |
| 读取结果 | /kimi:result | $kimi-result |
| 取消任务 | /kimi:cancel | $kimi-cancel |

不带 job ID 时，cancel 会停掉本仓库最近运行的任务。如果有多个任务在跑，先确认要停哪一个。请用 cancel，不要直接中断应用，这样 write-swarm 才能保存补丁。由未发布的恢复实现产生的中断运行，见预览优先的 swarm 恢复；它从不应用补丁，也不删除废弃的工作。

取消任务不会撤销它已经做出的改动。

ask 和 rescue 支持恢复会话。例如 /kimi:ask -r Explain the next step. 会继续你最近的 ask 会话。在 Codex 里让 $kimi-ask 恢复它。见 ask 选项和 rescue 选项。

使用 MCP 服务器

插件还为 Claude Code 和 Codex 打包了一个 MCP stdio 服务器，与现有的斜杠命令和技能并存。这些接口仍然可用，现有的安全钩子配置也仍然必须保留。
七个模型工具分别是 kimi_ask、kimi_review、kimi_challenge、kimi_rescue、kimi_pursue、kimi_swarm 和 kimi_swarm_write。作业控制使用 kimi_job_status、kimi_job_result 和 kimi_job_cancel。

- Claude Code： 支持任务的调用会返回持久化 MCP 任务。用 tasks/get 轮询，用 tasks/cancel 取消。
- Codex： 调用目前使用普通 MCP 结果，不是原生 MCP 任务。附加之后，运行中的作业返回启动句柄；已结束的作业返回最终结果。用这三个作业控制工具查看、读取或取消作业。

Claude 把项目目录作为默认工作区。宿主没有默认工作区时（Codex 通常如此），首次操作必须提供绝对路径 workspace。之后的作业控制调用可以依赖作业已持久化的工作区绑定。MCP 服务器断开不会取消作业。作业表负责状态和结果；最终产物是结果的权威来源。失败的作业返回 isError: true，并附带其产物。

例如：「用 kimi_review 检查这个 diff。在 Claude Code 中，用 tasks/get 轮询返回的任务；在 Codex 中，用返回的句柄调用 kimi_job_status，再调用 kimi_job_result。」

更新或移除插件

在 Claude Code 中更新

打开 /plugin，刷新 kimi-marketplace，然后更新 kimi。再次运行 /kimi:setup，更新钩子的安装路径。

在 Codex 中更新

在终端运行以下命令：

codex plugin marketplace upgrade kimi-marketplace
codex plugin add kimi@kimi-marketplace

打开新任务，再次运行 $kimi-setup。

移除插件

先移除应用的钩子，再移除它的插件。在 Claude Code 中，运行 /kimi:setup --uninstall。在 Codex 中，让 $kimi-setup 卸载钩子。这样另一个应用的钩子会保留。

修复安装问题

钩子检查失败时，按它的诊断信息处理。收到指示时，为受影响的应用运行安装。不要绕过检查。

如果看到 KIMI_CAPABILITY_NOT_CERTIFIED，更新插件，或使用已认证的命令行版本。再次运行安装不会认证新的命令行。

如果看到 CLI_V2_PLAN_MODE_CONFIGURED，把 default_plan_mode 设为 false，或从 Kimi 的 config.toml 文件中删除它。此插件运行的会话不能使用计划模式。

所有拒绝码及其补救方法列在拒绝码目录中。

了解安全限制

ask、review、challenge 和只读 swarm 的工具规则禁止写文件和 shell 命令。rescue 和 pursue 可以在你的工作区写文件。带 --write 的 swarm 在临时 Git worktree 中工作。它从你最新的提交开始，因此不包含未提交的更改。它返回补丁，但不会应用到你的项目。
CLI 2.3.2、2.3.3、2.4.0 和 2.4.1 上的 swarm 模式，插件会短暂启动一个已认证的 loopback kimi web 进程来激活会话，之后再启动另一个进程关闭 swarm 模式；任务本身仍由一个普通的 kimi -p -r 进程执行。激活过程计入时限，访问 token 只留在内存中，不写入日志，清理失败则视为未成功。更早的已认证版本直接使用 kimi -p。

插件不会提交改动。保留或应用改动之前，请先审查。

只在你信任的仓库中使用能写文件的任务。Rescue、pursue 以及带 --write 的 swarm 可以运行测试和类似命令。这些命令会执行你仓库中的代码。钩子只限制工具的使用，不是操作系统级沙箱。

参见安全与限制、发布历史和计划中的工作。

贡献

先读贡献指南。运行时概览和项目约定说明了实现方式。

每个版本都由本插件编排的智能体交叉评审——Kimi、Claude 和 Codex 在本仓库中互相评审对方的工作，这一做法记录在更新日志中。

贡献者需要 Bun 才能运行 bun run check。详细的工程文档为英文。

简体中文 — 开始使用

用 Kimi 辅助编程

你可以让 Kimi 解释代码、审查修改、指出设计中的问题，或完成一项范围明确的修复。本插件支持 Claude Code、Codex 和 DeepSeek Harness（DSH）。

插件在你的电脑上调用 Kimi Code CLI，使用你的 Kimi 订阅或在 Kimi 中配置的服务商。调用会消耗相应的订阅额度或产生 API 费用。宿主应用的登录状态不变。任务所需的提示词和代码会发送给所选服务商。

建议先尝试提问或代码审查。这两类任务允许读取文件，禁止写入文件和执行 shell 命令。其他模式可以修改文件；DSH 同样提供七类操作，并遵循相同的写入边界。让 Kimi 动手修改前，请先了解安全限制。DSH 的安装方法见英文说明。

安装前准备

你需要：

- macOS 或 Linux
- 支持插件的 Claude Code、Codex 或 DSH
- Node.js 22.5 或更高版本（DSH 需要 24.9 或更高版本）
- Kimi Code CLI 2.4.1（已认证；2.4.0、2.3.3、2.3.2、2.3.1 和 2.3.0 也已认证）

目前不支持 Windows。在终端检查版本：

node --version
kimi --version

如果尚未安装 CLI，请参照 Kimi Code 安装指南。使用本插件不需要 Bun，也不需要编译。

我们按具体 CLI 版本验证兼容性。升级 CLI 后，可能也需要更新插件。参见支持的版本与升级说明。

在终端运行 kimi。Kimi 订阅用户通过 /login 登录；使用 API 的用户通过 /provider 配置服务商。请在 Kimi 中输入凭据，不要发到助手对话中。配置完成后退出 Kimi。如果设置了 KIMI_CODE_HOME，请确保 Kimi 和插件使用同一路径。

在 Claude Code 中安装

在项目目录中启动 Claude Code，然后在 Claude Code 中输入：

/plugin marketplace add linxule/kimi-plugin-cc
/plugin install kimi@kimi-marketplace
/kimi:setup
/kimi:setup --check

Setup 会安装一个钩子，按插件规则检查 Kimi 的工具调用。检查结果中，Probe: 一行应显示 ok。如果失败，请参照下方的安装问题处理说明。

试着问一个不需要修改文件的问题：

/kimi:ask 解释这个项目的主入口如何工作。

在 Codex 中安装

在终端运行：

codex plugin marketplace add linxule/kimi-plugin-cc
codex plugin add kimi@kimi-marketplace

在项目中打开一个新的 Codex 任务，请它完成配置：

使用 $kimi-setup 安装安全钩子，然后检查配置是否可用。
钩子会按插件规则检查 Kimi 的工具调用。检查结果中，Probe: 一行应显示 ok。如果失败，请参照下方的安装问题处理说明。然后试着输入：

使用 $kimi-ask 解释这个项目的主入口如何工作。

如果同时使用 Claude Code 和 Codex，请分别运行 setup。两个应用各有自己的钩子，共用一份 Kimi 配置。

在 DeepSeek Harness（DSH）中安装

DSH 宿主及各配置所用的依赖需要修补（zod >=4.6.6、undici >=8.12.2）。安装插件前，请按宿主安装与审计说明操作。

DSH 与其他宿主一样提供七类操作：kimi_ask、kimi_review、kimi_challenge、kimi_rescue、kimi_pursue、kimi_swarm 和 kimi_swarm_write。它们使用同一套 companion 运行时、安全钩子、任务记录、预算和产物。Rescue 和 pursue 会修改所选工作区；swarm-write 只返回补丁，不会应用或提交它。

从此仓库检出安装：

dsh plugin --profile web add ./plugins/kimi-dsh

从已发布的根包安装时，改为运行 dsh plugin --profile web add kimi-plugin-cc。

按提示重启 DSH，然后运行 /kimi-setup 和 /kimi-setup --check。让 DSH 使用上述任一工具，并提供独立完整的任务。任务控制命令为 /kimi-status、/kimi-result 和 /kimi-cancel。/kimi-setup --models 列出已配置模型，/kimi-setup --uninstall 只移除 DSH 自己的钩子。

DSH 需要 Node.js 24.9 或更高版本，以及 DSH >=0.2.1-rc.5 <0.3.0。配置模型、思考强度、预算、review base 等选项，请参阅 DSH 指南。

npm 分发（可选）

完整插件也已发布到 npm，包名为 kimi-plugin-cc，包含 Claude Code、Codex 和 DSH 的预编译运行时，无需 Bun 或构建步骤。默认仍推荐上方的插件市场安装方式。需要通过 npm 安装本地 Claude Code 插件时，请参照 npm 安装步骤。每个应用只加载一份插件；npm 不提供 npx kimi-plugin-cc 命令。Codex 用户继续使用上方的 GitHub 插件市场命令。

选择任务

| 任务 | Claude Code 命令 | Codex 技能 | 文件操作范围 |
| 解释代码 | /kimi:ask | $kimi-ask | 只读 |
| 审查代码修改 | /kimi:review | $kimi-review | 只读 |
| 检查设计或方案中的问题 | /kimi:challenge | $kimi-challenge | 只读 |
| 完成一项范围明确的修复 | /kimi:rescue | $kimi-rescue | 可以修改项目文件 |
| 同时审查多个部分 | /kimi:swarm | $kimi-swarm | 只读 |
| 并行准备修改 | /kimi:swarm --write | $kimi-swarm-write | 只在临时 Git 工作树中修改，返回补丁，由你决定是否应用 |
| 通过多轮任务推进目标 | /kimi:pursue | $kimi-pursue | 可以修改项目文件，属于实验性功能 |

Review 和 challenge 检查 Git 差异。关于仓库的一般问题，使用 ask。

Pursue 和 swarm 都有运行时限。Swarm 并行执行多个任务，可能比单个任务消耗更多 token。

Claude Code 还提供可选的自动审查功能，在 Claude 完成一轮回复时检查工作，默认关闭。

选择模型

新的 Kimi 会话使用已配置的默认模型。只有想换用其他模型时，才需要指定模型。

在 Claude Code 中运行 /kimi:setup --models。在 Codex 中，请 $kimi-setup 列出已配置的模型。这只会读取本地列表，不会连接服务商或验证凭据。列表中的模型仍可能因认证、访问权限或工具支持问题而无法使用。

从列表中复制模型别名，替换下方的 provider/model：

/kimi:review -m 'provider/model' 检查这次修改中的错误处理。

在 Codex 中，可以说“使用 $kimi-review，选择我已配置的名为……的模型”。两个应用都支持用自然语言指定模型。如果有多个匹配项，助手会请你选择。它不会猜测模型 ID，也不会在出错后悄悄换用其他模型。

要测试某个模型，请用它的别名运行一个小任务。这会通过你的账户调用服务商。

为单次任务选择模型不会更改已保存的默认设置。要更改默认模型，请运行 kimi，使用 /model。

恢复会话时会沿用之前的模型，除非通过 -m 指定另一个别名。对于 swarm，-m 选择负责协调的智能体所用的模型。执行子任务的智能体可能使用 Kimi 的辅助模型（secondary model）设置中的其他模型。参见模型选择与服务商配置。

查看或取消任务

你可以用以下命令跟进任务：

| 操作 | Claude Code 命令 | Codex 技能 |
| 查看进度 | /kimi:status | $kimi-status |
| 查看结果 | /kimi:result | $kimi-result |
| 取消任务 | /kimi:cancel | $kimi-cancel |

不提供任务 ID 时，cancel 会停止当前仓库中最近启动且仍在运行的任务。如果有多个任务在运行，请先确认要停止哪一个。请使用 cancel，不要直接中断应用，以便 write-swarm 保存补丁。

取消任务不会撤销已经完成的修改。
Ask 和 rescue 支持恢复会话。例如，/kimi:ask -r 解释下一步。 会继续最近一次 ask 会话。在 Codex 中，请 $kimi-ask 恢复该会话。参见 ask 参数和 rescue 参数。

使用 MCP 服务器

插件现在还内置了一个 MCP stdio 服务器，同时供 Claude Code 和 Codex 使用，与现有斜杠命令和技能并存。这些界面仍然可用，现有的安全钩子配置也仍是必需步骤。

七个模型工具是 kimi_ask、kimi_review、kimi_challenge、kimi_rescue、kimi_pursue、kimi_swarm 和 kimi_swarm_write。任务控制使用 kimi_job_status、kimi_job_result 和 kimi_job_cancel。

- Claude Code： 支持任务式调用的工具会返回持久 MCP 任务，通过 tasks/get 轮询，通过 tasks/cancel 取消。
- Codex： 目前使用普通 MCP 结果，而不是原生 MCP 任务。附加完成后，仍在运行的任务返回启动句柄；已结束的任务直接返回最终结果。使用上述三个任务控制工具查看进度、读取结果或取消任务。

Claude 默认提供项目目录作为工作区。如果宿主没有默认工作区（Codex 通常如此），首次操作必须提供绝对的 workspace 路径。之后的任务控制调用可以使用为该任务保存的工作区绑定关系。MCP 服务器断开连接不会取消任务。jobs 表是任务状态与结局的依据，最终产物（artifact）是结果内容的依据。任务失败时会返回 isError: true 以及相应产物。

例如：“使用 kimi_review 检查这次差异。在 Claude Code 中，用 tasks/get 轮询返回的任务；在 Codex 中，用返回的句柄调用 kimi_job_status，然后调用 kimi_job_result。”

更新或移除插件

在 Claude Code 中更新

打开 /plugin，刷新 kimi-marketplace，然后更新 kimi。再次运行 /kimi:setup，更新钩子的安装路径。

在 Codex 中更新

在终端运行：

codex plugin marketplace upgrade kimi-marketplace
codex plugin add kimi@kimi-marketplace

打开一个新任务，再次运行 $kimi-setup。

移除插件

先移除该应用的钩子，再移除插件。在 Claude Code 中运行 /kimi:setup --uninstall。在 Codex 中，请 $kimi-setup 卸载钩子。这不会移除另一个应用的钩子。

处理安装问题

如果钩子检查失败，请按诊断信息处理。提示需要重新配置时，在对应应用中运行 setup。不要绕过检查。

如果出现 KIMI_CAPABILITY_NOT_CERTIFIED，请更新插件，或改用已验证兼容的 CLI 版本。再次运行 setup 不能让新的 CLI 版本自动通过兼容性验证。

如果出现 CLI_V2_PLAN_MODE_CONFIGURED，请将 Kimi 的 config.toml 文件中的 default_plan_mode 设为 false，或删除该项。本插件运行的会话不能使用计划模式。

所有拒绝码及其处理方法见拒绝码目录。

了解安全限制

Ask、review、challenge 和只读 swarm 的工具规则禁止写入文件和执行 shell 命令。Rescue 和 pursue 可以修改工作区内的文件。带 --write 的 swarm 在临时 Git 工作树中操作。它从最新提交开始，不包含尚未提交的修改。任务结束后返回补丁，不会自动应用到项目。

在 CLI 2.3.2、2.3.3、2.4.0 和 2.4.1 上运行 swarm 时，插件会短暂启动需要认证的本地回环 kimi web 进程来激活会话，并在结束后再次启动以停用 swarm 模式；任务本身仍由一个普通的 kimi -p -r 进程执行。激活计入任务时限，访问令牌只保存在内存且不会写入日志；无法确认清理完成时，任务不会报告成功。较早的已认证版本仍直接通过 kimi -p 运行。

插件不会提交修改。保留或应用修改前，请先审查。

只在你信任的仓库中运行能修改文件的任务。Rescue、pursue 和带 --write 的 swarm 可以运行测试等命令。这些命令会执行仓库中的代码。钩子限制的是工具调用，它不是操作系统沙箱。

参见安全与限制、版本记录和后续计划。

参与开发

请先阅读贡献指南。运行时说明和项目约定介绍了实现方式。

每个版本都经过本插件所编排智能体的交叉审查——Kimi、Claude 与 Codex 互相审查彼此在本仓库中的工作，这一实践贯穿整个版本记录。

开发者需要使用 Bun 运行 bun run check。详细技术文档目前使用英文。

Français — Bien démarrer

Utiliser Kimi pour vos tâches de développement

Demandez à Kimi d'expliquer du code, de faire une revue de code, de remettre en question une approche ou de corriger un problème précis. Ce plugin fonctionne dans Claude Code, Codex et DeepSeek Harness (DSH).
插件在你的电脑上运行 Kimi Code CLI。它使用你的 Kimi 订阅，或 Kimi 中配置的服务商。调用会消耗你的订阅额度，或按你的 API 账户计费。与宿主应用的连接方式不变。选定的服务商会收到任务所需的提示词和代码。

先从提问或代码审查开始。这些模式允许读取文件，但禁止修改文件，也禁止执行 shell 命令。其他模式可以修改文件；DSH 要求其安装和配置档中已修正依赖（zod >=4.6.6、undici >=8.12.2）。安装本插件前，请先按安装与审计说明操作。

DSH 提供同样的七项操作，写入限制也相同。向 Kimi 请求修改前，请先阅读安全限制。安装方法见 DSH 英文指南。

准备安装

你需要：

- macOS 或 Linux
- 支持插件的 Claude Code、Codex 或 DSH 版本
- Node.js 22.5 或更高版本（DSH 需 24.9 或更高版本）
- Kimi Code CLI 2.4.1（已认证；2.4.0、2.3.3、2.3.2、2.3.1 和 2.3.0 也已认证）

目前不支持 Windows。在终端中检查版本：

node --version
kimi --version

如果未安装 CLI，请按 Kimi Code 安装指南（英文）操作。使用本插件不需要 Bun，也不需要编译步骤。

我们针对 CLI 的每个具体版本验证兼容性。CLI 发布新版本后，插件可能需要更新。请查看支持的版本与升级说明。

在终端中运行 kimi。使用 /login 登录 Kimi 订阅，或使用 /provider 配置 API 服务商。在 Kimi 中输入凭据，绝不要在助手对话中输入。配置完成后退出 Kimi。如果你设置了 KIMI_CODE_HOME，请让 Kimi 和插件使用同一位置。

在 Claude Code 中安装

在项目中打开 Claude Code。在 Claude Code 中输入以下命令：

/plugin marketplace add linxule/kimi-plugin-cc
/plugin install kimi@kimi-marketplace
/kimi:setup
/kimi:setup --check

Setup 会安装一个钩子，按插件规则检查 Kimi 的工具调用。Probe: 行应显示 ok。如果失败，请参阅下面的故障排查说明。

试一个不会修改任何文件的问题：

/kimi:ask 解释这个项目主入口的工作原理。

在 Codex 中安装

在终端中执行以下命令：

text
codex plugin marketplace add linxule/kimi-plugin-cc
codex plugin add kimi@kimi-marketplace

在项目里新建一个 Codex 任务，让它配置插件： text Utilise $kimi-setup pour installer le hook de sécurité, puis vérifie que tout est prêt.

钩子按插件规则检查 Kimi 的工具调用。Probe: 行应显示 ok。失败时，请参考下面的排障说明。然后试试： text Utilise $kimi-ask pour expliquer le fonctionnement du point d'entrée principal de ce projet.

如果你同时用 Claude Code 和 Codex，就在每个应用里各跑一次 setup。两者在共享的 Kimi 配置里各有自己的钩子。

安装到 DeepSeek Harness（DSH）

DSH 提供与其他宿主相同的七项操作：kimi_ask、kimi_review、kimi_challenge、kimi_rescue、kimi_pursue、kimi_swarm 和 kimi_swarm_write。它们共用同一个 companion 运行时、同一套安全钩子、任务、预算和产物。rescue 和 pursue 会改动选中的工作区；swarm-write 只返回补丁，不应用、不提交。

在本仓库的副本里执行： sh
dsh plugin --profile web add ./plugins/kimi-dsh

要安装已发布的根包，改用 dsh plugin --profile web add kimi-plugin-cc。

如有提示，重启 DSH，然后运行 /kimi-setup 和 /kimi-setup --check。让 DSH 用这七个工具之一执行一个自主任务。控制命令是 /kimi-status、/kimi-result 和 /kimi-cancel。/kimi-setup --models 列出已配置的模型，/kimi-setup --uninstall 只删除 DSH 钩子。

DSH 要求 Node.js 24.9 或更高版本，以及 DSH >=0.2.1-rc.5 <0.3.0。配置模型、思考强度、预算、评审基线和其他选项，请参阅 DSH 指南。

npm 分发（可选）

完整插件也发布在 npm 上，包名 kimi-plugin-cc，内含为 Claude Code、Codex 和 DSH 预编译的运行时，无需 Bun，也无需编译。上面的 marketplace 仍是默认安装方式。要通过 npm 在 Claude Code 里安装本地副本，请按 npm 步骤（英文）操作。每个应用只加载一份插件副本；该包不提供 npx kimi-plugin-cc 命令。Codex 请继续使用上面的 GitHub marketplace。

选择任务

| 任务 | Claude Code 命令 | Codex 技能 | 文件访问 |
| 解释代码 | /kimi:ask | $kimi-ask | 只读 |
| 评审改动 | /kimi:review | $kimi-review | 只读 |
| 质疑设计或方案 | /kimi:challenge | $kimi-challenge | 只读 |
| 修复某个具体问题 | /kimi:rescue | $kimi-rescue | 可以修改你的项目 |
| 同时检查多个部分 | /kimi:swarm | $kimi-swarm | 只读 |
| 并行准备改动 | /kimi:swarm --write | $kimi-swarm-write | 只在临时 Git worktree 中操作；返回补丁，由你自行应用 |
| 跨多轮推进一个目标 | /kimi:pursue | $kimi-pursue | 可以修改你的项目；实验性功能 |

Review 和 challenge 会检查你的 Git diff。一般性的仓库问题请用 ask。

Pursue 和 swarm 都有时间限制。swarm 并行执行任务，因此比单个任务消耗更多 token。

Claude Code propose aussi une revue automatique facultative. Elle vérifie le travail lorsque Claude termine un tour et reste désactivée par défaut.

Choisir un modèle

Les nouvelles sessions Kimi utilisent le modèle configuré par défaut. Précisez un modèle uniquement si vous souhaitez en utiliser un autre que celui par défaut.

Dans Claude Code, lancez /kimi:setup --models. Dans Codex, demandez à $kimi-setup de lister les modèles configurés. Cette opération lit la liste locale sans contacter les fournisseurs ni vérifier les identifiants. Un modèle de la liste peut échouer faute d'authentification, d'accès ou de prise en charge des outils.

Copiez un alias de modèle depuis la liste. Remplacez provider/model par cet alias :
text
/kimi:review -m 'provider/model' Vérifie la gestion des erreurs dans ces modifications.

Dans Codex, demandez : « Utilise $kimi-review avec mon modèle configuré nommé… ». Les deux applications acceptent les demandes de modèle en langage naturel. Si plusieurs modèles correspondent, l'assistant vous demande de choisir. Il ne devine pas les identifiants de modèle et ne change pas de modèle sans vous le dire après une erreur.

Pour tester un modèle de la liste, lancez une petite tâche avec son alias. Cela effectue un appel au fournisseur avec votre compte.

Le choix d'un modèle pour une tâche ne change pas votre modèle par défaut. Pour modifier ce dernier, lancez kimi et utilisez /model.

Une session reprise conserve son modèle, sauf si vous passez un autre alias avec -m. Pour swarm, -m choisit le modèle du coordinateur. Les agents chargés des sous-tâches peuvent utiliser d'autres modèles définis dans les paramètres de modèles secondaires de Kimi. Consultez le choix des modèles et la configuration des fournisseurs.

Suivre ou annuler une tâche

Utilisez ces commandes pour suivre une tâche :

| Action | Commande Claude Code | Skill Codex |
| Voir la progression | /kimi:status | $kimi-status |
| Afficher le résultat | /kimi:result | $kimi-result |
| Annuler la tâche | /kimi:cancel | $kimi-cancel |

Sans identifiant de tâche, cancel arrête la dernière tâche lancée qui est encore active dans ce dépôt. Si plusieurs tâches sont en cours, vérifiez d'abord celle que vous souhaitez arrêter. Utilisez cancel au lieu d'interrompre l'application pour laisser write-swarm enregistrer son patch.

Annuler une tâche n'annule pas les modifications déjà effectuées.

Ask et rescue permettent de reprendre une session. Par exemple, /kimi:ask -r Explique l'étape suivante. reprend votre dernière session ask. Dans Codex, demandez à $kimi-ask de la reprendre. Consultez les options d'ask et les options de rescue.

Utiliser le serveur MCP

Le plugin intègre aussi un serveur MCP stdio unique pour Claude Code et Codex, en plus des commandes slash et skills existants. Ces interfaces restent disponibles et la configuration du hook de sécurité reste obligatoire.

Les sept outils de modèle sont kimi_ask, kimi_review, kimi_challenge, kimi_rescue, kimi_pursue, kimi_swarm et kimi_swarm_write. Le contrôle des tâches utilise kimi_job_status, kimi_job_result et kimi_job_cancel.

- Claude Code : les appels compatibles avec les tâches renvoient des tâches MCP durables. Interrogez-les avec tasks/get et annulez-les avec tasks/cancel.
- Codex : les appels utilisent actuellement des résultats MCP ordinaires, et non des tâches MCP natives. Après l'attachement, un job encore actif renvoie un handle de lancement ; un job déjà terminé renvoie directement son résultat final. Utilisez les trois outils de contrôle pour suivre, lire ou annuler le job.

Claude fournit le répertoire du projet comme espace de travail par défaut. Sans espace de travail par défaut côté hôte, ce qui est normal pour Codex, l'opération initiale exige un chemin workspace absolu. Les contrôles ultérieurs peuvent utiliser l'association enregistrée entre la tâche et l'espace de travail. Une déconnexion du serveur MCP n'annule pas les tâches. La table jobs fait autorité pour l'état et l'issue des jobs ; l'artefact final fait autorité pour le contenu du résultat. Une tâche en échec renvoie isError: true avec ses artefacts.

Par exemple : « Utilise kimi_review pour vérifier ce diff. Dans Claude Code, interroge la tâche renvoyée avec tasks/get ; dans Codex, utilise le handle renvoyé avec kimi_job_status, puis kimi_job_result. »

Mettre à jour ou supprimer le plugin

Mettre à jour dans Claude Code

Ouvrez /plugin, actualisez kimi-marketplace et mettez kimi à jour. Relancez /kimi:setup pour mettre à jour le chemin d'installation du hook.

Mettre à jour dans Codex

Exécutez ces commandes dans un terminal :
sh
codex plugin marketplace upgrade kimi-marketplace
codex plugin add kimi@kimi-marketplace

Ouvrez une nouvelle tâche et relancez $kimi-setup.

Supprimer le plugin

Supprimez le hook de l'application avant d'en retirer le plugin. Dans Claude Code, lancez /kimi:setup --uninstall. Dans Codex, demandez à $kimi-setup de désinstaller le hook. Celui de l'autre application reste en place.

Résoudre les problèmes d'installation

Si la vérification du hook échoue, suivez le diagnostic. Relancez setup dans l'application concernée lorsque les instructions le demandent. Ne contournez pas la vérification.

Si vous voyez KIMI_CAPABILITY_NOT_CERTIFIED, mettez à jour le plugin ou utilisez une version du CLI dont la compatibilité a été vérifiée. Relancer setup ne valide pas la compatibilité d'une nouvelle version du CLI.

Si vous voyez CLI_V2_PLAN_MODE_CONFIGURED, réglez default_plan_mode sur false ou supprimez cette option du fichier config.toml de Kimi. Les sessions lancées par ce plugin ne peuvent pas utiliser le mode plan.

Tous les codes de refus et leurs remèdes sont répertoriés dans le catalogue des codes de refus.

Comprendre les limites de sécurité

Les règles des modes ask, review, challenge et swarm en lecture seule interdisent les écritures et les commandes shell. Rescue et pursue peuvent modifier les fichiers de votre espace de travail. Swarm avec --write travaille dans un worktree Git temporaire. Il part du dernier commit et n'inclut donc pas les modifications non commitées. Il renvoie un patch sans l'appliquer à votre projet.

Avec le CLI 2.3.2, 2.3.3, 2.4.0 et 2.4.1, les tâches swarm lancent brièvement un processus kimi web authentifié sur l'interface de boucle locale pour activer la session, puis un second pour désactiver le mode swarm ; un seul processus kimi -p -r ordinaire exécute toujours la tâche. L'activation est comptée dans la limite de temps, le jeton reste en mémoire et hors des journaux, et l'échec du nettoyage empêche de déclarer la réussite. Les versions certifiées antérieures utilisent directement kimi -p.

Le plugin ne crée aucun commit. Examinez les modifications avant de les conserver ou de les appliquer.

N'utilisez les tâches pouvant écrire des fichiers que dans des dépôts auxquels vous faites confiance. Rescue, pursue et swarm avec --write peuvent lancer des tests et des commandes similaires. Ces commandes exécutent du code du dépôt. Le hook limite l'utilisation des outils ; ce n'est pas un bac à sable du système d'exploitation.

Consultez les limites de sécurité, l'historique des versions et les travaux prévus.

Contribuer

Commencez par le guide de contribution. La présentation du runtime et les règles du projet expliquent l'implémentation.

Chaque version fait l'objet d'une relecture croisée par les agents que ce plugin orchestre — Kimi, Claude et Codex révisent mutuellement leur travail sur ce dépôt, une pratique documentée dans l'ensemble du journal des versions.

Les contributeurs ont besoin de Bun pour exécuter bun run check. La documentation technique détaillée est en anglais.

日本語 — はじめに

Kimi を開発に使う

コードの説明、変更のレビュー、設計の問題点の指摘、範囲を絞った修正を Kimi に依頼できます。このプラグインは Claude Code、Codex、DeepSeek Harness（DSH）で使えます。

プラグインは、お使いのコンピューターで Kimi Code CLI を実行します。Kimi のサブスクリプション、または Kimi に設定したプロバイダーを利用します。呼び出しは、そのサブスクリプションの利用枠を消費するか、API アカウントに課金されます。ホストアプリのログイン状態は変わりません。タスクに必要なプロンプトとコードは、選択したプロバイダーに送信されます。

まずは質問かコードレビューを試してください。これらのモードではファイルの読み取りを許可し、書き込みとシェルコマンドの実行を禁止しています。ほかのモードではファイルを変更できます。DSH でも同じ 7 種類の操作を同じ書き込み範囲で提供します。変更を依頼する前に、安全上の制限を確認してください。DSH のインストール方法は英語の案内を参照してください。

インストール前の準備

次の環境が必要です。

- macOS または Linux
- プラグインに対応した Claude Code、Codex、または DSH
- Node.js 22.5 以降（DSH では 24.9 以降）
- Kimi Code CLI 2.4.1（認証済み。2.4.0、2.3.3、2.3.2、2.3.1 と 2.3.0 も認証済み）

現在、Windows には対応していません。ターミナルでバージョンを確認します。
sh
node --version
kimi --version

CLI が未インストールの場合は、Kimi Code のインストールガイド（英語）を参照してください。プラグインを使うために Bun やビルド作業は必要ありません。

互換性は CLI のバージョンごとに検証しています。CLI を更新すると、プラグインの更新も必要になる場合があります。対応バージョンと更新手順を参照してください。

ターミナルで kimi を実行します。Kimi のサブスクリプションを使う場合は /login、API プロバイダーを設定する場合は /provider を使います。認証情報は Kimi に入力し、アシスタントとの会話には送らないでください。設定が終わったら Kimi を終了します。KIMI_CODE_HOME を設定している場合は、Kimi とプラグインで同じ場所を使ってください。

Claude Code にインストールする

プロジェクトで Claude Code を開き、Claude Code 内で次のコマンドを入力します。
text
/plugin marketplace add linxule/kimi-plugin-cc
/plugin install kimi@kimi-marketplace
/kimi:setup
/kimi:setup --check

Setup は、Kimi のツール呼び出しをプラグインのルールに照らして確認するフックをインストールします。正常であれば Probe: 行に ok と表示されます。失敗した場合は、後述の「設定の問題を解決する」を参照してください。

ファイルを変更しない質問を試します。
text
/kimi:ask このプロジェクトのメインのエントリーポイントがどう動くか説明してください。

Codex にインストールする

ターミナルで次のコマンドを実行します。
sh
codex plugin marketplace add linxule/kimi-plugin-cc
codex plugin add kimi@kimi-marketplace

プロジェクトで Codex の新しいタスクを開き、設定を依頼します。
text
$kimi-setup を使って安全フックをインストールし、設定を確認してください。

フックは Kimi のツール呼び出しをプラグインのルールに照らして確認します。正常であれば Probe: 行に ok と表示されます。失敗した場合は、後述の「設定の問題を解決する」を参照してください。続いて、次の依頼を試します。
text
$kimi-ask を使って、このプロジェクトのメインのエントリーポイントがどう動くか説明してください。

Claude Code と Codex の両方を使う場合は、それぞれで setup を実行します。共通の Kimi 設定内に、各アプリ専用のフックが作られます。

DeepSeek Harness（DSH）にインストールする

DSH 本体とプロファイルの依存パッケージには修正版（zod >=4.6.6、undici >=8.12.2）が必要です。プラグインのインストール前に本体のインストールと監査の手順を確認してください。

DSH でも、ほかのホストと同じ 7 種類の操作を提供します：kimi_ask、kimi_review、kimi_challenge、kimi_rescue、kimi_pursue、kimi_swarm、kimi_swarm_write。同じ companion ランタイム、安全フック、ジョブ、予算、成果物を使用します。Rescue と pursue は選択したワークスペースを変更し、swarm-write はパッチを返すだけで、適用やコミットは行いません。

このリポジトリのチェックアウトからインストールする場合： sh
dsh plugin --profile web add ./plugins/kimi-dsh

公開されているルートパッケージからインストールする場合は、代わりに dsh plugin --profile web add kimi-plugin-cc を実行します。

案内に従って DSH を再起動したら、/kimi-setup と /kimi-setup --check を実行します。独立した内容のタスクを指定して、上記のいずれかのツールを使ってください。ジョブ制御は /kimi-status、/kimi-result、/kimi-cancel です。/kimi-setup --models で設定済みモデルを一覧でき、/kimi-setup --uninstall は DSH のフックだけを削除します。

DSH には Node.js 24.9 以降と、DSH >=0.2.1-rc.5 <0.3.0 が必要です。モデル、思考強度、予算、review base などの設定は DSH ガイドを参照してください。

npm 配布（任意）

完全なプラグインは npm の kimi-plugin-cc としても公開されています。Claude Code、Codex、DSH 向けのコンパイル済みランタイムを含み、Bun やビルド作業は不要です。通常は上記のマーケットプレイス経由でインストールしてください。npm から Claude Code 用のローカルコピーを入れる場合は、npm のインストール手順（英語）を参照してください。各アプリで読み込むプラグインは一つにし、重複させないでください。npx kimi-plugin-cc コマンドはありません。Codex では引き続き上記の GitHub マーケットプレイスを使います。

タスクを選ぶ

| タスク | Claude Code コマンド | Codex スキル | ファイル操作の範囲 |
| コードを説明する | /kimi:ask | $kimi-ask | 読み取り専用 |
| コードの変更をレビューする | /kimi:review | $kimi-review | 読み取り専用 |
| 設計や方針の問題点を検討する | /kimi:challenge | $kimi-challenge | 読み取り専用 |
| 範囲を絞って修正する | /kimi:rescue | $kimi-rescue | プロジェクトのファイルを変更可能 |
| 複数の箇所を同時にレビューする | /kimi:swarm | $kimi-swarm | 読み取り専用 |
| 複数の変更を並行して準備する | /kimi:swarm --write | $kimi-swarm-write | 一時的な Git ワークツリー内のみ変更し、適用用のパッチを返す |
| 複数ターンにわたって目標に取り組む | /kimi:pursue | $kimi-pursue | プロジェクトのファイルを変更可能（実験的機能） |

Review と challenge は Git の差分を確認します。リポジトリ全般に関する質問には ask を使ってください。

Pursue と swarm には実行時間の上限があります。Swarm はタスクを並行して実行するため、単一のタスクよりトークンを多く消費する場合があります。

Claude Code には、任意で有効にできる自動レビュー機能もあります。Claude が応答を終えると作業内容を確認します。初期状態では無効です。

モデルを選ぶ

新しい Kimi セッションでは、設定済みのデフォルトモデルを使います。別のモデルを使いたい場合だけ指定してください。

Claude Code では /kimi:setup --models を実行します。Codex では $kimi-setup に設定済みモデルの一覧表示を依頼します。この操作はローカルの一覧を読み取るだけで、プロバイダーへの接続や認証情報の検証は行いません。一覧にあるモデルでも、認証、アクセス権、ツール対応の問題で使えない場合があります。

一覧からモデルのエイリアスをコピーし、次の provider/model と置き換えます。
text
/kimi:review -m 'provider/model' この差分のエラー処理を確認してください。

Codex では「$kimi-review を使い、設定済みの『……』というモデルでレビューしてください」と依頼できます。どちらのアプリでも、自然言語でモデルを指定できます。複数のモデルが該当する場合は、アシスタントが選択を求めます。モデル ID を推測したり、エラーの後に黙って別のモデルに切り替えたりはしません。

一覧のモデルを試すには、そのエイリアスで小さなタスクを実行します。あなたのアカウントでプロバイダーへの呼び出しが発生します。

タスクごとにモデルを指定しても、保存済みのデフォルト設定は変わりません。デフォルトモデルを変更するには、kimi を実行して /model を使います。

再開したセッションは、-m で別のエイリアスを指定しない限り、以前のモデルを使います。Swarm の -m は調整役のエージェントが使うモデルを指定します。子タスクを担当するエージェントは、Kimi のセカンダリモデル設定に基づく別のモデルを使う場合があります。モデルの選択とプロバイダーの設定を参照してください。

進捗の確認とタスクのキャンセル

次のコマンドでタスクを確認できます。

| 操作 | Claude Code コマンド | Codex スキル |
| 進捗を確認する | /kimi:status | $kimi-status |
| 結果を確認する | /kimi:result | $kimi-result |
| タスクをキャンセルする | /kimi:cancel | $kimi-cancel |

タスク ID を指定しない場合、cancel はこのリポジトリで実行中のタスクのうち、最後に開始したものを停止します。複数のタスクが動いている場合は、停止する対象を先に確認してください。write-swarm がパッチを保存できるよう、アプリを強制中断せずに cancel を使ってください。

タスクをキャンセルしても、すでに行われた変更は元に戻りません。

Ask と rescue はセッションの再開に対応しています。たとえば /kimi:ask -r 次の手順を説明してください。 は、直近の ask セッションを続けます。Codex では $kimi-ask に再開を依頼してください。ask のオプションと rescue のオプションを参照できます。

MCP サーバーを使う

プラグインには、既存のスラッシュコマンドとスキルに加え、Claude Code と Codex の両方で使える MCP stdio サーバーが 1 つ同梱されています。既存のコマンドとスキルも引き続き使え、既存の安全フックの設定も必須です。

7 つのモデルツールは kimi_ask、kimi_review、kimi_challenge、kimi_rescue、kimi_pursue、kimi_swarm、kimi_swarm_write です。ジョブ制御には kimi_job_status、kimi_job_result、kimi_job_cancel を使います。

- Claude Code： タスク対応の呼び出しは永続的な MCP タスクを返します。tasks/get でポーリングし、tasks/cancel でキャンセルします。
- Codex： 現在はネイティブの MCP タスクではなく、通常の MCP 結果を使います。アタッチ後、実行中のジョブには起動ハンドルを返し、すでに終了したジョブには最終結果を直接返します。進捗確認・結果取得・キャンセルには 3 つのジョブ制御ツールを使います。

Claude はプロジェクトディレクトリをデフォルトのワークスペースとして提供します。ホスト側にデフォルトがない場合（Codex ではこれが通常です）、最初の操作では絶対パスの workspace が必要です。後続のジョブ制御では、そのジョブに保存されたワークスペースの関連付けを利用できます。MCP サーバーとの接続が切れても、ジョブはキャンセルされません。jobs テーブルがジョブの状態と結果を管理し、最終成果物（artifact）が結果内容の正規の情報源となります。失敗したジョブも成果物とともに isError: true を返します。

例：「kimi_review でこの差分を確認してください。Claude Code では返されたタスクを tasks/get でポーリングし、Codex では返されたハンドルを使って kimi_job_status、kimi_job_result の順に呼び出してください。」

プラグインを更新または削除する

Claude Code で更新する

/plugin を開き、kimi-marketplace の情報を更新してから kimi を更新します。/kimi:setup を再実行して、フックのインストール先を更新してください。

Codex で更新する

ターミナルで次のコマンドを実行します。
sh
codex plugin marketplace upgrade kimi-marketplace
codex plugin add kimi@kimi-marketplace

新しいタスクを開いて $kimi-setup を再実行します。

プラグインを削除する

プラグインを削除する前に、そのアプリのフックを削除します。Claude Code では /kimi:setup --uninstall を実行します。Codex では $kimi-setup にフックのアンインストールを依頼してください。もう一方のアプリのフックは残ります。

設定の問題を解決する

フックの確認に失敗した場合は、診断結果に従って対処してください。Setup の実行を指示された場合は、該当するアプリで実行します。確認を回避しないでください。

KIMI_CAPABILITY_NOT_CERTIFIED が表示されたら、プラグインを更新するか、互換性を検証済みの CLI バージョンを使ってください。Setup を再実行しても、新しい CLI の互換性が検証済みになるわけではありません。

CLI_V2_PLAN_MODE_CONFIGURED が表示されたら、Kimi の config.toml で default_plan_mode を false にするか、その項目を削除してください。このプラグインが実行するセッションではプランモードを使えません。

すべての拒否コードと対処方法は、拒否コードの一覧にまとめています。

安全上の制限を理解する

Ask、review、challenge、読み取り専用 swarm のツールルールでは、ファイルへの書き込みとシェルコマンドを禁止しています。Rescue と pursue はワークスペース内のファイルを変更できます。--write を指定した swarm は、一時的な Git ワークツリーで作業します。最新のコミットから開始するため、未コミットの変更は含まれません。パッチを返すだけで、プロジェクトには自動適用しません。

CLI 2.3.2 / 2.3.3 / 2.4.0 / 2.4.1 の swarm では、セッションを有効化するため、そして終了後に swarm モードを無効化するため、認証付きのローカルループバック kimi web プロセスをそれぞれ短時間だけ起動します。タスク自体は従来どおり 1 つの kimi -p -r プロセスが実行します。有効化も制限時間に含まれ、トークンはメモリー内にのみ保持されてログには出ません。後処理を確認できない場合、タスクは成功と報告されません。以前の認証済みバージョンでは、引き続き kimi -p を直接使います。

プラグインは変更をコミットしません。変更を残す、または適用する前に内容を確認してください。

ファイルを書き換えるタスクは、信頼できるリポジトリでのみ実行してください。Rescue、pursue、--write 付きの swarm は、テストなどのコマンドを実行できます。これらのコマンドはリポジトリ内のコードを実行します。フックはツールの使用を制限しますが、OS のサンドボックスではありません。

安全上の制限、リリース履歴、今後の予定も参照してください。

開発に参加する

まず開発への参加ガイドを参照してください。ランタイムの概要とプロジェクトの規約に実装の説明があります。

各リリースは、このプラグインがオーケストレーションするエージェント同士の相互レビューを経ています。Kimi、Claude、Codex がこのリポジトリで互いの作業をレビューしており、その実践はリリース履歴全体に記録されています。

開発時の bun run check には Bun が必要です。詳しい技術文書は英語で提供しています。

This plugin uses Kimi Code. Its runtime design draws on OpenAI's codex-plugin-cc. It is licensed under Apache-2.0.