Claude Code, Codex & Copilot Subscriptions
Last updated
How to run Agenvoy on an existing subscription instead of an API key, after the quickstart works.
Subscriptions are the recommended way to run Agenvoy, and the quickstart already starts on GitHub Copilot. These four are also the first choice for a second, fall-back model: the cost is already fixed monthly, so an agent that takes a few extra turns doesn't move the bill.
| Provider | Billed against | Where it lives in the menu |
|---|---|---|
| Codex | Your ChatGPT / Codex subscription | OAuth tab → OpenAI Codex |
| Grok (xAI) | Your xAI subscription | OAuth tab → Grok (xAI) |
| GitHub Copilot | Your GitHub Copilot subscription | OAuth tab → GitHub Copilot |
| Claude Code | Your Claude subscription, through the local claude CLI | OAuth tab → Claude Code (shown only when the claude binary is found) |
None of them takes an API key. Codex and Grok open a browser authorization page; Copilot uses a device-code flow. The popup counts down a 10-minute limit (15 minutes before v1.3.12), Esc cancels the login and closes it, and the browser opens by itself only when a GUI is present — over SSH or on a headless Linux box you open the link on another device. Either way the token lands in the OS keychain like any other credential. Claude Code has no login of its own: it runs the
claude CLI you have already installed and signed in, so claude has to be on the daemon's PATH.Add Codex
| Step | What you do |
|---|---|
| 1 | /model → add |
| 2 | The picker opens on the OAuth tab (←/→ switches tabs) |
| 3 | Choose OpenAI Codex — not OpenAI on the API Key tab, which is pay per token. Before v1.0.22 this was OpenAI → OpenAI method → Codex subscription |
| 4 | The OAuth popup opens and, with a GUI, your browser goes to the authorization page once it is ready (Enter re-opens it). Sign in and approve. The popup also shows a device URL and user code (since v1.3.12): open that URL on any device and enter the code — whichever path finishes first wins |
| 5 | Back in the TUI, pick a model from the list your subscription exposes |
Add Grok (xAI)
| Step | What you do |
|---|---|
| 1 | /model → add |
| 2 | Stay on the OAuth tab |
| 3 | Choose Grok (xAI) |
| 4 | Same browser OAuth flow as Codex. When xAI shows a code instead of returning to Agenvoy (the browser could not reach the local callback, e.g. a headless VM), paste that code or the callback URL into the popup's input and press Enter (since v1.3.12) |
| 5 | Pick a model |
Add GitHub Copilot
| Step | What you do |
|---|---|
| 1 | /model → add |
| 2 | Stay on the OAuth tab |
| 3 | Choose GitHub Copilot |
| 4 | The popup shows a verification URL and a user code; with a GUI the page opens by itself (Enter re-opens it). Enter the code and approve within the same 10-minute window |
| 5 | Pick a model from the ones your Copilot plan offers |
Add Claude Code
| Step | What you do |
|---|---|
| 1 | Install the claude CLI and sign in to it with your Claude account; it must be on PATH |
| 2 | Nothing to enable: the daemon picks up Claude Code as soon as claude is on its PATH. If you installed claude after the daemon started, run agen stop and start agen again so the daemon sees the new PATH |
| 3 | /model → add, stay on the OAuth tab and choose Claude Code — the row is hidden until the binary is found |
| 4 | No browser step. Pick a model from the list the claude CLI reports for your subscription |
Details such as caching and session reuse are on Claude Code Provider.
Already authenticated once with Codex, Grok or Copilot? The flow asks<Provider> token exists re-login?first.No keep existingreuses the stored token and jumps straight to the model list — pickYes re-authenticateonly when switching accounts.
With more than one model registered, Shift+W / Shift+S cycles the session model from the TUI (
auto lets the dispatcher pick), and /model dispatch / /model summary set the dispatcher and summary models explicitly.