Kode CLI

社区

多模型协同的终端 AI 编程助手，可作为客户端接入外部 MCP 服务器

分类: 开发工具第 315 / 438
Stars: ★ 5.2k 非常热门
运行环境: Node.js
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 1 天前

44FMRS · D

Kode 是一个功能丰富的终端多模型 AI 编程 CLI，其 "MCP Extensions" 特性是作为客户端连接外部 MCP 服务器以扩展自身能力，而不是自身作为可被其他客户端调用的 MCP 服务器；源材料中未提供任何 Kode 自身暴露的 MCP 工具清单或服务器manifest，因此工具列表与传输方式留空。默认 YOLO 权限模式和第三方插件/模型集成是使用前需要重点评估的风险点。

最强项 · 文档质量 13/20 最弱项 · 安全与权限 3/20

可靠性

5/20

安全与权限

3/20

维护活跃度

11/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 5/20: 未提供服务器清单（manifest未缓存），README显示Kode本质上是一个终端编码代理CLI，它作为MCP客户端去连接外部MCP服务器（`kode mcp add/list/remove`），而非实现一个可被审查的MCP服务器本身，因此无法核实任何MCP初始化/工具列表握手行为。README提到`bun test`可运行测试、有GitHub Releases，但仓库中没有随附的CI工作流或测试文件作为可验证证据，属于静态审查下的弱证据。按静态校准规则，在缺乏可验证执行证据的情况下可靠性不应超过12分，鉴于该对象与'MCP服务器'定位本身存在错配且证据链非常薄弱，评为5分。
安全与权限 3/20: README明确声明'Kode默认以YOLO模式运行以获得最大生产力'，即默认跳过写入和命令执行的权限确认提示，只有显式使用`kode --safe`或设置`KODE_SYSTEM_SANDBOX=1`才会启用bwrap沙箱和权限检查；默认沙箱状态下网络也是开启的（'network disabled by default'仅在沙箱模式下生效）。这意味着一个具备Bash执行、文件写入能力的自主代理，在默认配置下无需用户确认即可执行不可逆的本地命令/文件更改，属于评分标准中的红线情形（'remote-command defaults without confirmation'的本地等价物）。虽然README声明默认无遥测且网络请求仅限模型API/工具/插件下载，一定程度上说明设计者意识到风险并给出了`--safe`选项，但默认行为本身仍构成重大、未缓解的风险，故评为3分（红线区间0-4分）。
维护活跃度 11/20: 项目采用Apache-2.0许可证，通过npm发布并维护Release页面，README中也引用了CONTRIBUTING.md，显示存在一定治理结构。但'Open issues: 0'与5201星标的热门项目不太匹配，可能意味着issue跟踪被关闭或清空，透明度存疑，且未见安全问题反馈渠道的具体说明。README底部注明'2026年7月至12月Kode正在经历重大维护和重构阶段'，虽然表明团队仍在积极投入，但也提示当前处于不稳定过渡期，可能影响短期可靠性。综合给11分。
文档质量 13/20: README结构清晰，覆盖安装、快速开始、多模型协作、Agent/Subagent、Skills/Plugins、MCP扩展、权限与安全、配置、Docker和开发流程等章节，并给出了具体的配置文件路径和命令示例。但工具参数的详细说明（如MCP服务器的完整配置字段、各Agent工具的权限粒度）依赖外部docs/目录，正文中未展示；也缺少成本、限制条件和故障排查的具体案例（仅提及`/cost`命令）。总体可用但存在隐藏假设和证明缺口，评为13分。
安装易用性 12/20: 安装路径明确（`npm install -g @shareai-lab/kode`），并提供中国镜像、开发频道、独立二进制文件和Docker等多种备选方案，覆盖主流平台。但该对象本身并非以MCP服务器形式提供给客户端调用，而是作为CLI工具去连接外部MCP服务器，因此'在主流客户端中建立MCP连接'这一维度缺乏直接对应的配置示例；同时提到依赖平台相关的`ripgrep`原生二进制（optionalDependencies），在`--no-optional`场景下需要额外手动设置`KODE_RIPGREP_PATH`，存在一定脆弱性。按静态校准规则，无可验证执行证据时setup不应超过15分，综合评为12分。

静态评测 · 未实际运行收录于 2026-08-06

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络

适合谁

需要在终端中使用多模型协同完成编码任务的开发者
已经使用 AGENTS.md 标准或希望迁移自其他终端 AI 编程工具的团队
希望通过 MCP 客户端能力为编码代理接入自定义外部工具/数据源的用户

不适合谁

需要将某个服务以 MCP 服务器形式暴露给 Claude Desktop 等 MCP 客户端调用的场景（Kode 本身不提供该功能）
要求默认严格权限控制、不希望命令与文件写入被自动放行的安全敏感环境（需手动开启 --safe）
只需要单一固定模型、无需多模型编排能力的轻量用例

所需权限

读写工作目录及其子目录中的文件（编辑、创建代码文件等）
执行 Shell/Bash 命令（默认 YOLO 模式下无需逐条确认）
发起网络请求：调用配置的模型 API、可选的网页工具、插件/技能市场下载、可选的更新检查
（可选）在 --safe 或 KODE_SYSTEM_SANDBOX=1 下，Linux 使用 bwrap 沙箱运行 Bash 命令，默认禁用网络

