Coding tools

One command finds the coding tools on your machine and sets each one up to use Aile:

Terminalbash

1npx aile.sh setup

It needs Node 20 or newer. The steps:

One screen lists what is installed, each tool with what setup will do to it, plus one row to also make Aile the default in Claude Code and Codex. Tools are found on PATH, at their installers' own locations, as apps, and as extensions in VS Code, Cursor or Windsurf.
It gets an API key: the one saved by an earlier run, a new one on your account if this machine is signed in, or else it opens aile.sh so you can approve one.
It shows every change and asks before making it.

Approving the key does not sign that machine in, and your other machines stay signed in. If the browser cannot approve a key, setup offers to sign in with your browser instead (like aile login, this signs out your other machines) or to paste a key. npx aile.sh setup --remove puts every file back as it was.

The dashboard's Connect tools tab has the same command and each tool's steps by hand, and a new key's dialog shows a quickstart with the key filled in.

What it does to each tool

Tool	Result
Claude Code	A `claudeaile` command. Plain `claude` keeps your own login. `/model` lists every Claude model Aile can serve.
Codex	A `codexaile` command. Codex's own model names work unchanged.
opencode	Aile's opencode plugin, with your key.
Factory Droid	The Claude and Codex models in `/model`, as `aile · …`
OpenClaw	An `aile` provider.
Qwen Code, Aider, Goose	`qwenaile`, `aideraile`, `gooseaile` commands.
Cursor, Cline, Roo, Kilo, Continue, Zed, Windsurf (Devin Desktop), JetBrains AI Assistant, Crush	The values to paste. These keep settings inside the app.
Gemini CLI, GitHub Copilot, Amp, Kiro, Warp, Augment, Trae	Not supported yet: none has a setting for another provider. `aile detect` still lists them.

To make Aile the default in Claude Code and Codex instead of adding a command, run:

Terminalbash

1npx aile.sh setup claude codex --mode default

That writes ~/.claude/settings.json and ~/.codex/config.toml. --mode both does both, and so does ticking that row in setup.

When the key or the account changes

Situation	Command
Key revoked, expired or at its limit	`aile setup refresh --new-key`
Signed in as a different account	`aile login` offers to move the tools over
A key you already have	`aile setup refresh --key -` (reads it from stdin)
Remove Aile from every tool	`aile setup --remove` (`--revoke` also revokes the key)
Sign out, and remove it from the tools	`aile logout --tools`

aile setup status shows what is set up. aile detect shows what is installed. aile doctor checks the key, the server and each tool.

Without setup

aile run claude starts a tool through Aile without changing anything. aile env claude prints the variables for anything else.

By hand: OpenAI-format tools take https://api.aile.sh/v1; Claude Code and other Anthropic-format tools take the bare origin, https://api.aile.sh.

Claude Codeshell

1export ANTHROPIC_BASE_URL="https://api.aile.sh"
2export ANTHROPIC_AUTH_TOKEN="$AILE_API_KEY"
3export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
4claude

Claude Code and Codex may send model names with no provider (claude-sonnet-5, gpt-5.5). Aile sends those to the claude and codex providers respectively. Every other client names the provider: cc/claude-sonnet-5. See Model names.