Devin Desktop（原 Windsurf）接入

Windsurf 已更名 Devin Desktop 并改为 ACP 架构：把 Claude Code 当 ACP agent 挂进去，环境变量指向 QCode

Devin Desktop（原 Windsurf）接入 ¶

⚠️ Windsurf 已更名。 2026-06-02，Cognition 把 Windsurf 更名为 Devin Desktop，以 OTA 方式推送；套餐、价格、设置、扩展、快捷键与 MCP 连接全部平移，无需用户操作。原来的 Cascade agent 已于 2026-07-01 下线。

Devin Desktop 现在围绕 ACP（Agent Client Protocol） 构建：它本身是宿主，你可以在里面挂载 Claude Code、Codex CLI、OpenCode 等任意会说 ACP 的 agent。新增能力包括看板式 Command Center、Spaces（任务分组）、本地 Rust agent（Devin Local）与 Codemaps。

用 QCode 的正确姿势：走 ACP，不走内置 BYOK ¶

Devin Desktop 也提供内置的 BYOK，但只覆盖部分云端模型，且仍然发往对应厂商的云 API。想用 QCode 的密钥与配额，推荐走 ACP 这条路：

🔑 ACP 宿主是以子进程方式启动 agent 的，agent 继承你的环境变量。所以只要 Claude Code CLI 配好了 QCode，Devin Desktop 里的会话就自动走 QCode。

第 1 步：把 Claude Code 接到 QCode ¶

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_你的QCode密钥"

中国大陆把域名换成 https://asia.qcode.cc/api。

更稳的做法是写进 ~/.claude/settings.json 的 env 块，而不是 shell profile —— 从图标启动的 GUI 应用读不到 ~/.zshrc，这是最常见的失败原因。详见 ACP 接入总览与环境变量配置。

先在终端确认 CLI 能通：

claude -p "reply with exactly: OK"

第 2 步：在 Devin Desktop 里挂载 agent ¶

Devin Desktop 自带 Codex CLI、Claude Agent、OpenCode 等 agent；个人用户也可以编辑本地的 ACP agent 注册表文件添加自定义 agent。确切的菜单位置与注册表路径以 Devin 官方文档为准（产品仍在快速演进）。

挂载后在 Devin Desktop 里开一次会话，如果回复正常，说明它已经在用你的 QCode 配额。

验证是不是真的走了 QCode ¶

打开 probe.qcode.cc，输入你的 API Key。刚才那次会话应当出现在请求列表里（含模型、tokens、上下文长度）。看不到就说明 agent 没继承到环境变量，回第 1 步用 ~/.claude/settings.json 的写法。

常见问题 ¶

现象	原因	处理
终端能用，Devin Desktop 里鉴权失败	GUI 启动读不到 shell 环境变量	改用 `~/.claude/settings.json` 的 `env` 块
找不到 Cascade	已于 2026-07-01 下线	改用 ACP agent 或 Devin Local
内置 BYOK 里没有 QCode	内置 BYOK 只覆盖部分厂商	走 ACP 路径，不用内置 BYOK
probe 里看不到请求	会话没走 QCode	检查环境变量是否被 agent 继承

Devin Desktop（原 Windsurf）接入