Claude Code

Configure Claude Code, Anthropic’s official CLI coding agent, to use Eden AI for access to 500+ models behind a single API key.

Overview

Claude Code runs in your terminal and edits code in your project. Pointing it at Eden AI gives you:

500+ models: switch between Claude, GPT, Gemini, and more without reinstalling
One API key: unified billing and monitoring across providers
Provider failover: keep working when an upstream provider has an incident

Prerequisites

Claude Code installed (install instructions)
Eden AI API key from app.edenai.run → API Keys

Setup

1. Export your API key

export ANTHROPIC_API_KEY="YOUR_EDEN_AI_API_KEY"
export ANTHROPIC_BASE_URL="https://api.edenai.run/v3"
export ANTHROPIC_MODEL="anthropic/claude-opus-4.7"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4-7"

$env:ANTHROPIC_API_KEY = "YOUR_EDEN_AI_API_KEY"
$env:ANTHROPIC_BASE_URL = "https://api.edenai.run/v3"
$env:ANTHROPIC_MODEL = "anthropic/claude-opus-4-7"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4-6"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4-7"

To make it permanent, add the export lines to ~/.bashrc or ~/.zshrc and reload your shell.

2. Launch Claude Code

claude

Claude Code now sends requests to Eden AI using the model you set in ANTHROPIC_MODEL.

Switching models

Eden AI uses the provider/model format. Update the ANTHROPIC_MODEL environment variable (or pass --model on the command line) to switch:

export ANTHROPIC_MODEL="anthropic/claude-opus-4-7"     # default
export ANTHROPIC_MODEL="anthropic/claude-sonnet-4-5"   # cheaper, faster
export ANTHROPIC_MODEL="anthropic/claude-haiku-4-5"    # fastest

export ANTHROPIC_MODEL="openai/gpt-4o"
export ANTHROPIC_MODEL="google/gemini-2.5-pro"

Browse the full catalog via List Models or GET https://api.edenai.run/v3/models.

Expert Models as Tools (MCP)

Eden AI also hosts an MCP server that exposes the expert model catalog (OCR, web search, speech, translation and more) as tools. Add it and Claude Code can read documents or search the web through the same API key:

claude mcp add --transport http edenai https://mcp.edenai.run/mcp \
  --header "Authorization: Bearer YOUR_EDEN_AI_API_KEY"

To share it with your team instead, commit the equivalent block to the project’s .mcp.json:

{
  "mcpServers": {
    "edenai": {
      "type": "http",
      "url": "https://mcp.edenai.run/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_EDEN_AI_API_KEY"
      }
    }
  }
}

Keep the type field: without it Claude Code reads the entry as a stdio server. Run /mcp to confirm the connection. See the MCP server page for the full tool catalog and the conventions its tools share.

Troubleshooting

Authentication errors

Verify the API key is loaded in your shell and that it has LLM access:

echo $ANTHROPIC_API_KEY

curl -X POST https://api.edenai.run/v3/chat/completions \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "anthropic/claude-opus-4.7", "messages": [{"role": "user", "content": "ping"}]}'

Model not found

Use the full provider/model string (e.g. anthropic/claude-opus-4.7, not claude-opus-4.7). Confirm the ID is in the catalog returned by GET /v3/models.

Connection issues

Confirm ANTHROPIC_BASE_URL is exactly https://api.edenai.run/v3. Check Eden AI status at app-edenai.instatus.com.

Next Steps

Codex CLI — OpenAI’s open-source coding agent on Eden AI
OpenCode — terminal coding agent with auto-generated config
Chat Completions — full reference for the underlying endpoint

V3 Documentation

Quick Start

Overview

LLMs

Expert Models

General

Organization

Data Governance

Integrations

Overview

Prerequisites

Setup

1. Export your API key

2. Launch Claude Code

Switching models

Expert Models as Tools (MCP)

Troubleshooting

Authentication errors

Model not found

Connection issues

Next Steps

​Overview

​Prerequisites

​Setup

​1. Export your API key

​2. Launch Claude Code

​Switching models

​Expert Models as Tools (MCP)

​Troubleshooting

​Authentication errors

​Model not found

​Connection issues

​Next Steps

Overview

Prerequisites

Setup

1. Export your API key

2. Launch Claude Code

Switching models

Expert Models as Tools (MCP)

Troubleshooting

Authentication errors

Model not found

Connection issues

Next Steps