Seedream 5.0 Flash is LIVE — Faster & Cheaper | Try Now →
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.

Config file

~/.codex/config.toml

Protocol

OpenAI Responses API

Endpoint

/v1/responses

Quick start

1

Create a WaveSpeed access key

2

Export the required key locally

3

Paste config into~/.codex/config.toml

4

Run codex and check Logs

OpenAI-compatible chat completions

Usage appears in Dashboard and Logs

Switch models without rewriting agent code

Edit ~/.codex/config.toml
# File: ~/.codex/config.toml

model = "openai/gpt-oss-120b"
model_provider = "wavespeed"

[model_providers.wavespeed]
name = "WaveSpeedAI"
base_url = "https://llm.wavespeed.ai/v1"
env_key = "WAVESPEED_API_KEY"
wire_api = "responses"

Do not replace the variable name

WAVESPEED_API_KEY is the environment variable name that the agent reads. Keep this name in the config file, and put your real API key in your shell instead.

1

Temporary for this terminal

Works until you close this terminal window.

export WAVESPEED_API_KEY="wsk_live_..."
2

Keep it after restart

Writes the key into your shell profile so new terminals can read it.

echo 'export WAVESPEED_API_KEY="wsk_live_..."' >> ~/.zshrc
source ~/.zshrc

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.