Agent Setup

Connect your local AI agent to WaveSpeed LLM

Pick an agent, choose a WaveSpeed model, copy the right local config file, and route requests through the protocol that agent expects.

Use WaveSpeed through Claude Code's Anthropic-compatible gateway mode.

Config file

~/.claude/settings.json

Protocol

Anthropic Messages API

Endpoint

/v1/messages

Manual setup

1

Create a WaveSpeed access key

2

Export the required key locally

3

Paste config into~/.claude/settings.json

4

Run claude and check Logs

OpenAI-compatible chat completions

Usage appears in Dashboard and Logs

Switch models without rewriting agent code

One-command setup

Configures Claude Code, checks that it works, and backs up your previous settings. Add --undo to restore them.

  1. 1

    Install the WaveSpeed CLI

    npm install -g @wavespeed/cli
  2. 2

    Sign in

    wavespeed login
  3. 3

    Configure Claude Code

    wavespeed setup claude

No Node.js? See other install options

Claude Desktop is set up in its own settings, not with this command. See the Claude Desktop guide

Manual setup

Edit ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "wsk_live_...",
    "ANTHROPIC_BASE_URL": "https://llm.wavespeed.ai",
    "ANTHROPIC_MODEL": "deepseek/deepseek-v4.1-flash-1017",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek/deepseek-v4.1-flash-1017",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek/deepseek-v4.1-flash-1017",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek/deepseek-v4.1-flash-1017"
  }
}
Replace wsk_live_... with your real WaveSpeed API key before saving this Claude Code settings file.

Use WaveSpeed AI as an LLM agent gateway

Configure Codex, Claude Code, OpenClaw, OpenCode, Hermes and other OpenAI-compatible developer agents with one base URL, one key, and the model you already selected from WaveSpeed AI.

Can I use WaveSpeed LLM models with Codex?

Yes. Use the OpenAI-compatible base URL, your WaveSpeed API key, and a supported model id in the Codex provider configuration.

Does this work with Claude Code, OpenClaw, OpenCode and Hermes?

Yes. The setup page provides copy-ready environment variables and configuration examples for Claude Code, OpenClaw, OpenCode, Hermes and OpenAI-compatible agents.

Where do I get my API key?

Create or copy an access key from the WaveSpeed AI Access Key page, then paste it into your local agent environment.