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?

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.
