Use a API da Wokey com o Z Code

1. 1

   Abra as configurações de modelo

   Clique no nome do modelo na caixa de chat → Manage Models, ou vá em Settings → Model Settings.

2. 2

   Adicione o provider

   Clique em Add Provider e dê o nome Wokey. Para o formato da Anthropic, defina Base URL como https://api.wokey.ai; para o formato da OpenAI, como https://api.wokey.ai/v1. Cole sua chave de API da Wokey em API Key.

3. 3

   Adicione e ative um modelo

   Sob o provider, clique em Add Model, informe um ID de modelo como claude-opus-5-5 e ative a chave de ativação dele.

4. 4

   Troque de modelo

   De volta à caixa de chat, escolha o modelo que você adicionou na lista de modelos e envie uma mensagem curta para confirmar.

Provider name: Wokey
API format: Anthropic
Base URL: https://api.wokey.ai
API Key: YOUR_API_KEY
Model ID: claude-opus-5-5

Onde é configurado: Settings → Model Settings (arquivo ~/.zcode/v2/config.json)

Z Code usa o formato Anthropic Messages por padrão. Se esta requisição retornar 200, a chave e a base URL estão corretas. Substitua YOUR_API_KEY pela sua chave antes de enviar.

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

A URL base do Z Code deve terminar em /v1?

Depende do formato de API com que você se conecta. Para Anthropic use https://api.wokey.ai sem /v1; para OpenAI use https://api.wokey.ai/v1.

Por que as variáveis de ambiente que exportei no terminal são ignoradas?

As variáveis de ambiente do terminal e a configuração de modelos do app desktop do Z Code são separadas e não são sincronizadas. Informe a URL base e a chave de API no provider em Settings → Model Settings.

O provider foi adicionado. Por que não consigo escolher um modelo?

Cada provider também precisa de Add Model com um ID de modelo, e da chave de ativação do modelo ligada, antes que ele apareça na lista de modelos da caixa de chat.

E se a saída for cortada ou o contexto for pequeno demais?

Abra Advanced no modelo e ajuste Max output tokens e a janela de contexto para os valores da página do modelo. Um modelo recém-adicionado tem janela de contexto padrão de 200000.

Onde o Z Code armazena esta configuração?

Em ~/.zcode/v2/config.json. Faça backup do arquivo antes de trocar de máquina ou reinstalar; ele contém sua chave de API, então não o compartilhe.