Agent 接入

Curxor 支持接入任何 ACP 兼容的 AI 编码 Agent，内置 Claude Code、Cursor、Pi。在浏览器里选中元素，描述需求，直接发给它改代码；其他常用 Agent（如 Qoder、OpenCode、Trae）可按本页步骤接入，可持续扩展。

配置 agents.toml

Agent 由 ~/.curxor/agents.toml 配置，用 curxor agents edit 打开编辑（保存即生效）。内置的 Claude Code / Cursor / Pi 在首次启动时自动写入：

toml

[[agents]] id = "claude" name = "Claude Code" command = "npx" args = ["-y", "@agentclientprotocol/claude-agent-acp@latest"] probe = "claude" [[agents]] id = "cursor" name = "Cursor" command = "cursor-agent" args = ["acp"] probe = "cursor-agent" [[agents]] id = "pi" name = "Pi" command = "npx" args = ["-y", "@curxor/pi-acp@latest"] probe = "pi"

各字段：id 唯一标识；name 选择器里的显示名；command/args 启动该 Agent 为 ACP server 的命令；probe 用于检测「是否已安装」的二进制（缺省回退 command），决定选择器里是否标记 installed。

ACP 是关键：任何实现了 ACP 的 Agent 都能接入。命令能以 ACP server 启动、用 stdin/stdout 通信即可，Curxor 侧无需任何改动——所以你可以接入 Qoder、OpenCode、Trae 甚至自研 Agent。

Claude Code

Claude Code 已内置（即上方默认配置）。先安装 CLI 并登录：

bash

npm install -g @anthropic-ai/claude-code claude login

运行 curxor agents list，看到 Claude Code 且标记 installed 即接入成功：

bash

curxor agents list # claude Claude Code installed

Cursor

Cursor 已内置（即上方默认配置）。安装并登录 Cursor 桌面端即可，cursor-agent 随应用自带，无需单独安装：

bash

# 安装 Cursor 桌面端：https://cursor.com # cursor-agent 随应用自带，无需单独安装

运行 curxor agents list，看到 Cursor 且标记 installed 即接入成功：

bash

curxor agents list # cursor Cursor installed

Qoder

Qoder 不在内置配置里，需手动接入。先安装并登录 Qoder CLI（任选一种安装方式）：

bash

curl -fsSL https://qoder.com/install | bash # 或 npm install -g @qoder-ai/qodercli qodercli login

用 curxor agents edit 打开 ~/.curxor/agents.toml，加一条 Qoder 配置，以 ACP 模式（--acp）启动：

toml

[[agents]] id = "qoder" name = "Qoder" command = "qodercli" args = ["--acp"] probe = "qodercli"

保存后立即生效。运行 curxor agents list，看到 Qoder 且标记 installed 即接入成功：

bash

curxor agents list # qoder Qoder installed

排查

目标选择器里某 Agent 显示「模型加载失败」，通常是 CLI 未安装、未登录或 CLI 未启动：先 curxor agents list 看该 Agent 是否 installed，再按 Agent 逐项检查：

Claude Code：确认已安装并登录，claude 命令可运行（未安装/未登录会拉不起会话）
Cursor：确认已安装并登录，cursor-agent 在 PATH 中
Qoder：确认 qodercli --version 可运行，且已 qodercli login
CLI 在线：curxor status