Coding agents
Each coding agent uses the login or key you already have. ADE detects your existing CLI credentials automatically, so most of these light up green without any extra setup. You do not install the agents yourself: ADE downloads its own tested copy of each one for the machine that runs it, the first time that machine uses it, and keeps it at that version. Your own CLI’s sign-in is reused.Claude Code
Claude Code
Sign in with a Claude subscription or paste an Anthropic API key. ADE runs Claude through the Claude Agent SDK and its own copy of Claude Code, so the
claude CLI does not need to be installed. If sign-in is required, the card offers a one-click login. See Claude Code for lane context and permission modes.Codex CLI
Codex CLI
Sign in with your ChatGPT account or provide an API key. Codex runs as a CLI-backed session and reaches OpenAI models.
Cursor
Cursor
Add a Cursor API key (or set
CURSOR_API_KEY in the environment ADE launches from). ADE verifies it with the Cursor SDK and discovers your available models. See Cursor.Droid
Droid
Sign in with Factory or set
FACTORY_API_KEY. Droid runs as an agent provider and supports AGI mode for larger autonomous tasks.Antigravity
Antigravity
ADE downloads Google’s Antigravity agent for the machine that runs the chat and signs it in from Settings → Providers → Antigravity. Pick a method (Google account, Gemini Enterprise, Gemini API key, or Agent Platform) and choose Sign in. The login is the agent’s own and is separate from the Antigravity app and the
agy CLI.Signing in to another machine from this one: open the Google link anywhere, then paste the full address the last page ends on (it starts with http://127.0.0.1 and will not load) into the return-address field and choose Continue. It holds a one-time sign-in code, so paste it only there. Gemini Enterprise’s license page opens only in a browser on the machine that runs Antigravity.Models come from your Antigravity account. Antigravity cannot rewind or edit earlier turns, and it has no read-only Plan mode in ADE; use its own /plan command.GitHub Copilot
GitHub Copilot
Copilot chats and Copilot terminals run the same Copilot version. Copilot’s own slash commands work as they do in its CLI: the
/ menu lists the commands and skills Copilot reports, /context, /usage and /env answer without a model request, and /review, /plan and /compact run through Copilot. Commands ADE handles itself, such as /model and /permissions, point you to ADE’s own control. A failed request shows the HTTP status, the error code, and GitHub’s request IDs.Custom providers: any harness on a plan you have
A custom provider runs one harness (the agent program, such as Claude Code or Codex) on a model from somewhere else: another provider’s sign-in, a provider signed in inside OpenCode, or a stored API key. Run Claude Code on your ChatGPT plan, or Codex on your Claude plan, with the sign-ins you already have. There is no extra login. Open Settings › Providers › Custom. With nothing saved yet it offers one-click starters built from your sign-ins. The editor shows a live preview with the harness, the model, and what it uses (the plan and email, or the key’s name), then numbered steps. Saved custom providers appear as cards, are saved to your ADE account so every machine has them, and show up as the first tab of every model picker. ADE lends its local proxy only the short-lived access token of each Claude and Codex account, plus your Grok, Kimi, Devin and Muse logins. When a token is about to expire, ADE has that provider’s own CLI renew it, so the renewal token never leaves the CLI and your normal chats stay signed in. Copilot, Pi and Kimi take a custom model through their own provider config. Cursor stays on its own sign-in, and Antigravity cannot be used as a source.On macOS, ADE does not read a Codex login kept in the Keychain, because reading it would prompt you. If Codex stores its login there, the launch explains how to switch Codex to file storage.
OpenCode — universal model access
OpenCode is the managed layer that reaches everything else. ADE downloads and runs it for you, keeps its credentials in an isolated ADE-managed store (never your own~/.local/share/opencode), and refreshes its model catalog on its own. One group, four ways in:
1
Subscriptions
Connect a subscription you already pay for — currently GitHub Copilot, ChatGPT Plus/Pro, GitLab, Poe, and DigitalOcean. Click Connect, finish the sign-in in your browser, and the row flips to Connected when the provider reports back. The available list comes straight from OpenCode, so it grows over time.Kimi for Coding connects here too, with a membership key instead of a browser sign-in.
Claude Pro/Max cannot be used through OpenCode — Anthropic’s terms of service don’t allow it. Connect Claude through the Claude Code agent above instead.
2
API provider keys
Paste a key for any first-class provider — Anthropic, OpenAI, Google AI, Mistral, DeepSeek, xAI, Groq, Together AI, OpenRouter, or Moonshot AI (
MOONSHOT_API_KEY). Use Verify all to check every stored key at once. Keys are held in local encrypted storage.3
More providers
Beyond the first-class rows, OpenCode reaches 160+ more providers. Search the chip cloud, then paste a key against any provider by its ID. The catalog is cached between sessions, so it renders the moment Settings opens.
4
Local model servers
Point ADE at LM Studio or Ollama running locally. ADE auto-detects the OpenAI-compatible endpoint, lists the models you’ve loaded, and lets you set a default per runtime.
Catalog freshness
The group header shows when the model catalog (from models.dev) last synced. ADE refreshes it on launch and every six hours; hit refresh in the header to pull the latest metadata on demand.Advanced — custom providers & model slugs
Open Advanced to add a custom OpenAI- or Anthropic-compatible provider (name, base URL, key, and model slugs) or to register extra model slugs byproviderId/modelId. Both flow straight into the managed OpenCode config.
The models you can reach
Between the coding agents and OpenCode’s routing, you get models from every major lab. Pick whichever fits the task.Permission presets
Providers expose different native permission models. ADE maps them into a small set of practical choices.
Set stricter modes for unfamiliar repositories. The full mapping lives in Permissions.
Cost and usage
Running several agents in parallel can spend quickly. Use cheaper models for routine follow-up and stronger models for planning, architecture, and hard debugging. Usage is counted for your whole ADE account. Tokens, spend, requests and active days on the new-chat card, the home page, Settings › Usage, and each provider’s page add up every machine you are signed in on. An account is shown by its email. Quota belongs to the login, not the machine. The top-bar Usage popup has one panel per provider, shows each account’s freshest reading from any of your machines (marked “via” that machine), says the pace in words (“Room to spare”, “Runs out early”), and lets you set a budget cap. A login that is signed in only on another machine shows as “Not signed in here”; smart balance and budget caps ignore it.Troubleshooting
OpenCode won't launch on macOS
OpenCode won't launch on macOS
If OpenCode is blocked by macOS Gatekeeper, its diagnostics report a quarantined binary and the exact fix — clear the quarantine attribute with
xattr -d com.apple.quarantine <path> (the card shows the full path), then re-check.An agent shows as not signed in
An agent shows as not signed in
Run the login command the card suggests, then hit Refresh. The sign-in terminal runs ADE’s copy of the agent, and the login is shared with your own CLI.
An agent shows as downloading or not downloaded
An agent shows as downloading or not downloaded
ADE downloads each agent the first time the machine uses it. The provider’s page shows the progress. If the download failed, choose Retry download. “Not available on this machine” means the vendor publishes no build for this platform (for example Windows on Arm); installing the CLI yourself does not change that, because ADE only runs its own copy.
Permissions
Lane scope, provider modes, and how secrets are handled.
Settings
Every Settings section and a first-pass order.
