Skip to main content
Questions & Answers

FAQ & Troubleshooting

Everything you need to know about proxy behavior, error conversion, and setup troubleshooting.

Frequently Asked Questions

AgentRouter returns 403 for quota limits (e.g. 用户额度不足). Claude Code treats 403 as a permanent error and stops. By converting recognized quota 403s into 429 with Retry-After, Claude Code's watchdog retries automatically. Genuine permission denials stay 403 and are not retried.
Got questions?
Claude Proxy Mascot (inspecting)

Still need assistance?

Our open-source GitHub issues page is monitored by community builders.

Troubleshooting Guide

Connection Refused (ECONNREFUSED)

Symptom

Claude Code shows 'Error: connect ECONNREFUSED 127.0.0.1:8787'

Solution

The proxy isn't running. Start it first: 'python retry-proxy.py --start'.

Invalid AgentRouter Key

Symptom

HTTP 401 Unauthorized on every request

Solution

Check your API key in ~/.claude/settings.json. The proxy forwards it to AgentRouter - if it's wrong, AgentRouter returns 401.

Still Receiving Hard 403 Errors

Symptom

Session terminates with 403 Forbidden

Solution

Check proxy logs - this means the error is a genuine permission denial, not a rate limit. Only recognized quota 403s are converted.