风险与副作用

默认 YOLO 模式跳过权限确认，模型可能在用户未逐条批准的情况下修改文件或执行破坏性命令
连接的外部 MCP 服务器、安装的插件/技能来自第三方市场，可能引入不受信任的代码执行路径
多模型编排意味着代码与上下文会被发送至用户配置的各个第三方模型 API，需自行评估数据出境/隐私合规风险
项目明确处于 2026 年 7-12 月的重大重构维护期，接口、命令或配置格式可能发生变化

安装接入

准备工作

运行环境：Node.js

其他可选配置项（4 个）

KODE_RIPGREP_PATH 可选当使用 --no-optional 安装时，指定系统 ripgrep (rg) 的路径；未用 --no-optional 安装则无需设置。

KODE_CONFIG_DIR 可选覆盖全局配置目录位置（默认 ~/.kode. 所在目录），可选。

KODE_SYSTEM_SANDBOX 可选设为 1 时在 Linux 上通过 bwrap 沙箱运行 Bash 命令（默认禁网），可选。

KODE_PROJECT_DOC_MAX_BYTES 可选覆盖 AGENTS.md 文档拼接的 32 KiB 上限，可选。

全局安装：npm install -g @shareai-lab/kode（中国大陆用户可加 --registry=https://registry.npmmirror.com）；也可从 GitHub Releases 下载 Bun 编译的独立二进制文件。
运行 kode 进入交互模式，或用 kode -p "..." file.js 进行一次性任务。
若需要 Kode 连接外部 MCP 服务器以扩展能力，运行 kode mcp add 按提示添加，或直接编辑项目根目录的 .mcp.json 文件，添加形如 {"my-server": {"type": "sse", "url": "http://127.0.0.1:3333/sse"}} 的条目；用 kode mcp list 确认连接状态。
通过 /model 或 kode models 系列命令配置各角色（main/task/compact/quick）使用的模型与 API Key，可导出/导入不含明文密钥的 YAML 配置文件以便团队共享。

验证是否装好

安装后运行 `kode` 启动交互模式，若出现终端 UI 并能用 `/help` 列出命令，或运行 `kode mcp list` 能列出已连接的 MCP 服务器，即说明安装成功。

常见排障

若使用 --no-optional 安装导致内置 ripgrep 不可用，需安装系统 rg 或设置 KODE_RIPGREP_PATH 环境变量
连接外部 MCP 服务器失败时，检查项目根目录 .mcp.json 或 .mcprc 中的地址、类型（如 sse）配置，并用 kode mcp list 核实连接状态
模型调用异常时，用 kode models list 检查各角色（main/task/compact/quick）指针是否正确指向已配置的模型
在 Linux 下若命令因沙箱被限制（如无网络），确认是否处于 --safe 或 KODE_SYSTEM_SANDBOX=1 模式，按需调整
AGENTS.md/CLAUDE.md 未生效时，确认文件位于从仓库根目录到当前工作目录的路径链上，且总大小未超过 32 KiB（可用 KODE_PROJECT_DOC_MAX_BYTES 调整）

试试这样问

连接成功后，可以直接对 AI 助手这样说：

解释这个函数的作用
用 o3 设计消息队列架构
让 Claude Opus 4.1 分析这个内存泄漏问题
切换到 Kimi k2 进行代码审查

使用场景

在终端中理解代码库结构、编辑文件、执行命令并编排多步开发工作流

为不同任务（架构设计、代码实现、专家咨询）指派不同的 AI 模型协同工作

通过 .kode/agents 定义可复用的子代理模板，用于代码审查、重构等委派任务

接入外部 MCP 服务器（如文件系统、数据库、浏览器等）以扩展 Kode 自身可用的工具集

通过 kode-acp 以 Agent Client Protocol 方式集成进 Zed、Toad 等支持 ACP 的编辑器

详细介绍

Kode（@shareai-lab/kode）是一个终端 AI 编程代理 CLI，定位为"面向后人类工作流的单元代理"。它本身不是一个对外暴露工具的 MCP 服务器，而是一个 MCP 客户端：用户可通过 kode mcp add、kode mcp list、kode mcp remove 命令，或在项目根目录的 .mcp.json（如 {"my-server": {"type": "sse", "url": "..."}}）中配置并连接外部 MCP 服务器，从而扩展 Kode 自身的能力。除此之外，Kode 支持在单次会话中编排 20+ 种 AI 模型（主对话、子代理、压缩、快速任务等角色分别指定模型）、通过 @run-agent-* 调用可复用的子代理模板、通过 .kode/skills 加载技能与插件，并兼容 AGENTS.md / CLAUDE.md 项目说明文件标准。它还提供独立的 kode-acp 命令，通过 stdio JSON-RPC 实现 Agent Client Protocol（ACP，供 Toad、Zed 等编辑器客户端调用），但这是与 MCP 不同的协议。默认以"YOLO 模式"运行（跳过大部分权限确认），可用 kode --safe 启用审批流程与 Linux 下的 bwrap 沙箱。仓库自述文件中说明该项目从 2026 年 7 月至 12 月处于重大维护与重构阶段。