Skip to content
Agent Gateway
Coding assistants

Claude Code

Use Edgee with Claude Code to cut token costs and extend sessions, with zero manual configuration.

Claude Code is Anthropic's official CLI tool for interactive coding with AI assistance. Route your Claude Code traffic through Edgee to cut token costs by 15-20% with lossless compression, and gain full observability over every coding session. (Our SWE-bench Lite benchmark measures 50% with all three strategies on: see what you'll actually save.)

Edgee works with your existing Claude subscription, including Claude Pro, Premium, and Max.

The fastest way to connect Claude Code to Edgee is through the CLI, no manual API key setup or environment variables needed.

Install the Edgee CLI

curl -fsSL https://edgee.ai/install.sh | bash

# Accept the alias prompt (recommended).
# If skipped: edgee alias
# Reopen your terminal afterward.

Launch Claude Code through Edgee

Choose how you want to launch. Both options route requests through Edgee.

With aliases installed in the previous step, use your usual command:

claude

The alias runs edgee launch for you, so requests go through Edgee.

If you are not signed in, Edgee starts sign-in automatically at launch. Follow the prompts and select your organization when asked.

The CLI authenticates, configures routing, and starts Claude Code, all in one command. Token compression is enabled automatically.

After the session ends, the CLI prints a link to view token usage, compression savings, and cost breakdown in the Edgee Console.

Manual setup (advanced)

Get your coding-agent key

Manual setup uses the key of your enrolled Claude Code agent, not a standard API key created for LLM Router applications.

  1. Open the Edgee Console and select your organization.
  2. In the header, click Set up coding agent or +, select Claude Code, and click Enroll. If your agent is already enrolled, use its existing icon.
  3. Click the agent's icon, then Advanced settings → Advanced.
  4. Under Edgee API key (for manual setup), click Reveal key, then the copy icon.

Use this key wherever the configuration below shows <YOUR_CODING_AGENT_KEY>.

Configure Claude Code

Claude Code supports custom API endpoints through its settings. You can configure it to use Edgee as your AI provider in two ways:

Option 1: Environment Variables

Set the following environment variables in your shell configuration (~/.bashrc, ~/.zshrc, etc.):

export ANTHROPIC_BASE_URL="https://edgee.io"
export ANTHROPIC_CUSTOM_HEADERS="x-edgee-api-key:<YOUR_CODING_AGENT_KEY>"

Then restart your terminal or run:

source ~/.zshrc  # or ~/.bashrc

Option 2: Claude Code Settings

You can also configure Claude Code through its settings file. Create or edit ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://edgee.io",
    "ANTHROPIC_CUSTOM_HEADERS": "x-edgee-api-key:<YOUR_CODING_AGENT_KEY>"
  }
}

Usage

Keep launching through Edgee so the request uses your configured gateway:

edgee launch claude "Explain this repository"

Arguments after the agent name are forwarded to the installed agent. Use that agent's current help for its supported flags. A bare claude command routes through Edgee only if you have installed an alias.

Verify the connection

Send one request from the configured client, then open Logs in the same Edgee organization. Check the served model, provider, and key. For a CLI-launched coding agent, also inspect its session report.

If the request is missing, check that you launched through Edgee or saved the client’s gateway URL and coding-agent key. If it appears with an error, inspect the error before changing settings. See Troubleshooting and Gateway errors.