Clientes/Todos os clientes

Configuração de clientes

Cada cliente precisa apenas da URL base da Wokey e de uma chave de API. Escolha o seu cliente para ver a configuração.

Nesta páginaexpand_more

Agentes de código no terminal
Clientes de desktop e chat
Agentes sempre ativos
Gateways de modelos
Referência de base URL

Agentes de código no terminallink

Agentes que leem e escrevem código e executam comandos em um terminal, configurados por variáveis de ambiente ou um arquivo de configuração.

Claude Codearrow_forwardO Claude Code usa variáveis de ambiente compatíveis com a Anthropic e envia ANTHROPIC_AUTH_TOKEN como token Authorization Bearer.Formato padrão: Anthropic Messages Codexarrow_forwardO Codex CLI e o app de desktop do Codex compartilham a mesma configuração, então o passo a passo abaixo vale para os dois. O Codex usa o protocolo Responses. Mantenha base_url na origem do gateway, sem /responses. Substitua YOUR_API_KEY pela sua chave de API da Wokey em experimental_bearer_token, sem o prefixo Bearer. Remova qualquer configuração env_key existente; não é preciso exportar variável de ambiente. Salve o arquivo e execute codex. A chave fica salva em texto puro na configuração local.Formato padrão: OpenAI Responses opencodearrow_forwardUm único comando grava o provider da Wokey e muda o modelo padrão para wokey/auto.Formato padrão: OpenAI Chat Completions Grok CLIarrow_forwardUse a configuração oficial do Grok CLI para se conectar à Wokey. Adicione uma entrada de modelo grok-4.7 com seu próprio api_key; o api_key de uma entrada de modelo tem prioridade sobre a sessão do grok login, então as requisições Responses vão para o gateway da Wokey.Formato padrão: OpenAI Responses piarrow_forwardO pi lê providers personalizados de models.json. A configuração abaixo chama os modelos Claude pelo Anthropic Messages; para GPT, DeepSeek e outros modelos, adicione um segundo provider com api definido como openai-completions e um baseUrl terminado em /v1.Formato padrão: Anthropic Messages DeepSeek Harnessarrow_forwardO DeepSeek Harness (dsh) aceita gateways personalizados, então uma única chave da Wokey cobre os modelos DeepSeek, GPT, GLM e Claude. deepseek-v4.1-flash suporta Chat Completions, Responses e Anthropic Messages; a configuração abaixo coloca Claude Opus 5.5 e DeepSeek-V4.1-Flash sob um mesmo provider Anthropic Messages e declara entrada de imagem para ambos.Formato padrão: OpenAI Chat Completions

Clientes de desktop e chatlink

Apps com interface gráfica, nos quais você adiciona um provedor personalizado na página de configurações.

Claude Desktoparrow_forwardO Claude Desktop exige a versão mais recente do app e usa o modo de desenvolvedor para configurar a inferência de terceiros. Siga os passos à esquerda.Formato padrão: Anthropic Messages Z Codearrow_forwardO Z Code adiciona providers personalizados na página de configurações e suporta os formatos de API da Anthropic e da OpenAI. Use o formato da Anthropic para os modelos Claude.Formato padrão: Anthropic Messages Cherry Studioarrow_forwardO Cherry Studio adiciona providers personalizados em Model Provider. O endpoint da OpenAI basta para chamar todos os modelos da Wokey pelo Chat Completions, e o mesmo provider também pode receber um endpoint da Anthropic.Formato padrão: OpenAI Chat Completions WorkBuddyarrow_forwardO WorkBuddy usa OpenAI Chat Completions para modelos personalizados. No WorkBuddy, abra Settings → Model → Custom models e informe o endpoint da Wokey, a chave de API e deepseek-v4.1-flash; assim as tarefas e os fluxos de agente do WorkBuddy podem usar chamadas de ferramentas e entrada de imagem.Formato padrão: OpenAI Chat Completions

Agentes sempre ativoslink

