Get a Wokey API key, point Claude Code at the Wokey base URL, then confirm the connection with one curl request.
Every client uses the same Wokey API key and the same base URL.
Sign in and create a platform key on the API page. Keys in one account share its balance.
Create an API keykeySet the client base URL to the gateway domain; the configuration below shows whether to append /v1.
Point the client at Wokey with the configuration below.
Claude Code uses Anthropic-compatible environment variables and sends ANTHROPIC_AUTH_TOKEN as an Authorization Bearer token.
export ANTHROPIC_BASE_URL="https://api.wokey.ai"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
claudeIf the client reports an error, rule out the key and base URL with curl first.
Claude Code uses the Anthropic Messages format by default. A 200 from this request means the key and base URL are right. Replace YOUR_API_KEY with your key before sending it.
curl https://api.wokey.ai/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [
{ "role": "user", "content": "Hello" }
]
}'Separate auth, balance, rate limit, model availability, and upstream timeout cases first.
The key is missing, mistyped, deleted, or Authorization / x-api-key headers conflict.
The account balance is too low. Top up before sending more requests.
Traffic is too frequent. Retry later or reduce concurrency.
The upstream model service is temporarily unavailable. Switch models or retry later.
The upstream response timed out. Shorten context, reduce max_tokens, or retry.
The official upstream route is out of quota. Wait for routing recovery or switch models.