适合谁
- 需要在终端中使用多模型协同完成编码任务的开发者
- 已经使用 AGENTS.md 标准或希望迁移自其他终端 AI 编程工具的团队
- 希望通过 MCP 客户端能力为编码代理接入自定义外部工具/数据源的用户
K
44FMRS · D
Kode 是一个功能丰富的终端多模型 AI 编程 CLI，其 "MCP Extensions" 特性是作为客户端连接外部 MCP 服务器以扩展自身能力，而不是自身作为可被其他客户端调用的 MCP 服务器；源材料中未提供任何 Kode 自身暴露的 MCP 工具清单或服务器manifest，因此工具列表与传输方式留空。默认 YOLO 权限模式和第三方插件/模型集成是使用前需要重点评估的风险点。
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 月处于重大维护与重构阶段。
工具能力
暂未整理工具清单。
安装接入
- 全局安装：
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 配置文件以便团队共享。
选型与风险
不适合谁
- 需要将某个服务以 MCP 服务器形式暴露给 Claude Desktop 等 MCP 客户端调用的场景（Kode 本身不提供该功能）
- 要求默认严格权限控制、不希望命令与文件写入被自动放行的安全敏感环境（需手动开启 --safe）
- 只需要单一固定模型、无需多模型编排能力的轻量用例
所需权限
- 读写工作目录及其子目录中的文件（编辑、创建代码文件等）
- 执行 Shell/Bash 命令（默认 YOLO 模式下无需逐条确认）
- 发起网络请求：调用配置的模型 API、可选的网页工具、插件/技能市场下载、可选的更新检查
- （可选）在 --safe 或 KODE_SYSTEM_SANDBOX=1 下，Linux 使用 bwrap 沙箱运行 Bash 命令，默认禁用网络
风险与副作用
- 默认 YOLO 模式跳过权限确认，模型可能在用户未逐条批准的情况下修改文件或执行破坏性命令
- 连接的外部 MCP 服务器、安装的插件/技能来自第三方市场，可能引入不受信任的代码执行路径
- 多模型编排意味着代码与上下文会被发送至用户配置的各个第三方模型 API，需自行评估数据出境/隐私合规风险
- 项目明确处于 2026 年 7-12 月的重大重构维护期，接口、命令或配置格式可能发生变化
常见排障
- 若使用 --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 模型协同工作
通过 .kode/agents 定义可复用的子代理模板，用于代码审查、重构等委派任务
接入外部 MCP 服务器（如文件系统、数据库、浏览器等）以扩展 Kode 自身可用的工具集
通过 kode-acp 以 Agent Client Protocol 方式集成进 Zed、Toad 等支持 ACP 的编辑器
支持客户端
暂未确认支持的客户端。