Gateway and Claude Code Router

flowchart TB
  subgraph gateSign["Gateway sign-in"]
    flm["forceLoginMethod gateway"]
    flu["forceLoginGatewayUrl"]
  end
  subgraph otherGw["Other gateway including CCR"]
    base["ANTHROPIC_BASE_URL"]
    keep["Does not replace a saved claude.ai login"]
  end
  flm --> flu
  base --> keep

flowchart TB
  req["Gateway request"]
  allow{"Model granted to the IdP group"}
  deny["400"]
  cap{"Optional USD cent cap"}
  ok["Call the configured upstream"]
  over["429 billing_error"]
  req --> allow
  allow -->|"no"| deny
  allow -->|"yes"| cap
  cap -->|"under or no cap"| ok
  cap -->|"over cap"| over

flowchart TB
  subgraph gwA["Gateway"]
    oidc["OIDC one issuer"]
    bearer["Short-lived bearer default ttl_hours 1"]
    cred["Upstream credential stays on the gateway"]
  end
  subgraph ccrA["CCR"]
    web["Management token"]
    client["Separate client API keys"]
    local["Upstream keys in the local data directory"]
  end
  oidc --> bearer
  bearer --> cred
  web --> client
  client --> local

flowchart TB
  key["CCR client key"]
  lim["Local request token and image limits"]
  log["Logs show an estimated cost"]
  noOrg["No organisation Admin API in pages fetched"]
  key --> lim
  lim --> log
  key --> noOrg

sequenceDiagram
  participant Code as Claude Code
  participant Gate as Apps gateway
  participant Up as Configured upstream
  Code->>Gate: Anthropic Messages API
  Gate->>Up: Model id translated for that upstream
  Up-->>Gate: Provider response
  Gate-->>Code: Messages response

sequenceDiagram
  participant Agent as Agent
  participant Ccr as CCR gateway
  participant Prov as Selected provider
  Agent->>Ccr: Request to the local gateway
  Ccr->>Prov: Call after route and fallback
  Prov-->>Ccr: Provider response
  Ccr-->>Agent: Response

flowchart LR
  subgraph appsGw["Claude apps gateway"]
    p8080["Listener host 0.0.0.0 port 8080"]
    purl["Separate public_url"]
  end
  subgraph ccrLocal["CCR defaults"]
    p3456["Model gateway port 3456"]
    p3458["Management UI port 3458"]
  end
  p8080 --> purl
  p3458 -->|"Docker front door proxies to 3456"| p3456

flowchart LR
  org["Organisation"]
  keep["Hold the upstream and the data plane"]
  gw["Claude apps gateway"]
  user["User"]
  route["One local endpoint to chosen providers"]
  ccr["Claude Code Router"]
  org --> keep
  keep --> gw
  user --> route
  route --> ccr

flowchart TB
  shape["Claude Code request shape changes"]
  gwShip["Apps gateway ships with the CLI"]
  other["A separate gateway"]
  ccrDoc["CCR README and troubleshooting"]
  off["Gateway session turns listed features off"]
  drop["Dropped new headers or body fields break features"]
  gap["Request-shape outcome not documented there"]
  shape --> gwShip
  gwShip --> off
  shape --> other
  other --> drop
  shape --> ccrDoc
  ccrDoc --> gap

flowchart TB
  row["One concern per row"]
  left["Left cell is Claude apps gateway"]
  right["Right cell is Claude Code Router"]
  gap["A hole stays unverified"]
  row --> left
  row --> right
  row --> gap

flowchart TB
  gaps["Unverified on 3 October 2026"]
  yaml["Full gateway.yaml reference"]
  schema["Current CCR JSON schema"]
  shape["CCR when the request shape changes"]
  native["CCR native Bedrock Foundry or Vertex"]
  lic["claude binary licence"]
  forks["Fork count"]
  gaps --> yaml
  gaps --> schema
  gaps --> shape
  gaps --> native
  gaps --> lic
  gaps --> forks

flowchart LR
  anth["Anthropic docs fetched 3 Oct 2026"]
  gh["CCR README"]
  npm["npm page"]
  desk["ccrdesk guides fetched"]
  page["This comparison"]
  anth --> page
  gh --> page
  npm --> page
  desk --> page