Agent 接入

每个 Agent 都在自己的页面说明它适合做什么，并维护完整的接入生命周期：仅本次启动、永久使用、日常启动和清除接入。不支持某种方式时，页面会直接说明原因，不需要在多个页面之间拼接配置。

开始前，请准备配置 API 的 Base URL、Lumoswitch Access Key 和「下游模型名称」。Agent 使用的协议必须与配置 API 的输出协议一致；不确定时先阅读通用 Agent 接入。

Codex

不了解区别时，从 Codex 接入方式开始。

Agent	官方桌面或编辑器入口	Lumoswitch 配置关系
Claude Code	Claude Desktop、VS Code、JetBrains	Desktop 单独永久配置；IDE 可连接 CLI，也可能读取共享设置
OpenCode	OpenCode Desktop、IDE 扩展	图形入口读取全局配置，需要单独永久保存 Key
Mistral Vibe	VS Code、Web、ACP	本机 VS Code 扩展共享 CLI 设置；Web 会话不继承本机凭证
DeepSeek Harness	本机 Web UI	原生 `DSH_HOME` 设置让原始命令读取专属 Lumoswitch 配置
GitHub Copilot CLI	Copilot app、VS Code、GitHub Desktop	`/ide` 可连接当前 CLI；其他图形入口单独配置 BYOK
Gemini CLI	IDE Companion、ACP 编辑器	没有独立编码桌面端；Companion 复用当前 CLI 进程
Qwen Code	VS Code 扩展、IDE Companion	没有独立桌面端；Companion 复用 CLI，原生侧边栏用用户级配置
Aider	本机浏览器界面、IDE 集成终端	没有独立桌面端或官方 IDE 插件；界面复用同一个 Aider 进程
Goose	Goose Desktop、ACP 编辑器	Desktop 复用自定义提供方，但需单独把 Key 保存到系统凭证库
OpenClaw	macOS 伴侣应用、Control UI	复用同一个 Gateway 的持久配置

每个对应页面都写明图形入口是否支持临时接入、如何永久接入，以及清除时需要操作 CLI、应用设置还是共享 Gateway。没有官方桌面端时也会直接说明，不把普通聊天产品误写成编码 Agent。

没有独立页面的 Agent，只要支持自定义 Base URL、Access Key、模型名称和匹配协议，就可以参考通用 Agent 接入。OpenAI SDK 和 OpenWebUI 等非 Agent 接入已移到侧栏的「API 与兼容性」。