v1.3.11

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.
ProviderBilled againstWhere it lives in the menu
CodexYour ChatGPT / Codex subscriptionOAuth tab → OpenAI Codex
Grok (xAI)Your xAI subscriptionOAuth tab → Grok (xAI)
GitHub CopilotYour GitHub Copilot subscriptionOAuth tab → GitHub Copilot
Claude CodeYour Claude subscription, through the local claude CLIOAuth 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. 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


StepWhat you do
1/model → add
2The picker opens on the OAuth tab (←/→ switches tabs)
3Choose 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
4The OAuth popup opens and your browser goes to the authorization page once it is ready (Enter re-opens it). Sign in and approve — the flow has a 15-minute window
5Back in the TUI, pick a model from the list your subscription exposes

Add Grok (xAI)


StepWhat you do
1/model → add
2Stay on the OAuth tab
3Choose Grok (xAI)
4Same browser OAuth flow as Codex
5Pick a model

Add GitHub Copilot


StepWhat you do
1/model → add
2Stay on the OAuth tab
3Choose GitHub Copilot
4The popup shows a verification URL and a user code; press Enter to open that page in the browser, enter the code and approve. Same 15-minute window
5Pick a model from the ones your Copilot plan offers

Add Claude Code


StepWhat you do
1Install the claude CLI and sign in to it with your Claude account; it must be on PATH
2Nothing 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
4No 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 existing reuses the stored token and jumps straight to the model list — pick Yes re-authenticate only 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.
中文