Agent setup
Each Agent page explains what the Agent is for and maintains its complete connection lifecycle: one-time launch, persistent use, everyday launch, and removal. When a mode is unavailable, the page explains why; you should not need to assemble one setup from several documents.
Before starting, have the API configuration Base URL, Lumoswitch Access Key, and client-facing model name ready. The Agent protocol must match the configuration output protocol. Start with General Agent setup if you are unsure.
Codex
| How you use Codex | Setup page |
|---|---|
| Only the Codex workspace in ChatGPT desktop | ChatGPT Desktop (Codex) |
| Only Codex CLI, isolated from desktop settings | Codex CLI |
| ChatGPT desktop, CLI, and IDE with shared settings | ChatGPT Desktop + Codex CLI |
If you do not know which path fits, start with Choose your Codex setup.
Command-line Agents
| Agent | Typical downstream protocol | Setup page |
|---|---|---|
| Claude Code CLI | Anthropic Messages | Open setup |
| OpenCode CLI | OpenAI-compatible | Open setup |
| Mistral Vibe CLI | OpenAI-compatible | Open setup |
| DeepSeek Harness | OpenAI-compatible | Open setup |
| GitHub Copilot CLI | OpenAI-compatible | Open setup |
| Gemini CLI | Gemini | Open setup |
| Qwen Code CLI | OpenAI-compatible | Open setup |
| Aider CLI | OpenAI-compatible | Open setup |
| OpenClaw CLI | OpenAI-compatible | Open setup |
Official interfaces available alongside these CLIs
| Agent | Official desktop or editor surface | Relationship to Lumoswitch setup |
|---|---|---|
| Claude Code | Claude Desktop, VS Code, JetBrains | Desktop uses separate persistent setup; IDEs can connect to CLI or shared settings |
| OpenCode | OpenCode Desktop and IDE extension | Graphical surfaces read global settings and save the Key persistently |
| Mistral Vibe | VS Code, Web, and ACP | The local VS Code extension shares CLI settings; Web sessions do not inherit local credentials |
| DeepSeek Harness | Local Web UI | Native DSH_HOME settings point the original command to a dedicated Lumoswitch configuration |
| GitHub Copilot CLI | Copilot app, VS Code, GitHub Desktop | /ide connects the current CLI; other graphical surfaces configure BYOK separately |
| Gemini CLI | IDE Companion and ACP editors | No standalone coding desktop app; Companion reuses the current CLI process |
| Qwen Code | VS Code extension and IDE Companion | No standalone desktop app; Companion reuses CLI, while the native sidebar uses user settings |
| Aider | Local browser UI and IDE terminal | No standalone desktop app or official IDE plugin; both reuse the Aider process |
| Goose | Goose Desktop and ACP editors | Desktop reuses the custom provider but stores its Key separately in system credentials |
| OpenClaw | macOS companion app and Control UI | Both reuse persistent settings from the same Gateway |
Each linked page explains whether the graphical surface supports one-time setup, how persistent setup works, and whether removal belongs in the CLI, application settings, or a shared Gateway. Pages also state when no official desktop app exists, so an ordinary chat product is not mistaken for a coding Agent.
Editor and other Agents
| Agent | Surface | Setup page |
|---|---|---|
| Zed Agent | Native editor | Open setup |
| Roo Code | VS Code and JetBrains | Open setup |
| Cline | VS Code and JetBrains | Open setup |
| Continue | CLI and editor | Open setup |
| Kilo Code | VS Code | Open setup |
| Crush | Terminal | Open setup |
| Goose | Desktop and terminal | Open setup |
For an Agent without a dedicated page, follow General Agent setup when it supports a custom Base URL, Access Key, model name, and matching protocol. Non-Agent integrations such as the OpenAI SDK and OpenWebUI now live under API and compatibility in the sidebar.