Disclosure: independent site. Links to AgentRouter are referral links — we may earn a reward if you sign up, at no extra cost to you. We do not publish pricing or promo numbers we have not verified.

Error fixes

Each page targets one error, names the causes in order of likelihood, and gives you a command that proves which one you have. No preamble, no history of AI — the diagnostic is the first thing on the page.

Pick your symptom

The general method

If your exact error isn't listed, this sequence localises almost any coding-agent connection problem in a few minutes.

  1. Establish which layer fails. Connection refused is network. 401 is credential. 404 is model or path. 429 is rate. Each points somewhere completely different.
  2. Reproduce it with curl outside your tool. If curl works and the tool doesn't, the problem is the tool's configuration or environment, not the endpoint.
  3. Print the environment from the same context the tool runs in. A variable exported in your shell may never reach a GUI-launched process.
  4. List the endpoint's models and copy an id verbatim rather than assuming a naming convention.
  5. Change one thing at a time and re-verify with a real request after each change.

Every page here follows the same rule: reproduce the failure with a command before changing configuration. Most time lost to these errors is spent editing config files while the actual failure sits one layer away.

When the fix really is a different endpoint

Work the diagnostic first — most of these errors are configuration. But a few genuinely resolve to needing an endpoint that serves the model you want, or one you can point every tool at with the same base URL. AgentRouter is OpenAI-compatible with published per-token pricing and documented setup for 15 tools, so it satisfies that case without an adapter and without a subscription window.

Look at the setup guides →

Referral link — we may earn a reward if you sign up, at no extra cost to you. This is the same advice we would give with no link at all. Check their current pricing and model list on their own site; we deliberately do not restate numbers that change.

Related

Error not on this page?

The Setup Doctor walks through your tool, symptom, and setup and points at the likely cause — no account needed.

Diagnose my error →