Skip to content

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.

Three numbered steps. Click a step to open it, or use Next step to go through them in order.

  1. Install. Pick macOS, Linux or Windows (WSL) and copy the command:

    Terminal window
    curl -fsSL https://aderra.ai/cli | sh

    Aderra Agent needs Node.js 22.19 or newer, Claude Code and Codex need 18 or newer. On Windows, run it inside WSL.

  2. 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 login on its own and paste the key when it asks, which keeps the key out of your shell history. See Log in.

  3. Start. Open your project folder in a terminal and run one of the launch commands.

The Docs button opens the Aderra Agent guide.

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.

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.

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 aderra command. 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 the OPENAI_BASE_URL setting shown there, so start Codex with aderra codex.

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.

  • 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.