Skip to main content
The aireserve CLI is the fastest way to route your coding agents through AI Reserve. One command installs it and configures every supported agent it finds on your machine:
Your browser opens once to approve the connection — a managed API key is minted for your account and handed to the CLI over a loopback callback. No key to copy, nothing pasted into config files by hand.

​
What you get

  • Native model pickers. Every gateway model appears in Claude Code’s /model picker and Codex’s model picker with real display names, context windows, and reasoning-effort options you can toggle with the arrow keys. Models outside the Claude family appear in Claude Code under self-naming ids like claude-air-gpt-5.6-sol[1m] — the id always names the model that serves the request, and the gateway records both.
  • Session cost in your status line. Claude Code’s status line shows the session’s actual server-computed spend and your remaining credits.
  • Freshness for free. A session-start hook refreshes the model catalog at most every 12 hours, in the background, without delaying your session.
  • A real undo. aireserve router unconfigure restores your previous settings exactly — every value the CLI touched is recorded before it is changed, and anything you edited yourself afterwards is left alone.

​
Commands

Pass AIRESERVE_API_KEY in the environment instead of --api-key to keep the key out of shell history. Non-production gateways: add --base-url https://<your-uat-gateway> (keys are environment-specific).

​
Escape hatches

The CLI never locks you in:
  • claude --settings ~/.claude/original.settings.json runs one Claude Code session on the setup that existed before the CLI configured anything.
  • codex --profile original does the same for Codex.
  • aireserve router unconfigure removes everything permanently and restores the recorded values.

​
Requirements

  • macOS or Linux (x64/arm64). Windows: install via WSL for now.
  • Claude Code ≥ 2.1.118 (the version that shows gateway models by their real names) and/or Codex CLI ≥ 0.147 (the version with catalog support).
Prefer a guided browser flow instead? The Claude Code and Codex connect pages still offer the one-click wizard, and each agent’s docs page keeps the manual environment-variable setup.