Claude Code Max Gateway

Documentation Index

Fetch the complete documentation index at: https://docs.costa.app/llms.txt

Use this file to discover all available pages before exploring further.

​

Prerequisites

• A Costa API key (get one from https://ai.costa.app)
• Claude Code installed

​

Setup

costa setup claude

vim ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.costa.app/api",
    "ANTHROPIC_CUSTOM_HEADERS": "costa-api-key: YOUR_COSTA_KEY_HERE"
  },
  "statusLine": {
    "command": "costa status --format claude-code",
    "padding": 0,
    "type": "command"
  }
}

​

Verification

​

Troubleshooting

• Configuration not applied: Make sure you saved ~/.claude/settings.json and restarted Claude Code
• JSON syntax errors: Verify your JSON is valid (no trailing commas, proper quotes)
• Authentication errors: Verify your Costa API key is correct and active
• Connection errors: Check that you can reach https://ai.costa.app/api
• Settings file doesn’t exist: Create the ~/.claude directory first with mkdir -p ~/.claude