Skip to main content
Claude Code speaks the Anthropic Messages protocol. Private AI Proxy configures it automatically.

With Private AI Proxy

  1. Install Private AI Proxy, sign in, and turn on Protected.
  2. On the Agents screen, connect Claude Code.
  3. Start claude.
The app writes the Messages provider into Claude Code’s settings with an agent-scoped token for its local API, and restores the previous settings when you disconnect or stop Protected. From the CLI, the same connection is:

Without the Proxy

Set the base URL to the host without /v1; Claude Code appends /v1/messages itself.
ANTHROPIC_AUTH_TOKEN sends the key as a bearer token; clearing ANTHROPIC_API_KEY stops an existing Anthropic key from adding a conflicting x-api-key header. Gateway model discovery loads RedPill models into the /model picker. Map the family aliases if plan mode or background work needs them: ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL. This path does not verify ACI locally. For confidential-only routing, use an is_tee: true model with https://tee.redpill.ai. See Verified ACI clients.

Check the connection

Run /status in Claude Code. With the Proxy, the base URL is http://127.0.0.1:4180; without it, https://api.redpill.ai. Confirm the bearer credential source and the selected model.

Troubleshooting

References