Agentes que ficam rodando no seu próprio computador ou servidor e recebem tarefas por apps de chat.

OpenClawarrow_forwardGrave um provider personalizado compatível com OpenAI com um único comando.Formato padrão: OpenAI Chat Completions Hermes Agentarrow_forwardO Hermes Agent só precisa das cinco primeiras linhas de configuração: modelo, provider personalizado, Base URL e chave de API. Para modelos GPT (como gpt-6-sol), adicione api_mode: codex_responses para a melhor taxa de acerto de cache; deixe de fora para outros modelos, como o Claude.Formato padrão: OpenAI Chat Completions

Gateways de modeloslink

Gateways que rodam no seu computador, usam a Wokey como upstream e atendem vários agentes a partir dela.

Magpiearrow_forwardO Magpie é um gateway de modelos que roda no seu computador. Depois que a Wokey é adicionada como provider, todos os agentes do computador podem chamar os modelos da Wokey por ele. O Magpie guarda um endereço por formato de API, e um único comando define os três.Formato padrão: OpenAI Chat Completions

Referência de base URLlink

A base URL que cada cliente usa para cada formato de API e onde o cliente guarda essa configuração. Clientes sem página própria também aparecem.

Cliente	Formato	Base URL	Onde é configurado
Claude Code	Anthropic Messages	https://api.wokey.ai	Variáveis de ambiente, ou env em ~/.claude/settings.json
Codex	OpenAI Responses	https://api.wokey.ai	~/.codex/config.toml
Claude Desktop	Anthropic Messages	https://api.wokey.ai	Menu Developer → Configure third-party inference
opencode	OpenAI Chat Completions	https://api.wokey.ai	~/.config/opencode/opencode.json
Grok CLI	OpenAI Responses	https://api.wokey.ai	~/.grok/config.toml
pi	Anthropic MessagesOpenAI Chat CompletionsOpenAI Responses	https://api.wokey.aihttps://api.wokey.ai/v1https://api.wokey.ai/v1	~/.pi/agent/models.json
DeepSeek Harness	OpenAI Chat CompletionsAnthropic Messages	https://api.wokey.ai/v1https://api.wokey.ai	~/.dsh/profiles/web/cordis.patch.yml
Z Code	Anthropic MessagesOpenAI Chat Completions	https://api.wokey.aihttps://api.wokey.ai/v1	Settings → Model Settings (arquivo ~/.zcode/v2/config.json)
Cherry Studio	OpenAI Chat CompletionsAnthropic Messages	https://api.wokey.aihttps://api.wokey.ai	Settings → Model Provider → Add Provider
WorkBuddy	OpenAI Chat Completions	https://api.wokey.ai	Settings → Models → Custom models
OpenClaw	OpenAI Chat Completions	https://api.wokey.ai	Flags do comando openclaw onboard
Hermes Agent	OpenAI Chat Completions	https://api.wokey.ai	~/.hermes/config.yaml
Magpie	OpenAI Chat CompletionsOpenAI ResponsesAnthropic Messages	https://api.wokey.ai/v1https://api.wokey.ai/v1https://api.wokey.ai	magpie provider add ou um link de importação (arquivo ~/.config/magpie/providers.json)
Cline / Kilo Code / Roo Code	OpenAI Chat Completions	https://api.wokey.ai/v1	Configurações da extensão, escolha OpenAI Compatible (Kilo Code: Providers → Custom provider)
Aider	OpenAI Chat Completions	https://api.wokey.ai/v1	Variáveis de ambiente OPENAI_API_BASE e OPENAI_API_KEY; o modelo como openai/nome-do-modelo
Zed	OpenAI Chat Completions	https://api.wokey.ai/v1	language_models.openai_compatible em settings.json
n8n	OpenAI Chat Completions	https://api.wokey.ai/v1	Base URL na credencial da OpenAI

Chamando a API diretamente com curl ou um SDK? Os exemplos de requisição de cada formato estão em Endpoints