Use the Wokey API with Claude Desktop

Get a Wokey API key, point Claude Desktop at the Wokey base URL, then confirm the connection with one curl request.

vpn_key

Get an API key and the base URL

Every client uses the same Wokey API key and the same base URL.

Create an API key

Sign in and create a platform key on the API page. Keys in one account share its balance.

Create an API keykey

Use the Wokey base URL

Set the client base URL to the gateway domain; the configuration below shows whether to append /v1.

terminal

Configure the client

Point the client at Wokey with the configuration below.

Claude Desktop

Claude Desktop requires the latest app and uses developer mode to configure third-party inference. Follow the steps on the left.

  1. 1

    Install the latest Claude Desktop

    Update to the latest version first. Older versions may not include Developer mode or third-party inference settings.

  2. 2

    Open the app without signing in

    Launch Claude Desktop and stay signed out for the initial setup.

  3. 3

    Enable Developer mode

    Open the top-right menu and choose Help → Troubleshooting → Enable developer mode.

  4. 4

    Open third-party inference settings

    After Developer mode is enabled, open the Claude menu and choose Developer → Configure third-party inference.

  5. 5

    Enter the Wokey connection

    Set Connection to Gateway and Credential kind to Static API key. Enter the Wokey Base URL and your Wokey API key.

  6. 6

    Apply the configuration

    Choose Apply locally to save the settings, then sign in and start using Claude Desktop.

Claude Desktop
Connection: Gateway
Credential kind: Static API key
URL: https://api.wokey.ai
API key: YOUR_API_KEY

Apply: Apply locally
task_alt

Verify with curl

If the client reports an error, rule out the key and base URL with curl first.

Claude Desktop 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
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" }
    ]
  }'
troubleshoot

Errors & Troubleshooting

Separate auth, balance, rate limit, model availability, and upstream timeout cases first.

401

invalid api key

The key is missing, mistyped, deleted, or Authorization / x-api-key headers conflict.

402

insufficient balance

The account balance is too low. Top up before sending more requests.

429

rate limited

Traffic is too frequent. Retry later or reduce concurrency.

502

upstream unavailable

The upstream model service is temporarily unavailable. Switch models or retry later.

504

upstream timeout

The upstream response timed out. Shorten context, reduce max_tokens, or retry.

529

upstream insufficient quota

The official upstream route is out of quota. Wait for routing recovery or switch models.