Skip to main content
Documentation

Read the docs

Everything you need to integrate ClaudeShield with AgentRouter.

Copy, paste, ship fast.
Claude Proxy Mascot (inspecting)

Overview

ClaudeShield is a local reliability proxy that sits between Claude Code (or any Anthropic-compatible client) and AgentRouter.

It solves one problem: gateway errors that crash your session.

# What it does

403 quota -> 429 + Retry-After (client retries)

504 timeout -> 429 + Retry-After (client retries)

200 + SSE error -> 503 (client retries)

403 no model -> pass through (fail fast)

  • Pure Python 3.8+ standard library - zero dependencies
  • Runs locally on 127.0.0.1:8787
  • Injects the claude-cli/1.0.0 User-Agent AgentRouter requires
  • Detects Chinese error messages (用户额度不足)