/cruise:setup or the MCP server: 401 "Incorrect API key provided", with CRUISE_API_KEY unset when Claude Code started | Claude Code sent an empty key. It reads its environment once, at start | Export the key in your shell, quit Claude Code, reopen it from that shell |
Your apiKeyHelper script is failing | CRUISE_API_KEY is not exported in this terminal (or legacy helper configured) | Export CRUISE_API_KEY and restart, run npx @bytesbrains/claude-code-cruise@latest status to auto-upgrade, or disable to revert offline |
| The same 401 with the key set | The key is wrong for this Cruise host, or revoked | Check CRUISE_BASE_URL against the key's prefix: a cru_demo_ key only works with the demo host. Then ask for a new key |
No cruise server in /mcp | The plugin is not installed or not enabled | Run /plugin |
Status line: Cruise: set CRUISE_API_KEY, or /cruise:disconnect | The key is not in the status line's environment | Export it where Claude Code starts, or run /cruise:disconnect to go back to your subscription |
Status line: Cruise: CRUISE_API_KEY is not a Cruise key | The value has characters a Cruise key cannot have, so it was never sent | Check for quotes or a trailing newline in the value |
Status line: Cruise: no answer from <url> | Cruise did not answer within three seconds, or answered with something else | Check the URL. The line retries after its one-minute cache |
A request refused with budget_exhausted | The project's cap for this period is spent | Wait for the period to reset, or raise the cap |
A request refused with wallet_exhausted | The account is out of credit. Waiting does not help | Top up the wallet |
There's an issue with the selected model (claude-opus-5-5[1m]) | /model's 1M context option appends [1m], which Cruise answers with model_not_found. Slash commands use the same model, so they fail too | Run /cruise:disconnect (it needs no model), or quit Claude Code and run npx @bytesbrains/claude-code-cruise@latest disable (or switch bb/agentic-coding) in a terminal. Pick a Cruise lane in /model, not a 1M option |
There's an issue with the selected model (google-ai-studio/gemini-3.8-flash) on your subscription, and /model keeps it | env.ANTHROPIC_MODEL still names a provider/model but Cruise routing is off, so Anthropic rejects it. The env var overrides /model. The plugin warns about this when a session starts, naming where the value is set | Run /cruise:disconnect (it needs no model), or quit Claude Code and run npx @bytesbrains/claude-code-cruise@latest disable (--local if the model is in ./.claude/settings.json). If the model is set somewhere disable does not edit (.claude/settings.local.json or a shell export), disable and status name the file or say "shell environment", with the fix (#42). Confirm with /status after restarting |
switch refuses: only resolves through a gateway, and Cruise routing is not enabled | A lane or provider/model written with no gateway configured would make Anthropic reject every request | Run enable first, use npx @bytesbrains/claude-code-cruise@latest run --model <id> for one session, or pass --force |
HTTP 400: Function call is missing a thought_signature in functionCall parts | Google Gemini models with thinking enabled fail multi-turn tool calling in Claude Code (bytesbrains-cruise#543) | Switch to bb/agentic-coding or anthropic/claude-sonnet-5 (via /cruise:switch bb/agentic-coding or npx @bytesbrains/claude-code-cruise@latest switch bb/agentic-coding), or run /clear to reset conversation context |
Claude Code warning: "<model>" isn't described by this version's model catalog | Claude Code restricts uncataloged models to 200k tokens by default | Cruise automatically sets CLAUDE_CODE_MAX_CONTEXT_TOKENS=1000000 and CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 to guarantee a 1M token context window for agentic coding and silence the warning |
