在 IDE 中使用

Mirri Code 支持通过 Agent Client Protocol (ACP) 集成到 IDE 中，让你在编辑器内直接使用 AI 辅助编程。

前置准备

在配置 IDE 之前，请确保已安装 Mirri Code 并配置好模型供应商（如未配置，先在 Web UI 的设置中，或直接编辑 ~/.mirri-code/config.toml 添加）。

ACP 适配层暴露子命令 mirri acp，IDE 通过子进程方式启动它，并在标准输入/输出上跑 JSON-RPC。会话会复用 ~/.mirri-code/config.toml 中已有的供应商配置。

路径提示

macOS 下从 IDE GUI 启动的子进程通常不会继承终端 shell 的 PATH，所以如果 mirri 不在 /usr/local/bin 这类系统目录里，IDE 配置中要使用绝对路径。终端里运行 which mirri 可以查到当前生效的路径。

在 Zed 中使用

Zed 是一个原生支持 ACP 的现代编辑器。

在 Zed 的配置文件 ~/.config/zed/settings.json 中添加：

{
  "agent_servers": {
    "Mirri Code": {
      "type": "custom",
      "command": "mirri",
      "args": ["acp"],
      "env": {}
    }
  }
}

配置说明：

• type：固定值 "custom"
• command：Mirri Code 的可执行路径。如果 mirri 不在 PATH 中，请使用完整路径（例如 /Users/you/.local/bin/mirri）。
• args：启动参数。acp 子命令切换到 ACP 模式。
• env：附加环境变量，通常留空即可。Zed 会自动注入一份默认环境。

保存配置后，在 Zed 的 Agent 面板里新建一次对话，就会以你刚才配置的 Mirri Code 启动一个 ACP 子进程。Zed 在 agent_servers 这层声明的 MCP 服务也会通过 ACP 协议转发到 mirri 这一侧。

在 JetBrains IDE 中使用

JetBrains 系列 IDE（IntelliJ IDEA、PyCharm、WebStorm 等）通过 AI 聊天插件支持 ACP。

如果没有 JetBrains AI 订阅，可以在注册表中启用 llm.enable.mock.response，便于在仅使用 ACP 的场景里访问 AI 聊天面板。连按两次 Shift 搜索 "Registry / 注册表" 即可打开。

在 AI 聊天面板的菜单中点击 "Configure ACP agents"，添加以下配置：

{
  "agent_servers": {
    "Mirri Code": {
      "command": "~/.local/bin/mirri",
      "args": ["acp"],
      "env": {}
    }
  }
}

JetBrains 这一侧对 command 字段处理较严格——务必填写绝对路径，可以在终端执行 which mirri 拿到。保存后，AI 聊天的 Agent 选择器里就会出现 Mirri Code。

在 Paseo 中使用

Paseo 是一个自托管的编排器，能在桌面、网页和手机上统一启动并接管各类 agent 的 CLI。它和 IDE 一样，通过 ACP 接入 Mirri Code。

在 Paseo 内置的 ACP provider 目录里选择 Mirri Code，或在 ~/.paseo/config.json 里添加一个自定义 provider：

{
  "agents": {
    "providers": {
      "mirri": {
        "extends": "acp",
        "label": "Mirri Code",
        "command": ["mirri", "acp"]
      }
    }
  }
}

Paseo 的通用 ACP 适配层不会帮你做供应商配置，所以请先在 CLI 中配置好供应商和模型（见前置准备）。

故障排查

• 会话立刻被中断 / IDE 提示 "agent exited"：通常是 command 路径不对或尚未配置模型供应商。先在终端跑一次 mirri acp 验证：如果阻塞等待标准输入则说明 CLI 本身没问题，问题在 IDE 配置；如果立刻报错则按报错提示处理（多数是需要先配置好供应商和模型）。
• IDE 显示 "auth required"：表示 CLI 没有可用的供应商凭证。退出 IDE，在 Web UI 的设置中（或编辑 ~/.mirri-code/config.toml）配置供应商和模型后再启动 IDE。
• MCP 工具看不到：参考 mirri acp 中的能力表确认 IDE 配的 MCP 传输类型是否被支持。当前 Mirri Code 的 ACP 适配层支持 http、stdio 与 sse 三种传输方式；acp 传输的 MCP server 会被静默丢弃并在日志中给出 warn。

下一步

• mirri acp 参考 — ACP 能力矩阵和方法覆盖详情
• mirri 命令参考 — 完整子命令列表