Claude Code

How to route Claude Code through Aramm with the smallest possible configuration change.

Claude Code works well with Aramm because it already reads Anthropic-style environment variables. The MVP path is just the Aramm base URL, your API key, and a provider/model id.

What you need

  • An Aramm API key
  • Claude Code installed locally
  • A model id such as anthropic/claude-sonnet-4-6

Quick setup

Option 1: settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://router.aramm.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_ARAMM_API_KEY",
    "ANTHROPIC_MODEL": "anthropic/claude-sonnet-4-6"
  }
}

Option 2: shell variables

export ANTHROPIC_BASE_URL="https://router.aramm.ai"
export ANTHROPIC_AUTH_TOKEN="YOUR_ARAMM_API_KEY"
export ANTHROPIC_MODEL="anthropic/claude-sonnet-4-6"

Then run claude.

Model naming

Aramm model ids use the provider/model format.

  • anthropic/claude-sonnet-4-6
  • openai/gpt-4o
  • google/gemini-2.5-flash

Verify it works

Start Claude Code and confirm the first request completes without a model or auth error.

Troubleshooting

  • 401 usually means the API key is wrong or missing.
  • model not found usually means the model id does not match Aramm's format.
  • Connection errors usually mean the base URL still points at Anthropic instead of https://router.aramm.ai.

On this page