Kimi Code CLI 的 IDE 集成指南：通过 ACP 协议在 Zed、JetBrains 与 Paseo 中运行

AI Agent代码智能体人工智能大模型CLI【免费下载链接】kimi-codeKimi Code CLI — The Starting Point for Next-Gen Agents项目地址https://gitcode.com/gh_mirrors/ki/kimi-code点击查看免费下载Kimi Code CLI 通过 Agent Client ProtocolACP将终端中的 AI Agent 能力暴露给 IDEZed、JetBrains 系列与 Paseo 等客户端以子进程方式拉起kimi acp在标准输入/输出上以 JSON-RPC 交换会话、prompt 与工具调用。本文基于 docs/zh/guides/ides.md 展开完整覆盖三种客户端的配置步骤、底层实现原理与故障排查方法读完即可在编辑器中直接使用 Kimi Code CLI 完成 AI 辅助编程。前置准备安装与登录在配置任何 IDE 之前请先确保 Kimi Code CLI 已安装并完成登录配置。安装方式有两种详见 开始使用# 官方安装脚本macOS / Linux无需预装 Node.js curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash # 或通过 npm 全局安装需要 Node.js 22.19.0 npm install -g moonshot-ai/kimi-code首次启动时在 TUI 中输入/login完成登录可选择 Kimi CodeOAuth 验证码流程或 Kimi Platform API 密钥两种方式。登录成功后本地凭证默认保存在~/.kimi-code/下可通过KIMI_CODE_HOME环境变量重定向后续 IDE 创建的每次会话都会复用这份鉴权状态——无需重复登录。路径提示重要macOS 下从 IDE GUI 启动的子进程通常不会继承终端 shell 的PATH。如果kimi不在/usr/local/bin这类系统目录中IDE 配置里必须使用绝对路径。在终端运行which kimi即可查到当前生效的可执行路径。ACP 接入原理kimi acp如何工作子进程入口与启动方式ACP server 以子命令kimi acp暴露。在 apps/kimi-code/src/cli/sub/acp.ts 的实现中该命令将 CLI 切换到 ACP 模式通过runAcpServer()启动一个运行在 stdio 上的 JSON-RPC server直接以agent-core-v2引擎驱动会话。启动后命令不会打印任何 banner立即等待 ACP 客户端在 stdin 上发出initialize请求日志写入 stderr以及~/.kimi-code/logs/下的诊断日志保证 ACP 通道本身干净。kimi acp还提供了两个额外的启动选项主要用于 IDE 侧的登录流程选项说明--login运行 device-code 登录流程后立即退出是 ACP terminal-auth 的入口--region region配合--login指定登录区域mainland-cnkimi.com或globalkimi.ai源码中还会自动完成两件事若设置了KIMI_CODE_HOME会将其转发进authMethods[0].env保证登录子进程写入的 token 与 server 读取的数据根目录一致同时把process.argv[1]当前二进制的绝对路径声明为旧式_meta[terminal-auth].command回退供尚未支持一等type:terminal鉴权方法的客户端使用。initialize协商与能力矩阵客户端发出initialize后server 在 packages/acp-server/src/server.ts 中返回protocolVersion、agentCapabilities、authMethods与agentInfo{ name: Kimi Code CLI, version }。能力矩阵包括loadSession: true支持session/load续接已有会话并回放历史promptCapabilities支持image内容块与embeddedContextresource/resource_link注入不支持audiosessionCapabilities支持list、resume、close、delete、fork与additionalDirectoriesmcpCapabilitieshttp: true、sse: truestdio 是 ACP 的隐含基线无需声明auth: { logout: {} }支持 ACPlogout。完整的 ACP 方法覆盖与能力说明见 kimi acp 参考core3/3与 session11/11agent 侧方法全部实现客户端 reverse-RPC 实现 10/11另含session/set_model扩展方法未实现的providers/*、nes/*、document/*与elicitation/complete一律返回methodNotFound。这些契约在 packages/acp-server/test/ 下有对应测试覆盖例如 initialize.test.ts 与 e2e-turn.test.ts。MCP 服务的传输转换当客户端在session/new或session/load中携带mcpServers时server 会在 packages/acp-server/src/convert.ts 中将其转换为引擎侧按名称索引的配置客户端声明的type转换结果缺省未声明typetransport: stdio保留command/args/envhttptransport: httpurl/headersssetransport: sseurl/headersacp不支持静默丢弃并写入一条 warn 日志因此在 IDE 中配置 MCP 服务时请选择stdio、http或sse传输acp传输的服务会被丢弃工具不会出现在会话中。在 Zed 中使用Zed 是原生支持 ACP 的现代编辑器。在配置文件~/.config/zed/settings.json中添加{ agent_servers: { Kimi Code CLI: { type: custom, command: kimi, args: [acp], env: {} } } }字段说明type固定值customcommandKimi Code CLI 的可执行路径。若kimi不在PATH中请使用完整路径例如/Users/you/.local/bin/kimiargs启动参数acp子命令将 CLI 切换到 ACP 模式env附加环境变量通常留空即可——Zed 会自动注入一份默认环境。保存配置后在 Zed 的 Agent 面板新建一次对话就会以刚才配置的Kimi Code CLI启动一个 ACP 子进程。Zed 在agent_servers这层声明的 MCP 服务也会通过 ACP 协议转发到 kimi 一侧注意遵循上文所述的传输类型限制。在 JetBrains IDE 中使用JetBrains 系列 IDEIntelliJ IDEA、PyCharm、WebStorm 等通过 AI 聊天插件支持 ACP。如果没有 JetBrains AI 订阅可以在注册表中启用llm.enable.mock.response以便在仅使用 ACP 的场景下访问 AI 聊天面板——连按两次 Shift 搜索 Registry / 注册表 即可打开。在 AI 聊天面板的菜单中点击 Configure ACP agents添加以下配置{ agent_servers: { Kimi Code CLI: { command: ~/.local/bin/kimi, args: [acp], env: {} } } }JetBrains 对command字段的处理比较严格——务必填写绝对路径可在终端执行which kimi获取注意示例中的~/.local/bin/kimi是一个常见安装位置实际路径以which kimi输出为准。保存后AI 聊天的 Agent 选择器里就会出现Kimi Code CLI。在 Paseo 中使用Paseo 是一个自托管的编排器能在桌面、网页和手机上统一启动并接管各类 agent 的 CLI。它和 IDE 一样通过 ACP 接入 Kimi Code CLI。在 Paseo 内置的 ACP provider 目录里选择Kimi Code CLI或在~/.paseo/config.json中添加一个自定义 provider{ agents: { providers: { kimi: { extends: acp, label: Kimi Code CLI, command: [kimi, acp] } } } }注意Paseo 的通用 ACP 适配层不会代你走登录流程所以请先完成终端登录见上文前置准备——否则创建会话会以Authentication required失败。故障排查会话立刻被中断 / IDE 提示 agent exited通常是command路径不对或 kimi 未登录。先在终端跑一次kimi acp验证——如果进程阻塞等待标准输入说明 CLI 本身没问题问题在 IDE 配置如果立刻报错则按报错提示处理多数情况是未执行/login。IDE 显示 auth required表示 CLI 没有可用的鉴权令牌。退出 IDE在终端执行kimi完成登录后再启动 IDE 即可。MCP 工具看不到参考 kimi acp 参考 中的能力表确认 IDE 配置的 MCP 传输类型是否被支持。当前 ACP server 支持http、stdio与sse三种传输方式acp传输的 MCP server 会被静默丢弃并在日志中给出 warn。下一步kimi acp 参考 — ACP 能力矩阵和方法覆盖详情kimi 命令参考 — 完整子命令列表含login、web、doctor、migrate等开始使用 — 安装、登录与第一个对话完整子命令列表可运行kimi --help查看。赞分享AI Agent代码智能体人工智能大模型CLI【免费下载链接】kimi-codeKimi Code CLI — The Starting Point for Next-Gen Agents项目地址https://gitcode.com/gh_mirrors/ki/kimi-code点击查看免费下载相关推荐在 Zed、JetBrains 与 Paseo 中集成 Kimi Code CLI基于 ACP 协议的 IDE 接入实战指南在 Zed、JetBrains 与 Paseo 中集成 Kimi Code CLI基于 ACP 协议的 IDE 接入实战指南 Kimi Code CLI 通过AI Agent代码智能体人工智能大模型CLIKimi Code CLI 终端 AI Agent 完整指南安装、Shell 模式、ACP/IDE 集成与 MCP 扩展Kimi Code CLI 终端 AI Agent 完整指南安装、Shell 模式、ACP/IDE 集成与 MCP 扩展 本文面向希望在终端中拥有一个既能写代人工智能AI Agent代码智能体交互助手CLI工具调用Kimi Code CLI 的 kimi acp 子命令全解析ACP 协议能力矩阵、方法覆盖与源码实现Kimi Code CLI 的 kimi acp 子命令全解析ACP 协议能力矩阵、方法覆盖与源码实现 kimi acp 把 Kimi Code CLI 切换AI Agent代码智能体人工智能大模型CLI上一篇GTAIV.EFLC.FusionFix终极指南如何彻底修复《侠盗猎车手IV》完整版的技术问题下一篇开源工具mooc-dl课程资源全链路下载解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考