The Connect page
Connect is where you set up the terminal. Open it with the terminal icon in the left bar, or go to /connect. One install and one key give you three coding agents: Aderra’s own agent, Claude Code and Codex. All three spend your plan’s credits.
Set up Aderra
Section titled “Set up Aderra”Three numbered steps. Click a step to open it, or use Next step to go through them in order.
-
Install. Pick macOS, Linux or Windows (WSL) and copy the command:
Terminal window curl -fsSL https://aderra.ai/cli | shAderra Agent needs Node.js 22.19 or newer, Claude Code and Codex need 18 or newer. On Windows, run it inside WSL.
-
Sign in. Click Generate key. The page shows “New key created — it won’t be shown again. Copy it now.” and a sign-in command with the key hidden on screen. The copy button copies the full command. You can also run
aderra loginon its own and paste the key when it asks, which keeps the key out of your shell history. See Log in. -
Start. Open your project folder in a terminal and run one of the launch commands.
The Docs button opens the Aderra Agent guide.
One install. Three coding agents.
Section titled “One install. Three coding agents.”Three cards, each with its launch command and a copy button:
| Card | Command | Guide |
|---|---|---|
| Aderra Harness (Aderra Agent) | aderra |
Aderra Agent |
| Claude Code | aderra claude |
Claude Code and Codex |
| Codex | aderra codex |
Claude Code and Codex |
Each agent starts on its default Aderra model. Type /model inside to change it.
Aderra Agent commands
Section titled “Aderra Agent commands”A quick reference. Start lists aderra, aderra web, aderra run "<task>" and aderra --yolo. Inside the agent lists /help, /model, /permission, /plan, /resume and /compact. /plan marks the session as planning but does not stop the agent from editing files; /permission read-only does. Full guide opens the Aderra Agent page, which has every command and shortcut.
More ways to configure your tools
Section titled “More ways to configure your tools”Cards for Claude Code and Codex. Click Configure on one to see:
- With the aderra command (easiest): the launch command for the model you pick, for example
aderra claude --model glm-5.3-flash. - Or configure it by hand: the environment variables to start the tool without the
aderracommand. Choose your OS and Model above it. The command includes your key once you’ve generated one, or a placeholder until then. This works for Claude Code. Current versions of Codex ignore theOPENAI_BASE_URLsetting shown there, so start Codex withaderra codex.
API access
Section titled “API access”The box at the bottom has links for the Anthropic SDK, the OpenAI SDK, Cursor, and Open WebUI & others. Each shows the base URL, key and model to paste into that tool.
Manage keys opens a list of your keys, with a field to create a named key and Revoke next to each one. Keys created here are terminal keys, like the one from Generate key. For keys that pay from the API wallet, with a spending cap and rate limit, use the Developers page.
Terminal keys
Section titled “Terminal keys”- A terminal key starts with
ak_and is shown only once, when you create it. - It spends your plan’s credits and follows your plan’s rules, including its context window.
- It can make 60 requests a minute. Your account can have 8 requests in progress at once, across all keys.
- You can hold up to 20 active keys. Revoke one under Manage keys, or in Settings → API. New requests with a revoked key are refused at once.
For how terminal keys differ from API keys, see Two kinds of key.