Claude Code Max Gateway

Prerequisites

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

Setup

CLI
Manual

The fastest way to set up Claude Code with Costa is using the Costa CLI :

costa setup claude

That’s it! Your Claude Code is now configured to use Costa.

If you prefer to configure manually, open your Claude Code settings file:

vim ~/.claude/settings.json

Add the following configuration:

{
  "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"
  }
}

Replace YOUR_COSTA_KEY_HERE with your actual Costa API key.Save the file and restart Claude Code.

Verification

After saving the settings file, restart Claude Code. You can verify the configuration is working by checking the status line (if configured) or by running a Claude Code command - it should now route through Costa Code.

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

Getting Started

Core Concepts

Utilities

Integrations

Prerequisites

Setup

Verification

Troubleshooting

Getting Started

Core Concepts

Utilities

Integrations

​Prerequisites

​Setup

​Verification

​Troubleshooting

Prerequisites

Setup

Verification

Troubleshooting