DevWorld

Sua chave de API

A chave é o que identifica o seu plano. Ela se parece com dw_live_aAR1… e é enviada em toda conversa que os aplicativos fazem com a gente. Quem tem a chave consome o seu plano, então trate ela como uma senha: não publique em prints, repositórios ou grupos.

1. Peça a sua chave

   Fale com o nosso bot no Telegram e escolha o plano. Abrir o bot e pegar uma chave. Você recebe a chave na hora, em uma mensagem.

2. Guarde em um lugar seguro

   Salve no gerenciador de senhas do seu navegador ou em um bloco de notas privado. Se você usar o Launcher, ele guarda a chave no cofre do sistema operacional e você não precisa digitar de novo.

3. Se for usar Codex, OpenCodex ou código, crie uma variável de ambiente

   Algumas ferramentas leem a chave de uma variável chamada DEVWORLD_API_KEY em vez de guardar em arquivo. É mais seguro e evita colar a chave em lugares errados. Escolha o seu sistema:

setx DEVWORLD_API_KEY "dw_live_sua_chave_aqui"

echo 'export DEVWORLD_API_KEY="dw_live_sua_chave_aqui"' >> ~/.zshrc
source ~/.zshrc

echo 'export DEVWORLD_API_KEY="dw_live_sua_chave_aqui"' >> ~/.bashrc
source ~/.bashrc

Teste em 1 minuto

Vale fazer esse teste antes de mexer em qualquer aplicativo: ele mostra se a sua chave está ativa. Copie o comando, troque dw_live_sua_chave_aqui pela sua chave e cole no Terminal (macOS e Linux) ou no PowerShell (Windows).

curl https://chat.devwservices.shop/v1/chat/completions \
  -H "Authorization: Bearer dw_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{"model":"devworld/claude-sonnet-5-t","max_tokens":50,"messages":[{"role":"user","content":"Diga ola em uma palavra"}]}'

Se aparecer um texto com "content": "Olá", está tudo certo: sua chave funciona e o plano está ativo. Se aparecer uma mensagem de erro, procure ela em erros comuns — cada uma tem uma causa específica.

Modelos disponíveis

Nossos modelos têm nomes próprios e você usa o identificador exato da tabela. A coluna do meio é o que você digita em quase tudo — Cursor, VS Code, Codex, OpenCodex, Hermes e código. A última coluna existe porque o Claude Desktop só aceita identificadores no formato dele.

Para gerar imagens existe um modelo à parte, devworld/gpt-image-2-c, usado nos endpoints de imagem e cobrado por requisição.

Como escolher

• Cobrança por token desconta conforme o tamanho da conversa. É o melhor custo para uso do dia a dia e para agentes que leem muitos arquivos.
• Cobrança por requisição desconta um valor fixo por mensagem enviada, independente do tamanho. Costuma compensar em perguntas longas e respostas grandes.
• Na dúvida, comece por devworld/claude-sonnet-5-t: é equilibrado e funciona em todos os aplicativos deste guia.

Ver a lista atualizada da sua chave

A tabela acima mostra o catálogo completo. O que a sua chave enxerga depende do plano, e você confere assim:

curl https://chat.devwservices.shop/v1/models \
  -H "Authorization: Bearer dw_live_sua_chave_aqui"

Launcher DevWorld

O Launcher é um programa que faz o trabalho técnico por você: baixa os aplicativos, escreve os arquivos de configuração, coloca a sua chave em cada um e abre tudo pronto. Ele cuida de três coisas: um chat no navegador, o Codex e o Claude Desktop.

Antes de começar

• Sua chave dw_live_… em mãos.
• O Node.js instalado, versão 18 ou superior. Baixe a versão LTS em nodejs.org e clique em avançar até o fim. É uma vez só.
• Espaço em disco: a primeira instalação baixa cerca de 1 GB de componentes.

Passo a passo

1. Baixe o pacote

   Baixar o Launcher. O arquivo vem em .zip.

2. Extraia o zip inteiro

   Clique com o botão direito e escolha Extrair tudo. Abrir o zip e arrastar um arquivo só não funciona: o Launcher precisa da pasta completa.

   Escolha um caminho curto, como C:\DevWorld no Windows ou ~/DevWorld no macOS e Linux. Evite Área de Trabalho, Downloads, OneDrive e iCloud, que costumam mover arquivos sozinhos.

3. Abra o atalho do seu sistema

   Dentro da pasta DevWorld-Launcher, dê dois cliques em Abrir DevWorld.bat (Windows), Abrir DevWorld.command (macOS) ou Abrir-DevWorld.sh (Linux).

   No macOS, na primeira vez, clique com o botão direito no arquivo e escolha Abrir para liberar a execução. No Linux, se nada acontecer, rode chmod +x Abrir-DevWorld.sh antes.

4. Cole a sua chave

   Na primeira tela, cole a chave que começa com dw_live_ e salve. Ela fica guardada no cofre do sistema; você não digita de novo.

5. Clique em abrir o que quiser usar

   Chat abre uma tela de conversa no navegador. Codex e Claude Desktop abrem os aplicativos oficiais já apontados para a sua chave. Na primeira vez cada um demora alguns minutos, porque o Launcher baixa o que falta.

O que mais tem na tela

• Consumo: quanto do seu plano já foi usado no dia e na semana.
• Reparar: refaz a instalação da parte que falhou. É o primeiro botão a tentar quando algo não abre.
• Copiar diagnóstico: junta as informações técnicas para você mandar ao suporte sem precisar explicar nada.
• Desfazer configuração DevWorld: devolve o Codex e o Claude Desktop ao estado original, com a sua assinatura pessoal. Use antes de desinstalar.

Atualizações

Você não precisa voltar aqui para atualizar. O Launcher verifica a versão sozinho ao abrir, baixa a nova em segundo plano e avisa na tela quando ela está pronta; a troca acontece na próxima vez que você abrir. O chat e os agentes também são atualizados quando você clica para abrir.

OpenAI Codex

O Codex lê um arquivo de configuração chamado config.toml. Vamos adicionar a DevWorld como um provedor de modelos nesse arquivo. O aplicativo de computador e a versão de terminal usam o mesmo arquivo, então configurar uma vez serve para as duas.

Onde fica o arquivo

• Windows: C:\Users\SEU_USUARIO\.codex\config.toml
• macOS e Linux: ~/.codex/config.toml

Se a pasta .codex ou o arquivo não existirem, crie você mesmo — o Codex aceita normalmente. No Windows, arquivos e pastas que começam com ponto ficam escondidos: digite o caminho direto na barra de endereços do Explorador de Arquivos.

Passo a passo

1. Crie a variável com a sua chave

   O Codex não guarda a chave no arquivo: ele lê de uma variável de ambiente. Se ainda não fez isso, siga o passo da chave e crie a variável DEVWORLD_API_KEY.

2. Coloque este conteúdo no config.toml

   Se o arquivo já tiver outras configurações suas, mantenha o que existe e acrescente estas linhas no final.

model = "devworld/claude-sonnet-5-t"
model_provider = "devworld"

[model_providers.devworld]
name = "DevWorld AI"
base_url = "https://chat.devwservices.shop/v1"
env_key = "DEVWORLD_API_KEY"
wire_api = "responses"

3. Feche e abra o Codex

   O arquivo só é lido quando o aplicativo inicia. Feche completamente (no Windows, verifique também os ícones ao lado do relógio) e abra de novo.

4. Confirme que está usando a DevWorld

   Mande uma mensagem qualquer e depois olhe o seu consumo em acompanhar consumo: se o número subiu, o Codex está passando pela nossa API. A tela de escolha de modelo do Codex também deve mostrar DevWorld AI.

Trocar de modelo

Mude a linha model para qualquer identificador da coluna “uso geral” da tabela de modelos e reinicie o Codex. Exemplos: devworld/claude-opus-5-t, devworld/gpt-5.6-terra-t, devworld/grok-4.6-t.

Anthropic Claude Desktop

O Claude Desktop tem um modo oficial para usar um gateway de terceiros no lugar da assinatura da Anthropic. Ele fica escondido atrás do modo desenvolvedor, mas é uma tela de formulário comum, com botão de testar a conexão.

1. Ative o modo desenvolvedor

   No menu do aplicativo, vá em Help → Troubleshooting → Enable Developer Mode. No Windows o menu fica no ícone ☰, no canto superior esquerdo. O aplicativo reinicia sozinho e passa a exibir um menu Developer.

2. Abra a configuração de inferência de terceiros

   Vá em Developer → Configure Third-Party Inference….

3. Preencha os quatro campos

   Inference provider: Gateway
   Gateway base URL: https://chat.devwservices.shop
   Gateway API key: sua chave dw_live_…
   Gateway auth scheme: x-api-key

4. Teste e salve

   Use o botão de testar conexão da própria tela. Dando certo, salve e reinicie o Claude Desktop.

5. Escolha o modelo

   No seletor de modelos aparecem os nomes no formato do Claude Desktop, como claude-sonnet-5[1m] — são os mesmos da última coluna da tabela de modelos.

Se o seletor de modelos vier vazio

O Claude Desktop filtra a lista e só mostra o que reconhece como modelo Claude. Nossos modelos Claude aparecem normalmente. Para ver também GPT, Grok e DeepSeek dentro dele, use a seção de modelos da mesma tela de configuração e liste os identificadores manualmente, um por linha, usando os nomes da última coluna da tabela — por exemplo anthropic/gateway/devworld--gr0k-4.6-t.

Voltar para a sua assinatura

Abra a mesma tela e troque o provedor de volta para a opção padrão da Anthropic, ou desligue o modo desenvolvedor. Se você tinha usado o Launcher, o botão Desfazer configuração DevWorld faz isso para você.

VS Code

O VS Code permite usar a sua própria chave no chat, com um provedor chamado Custom Endpoint. Os modelos que você adicionar aparecem no mesmo seletor do chat, e você usa o chat e o modo agente normalmente.

1. Abra o editor de modelos

   No chat do VS Code, clique no seletor de modelos e escolha Manage Language Models (ícone de engrenagem). Se preferir, use Ctrl+Shift+P (ou Cmd+Shift+P) e rode o comando Chat: Manage Language Models.

2. Adicione o provedor

   Clique em Add Models e escolha Custom Endpoint na lista. Dê o nome do grupo — sugerimos DevWorld AI — e cole a sua chave quando ele pedir.

3. Escolha o tipo de API

   Selecione Chat Completions. É o formato que funciona com todos os nossos modelos.

4. Descreva os modelos

   O VS Code abre um arquivo chatLanguageModels.json. Substitua o conteúdo pelo exemplo abaixo e salve. Mantenha o valor de apiKey que o assistente gerou: ele aponta para a chave guardada em segurança pelo sistema, e trocar por uma chave escrita à mão deixa ela exposta no arquivo.

[
  {
    "name": "DevWorld AI",
    "vendor": "customendpoint",
    "apiKey": "MANTENHA_O_VALOR_QUE_O_VSCODE_GEROU",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "devworld/claude-sonnet-5-t",
        "name": "Claude Sonnet 5 (DevWorld)",
        "url": "https://chat.devwservices.shop/v1/chat/completions",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 936000,
        "maxOutputTokens": 64000
      },
      {
        "id": "devworld/claude-opus-5-t",
        "name": "Claude Opus 5 (DevWorld)",
        "url": "https://chat.devwservices.shop/v1/chat/completions",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 936000,
        "maxOutputTokens": 64000
      },
      {
        "id": "devworld/gpt-5.6-terra-t",
        "name": "GPT 5.6 Terra (DevWorld)",
        "url": "https://chat.devwservices.shop/v1/chat/completions",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 200000,
        "maxOutputTokens": 32000
      }
    ]
  }
]

5. Selecione o modelo no chat

   Abra o seletor de modelos do chat e escolha um dos que você acabou de cadastrar. Se ele não aparecer na hora, feche e abra o VS Code.

Alternativa: extensão Cline

Se o seu VS Code é mais antigo e não tem o Custom Endpoint, a extensão Cline resolve. Instale pela loja de extensões, abra o painel dela, clique na engrenagem e preencha:

• Provedor: OpenAI Compatible
• Base URL: https://chat.devwservices.shop/v1
• API Key: sua chave dw_live_…
• Model ID: devworld/claude-sonnet-5-t

Cursor

O Cursor deixa você trocar o endereço para onde ele envia as mensagens. Você coloca a chave DevWorld no campo da OpenAI e o nosso endereço no campo de base URL — apesar do nome dos campos, é assim que o Cursor trabalha com qualquer provedor.

1. Abra as configurações de modelos

   Pressione Ctrl+Shift+J (Windows e Linux) ou Cmd+Shift+J (macOS) e vá até a seção Models.

2. Coloque a chave

   No campo OpenAI API Key, cole a sua chave dw_live_… e ative a opção ao lado.

3. Troque o endereço

   Ative Override OpenAI Base URL e coloque https://chat.devwservices.shop/v1. Não acrescente nada depois do /v1: o Cursor completa o resto do caminho.

4. Cadastre os modelos

   Ainda em Models, clique em + Add Model e digite o identificador exato, por exemplo devworld/claude-sonnet-5-t. Repita para cada modelo que quiser ver no seletor. Nomes aproximados não funcionam: precisa ser igual à tabela.

5. Verifique

   Clique em Verify. Dando certo, escolha o modelo no seletor do chat e mande uma mensagem.

Hermes Agent

O Hermes Agent aceita qualquer endereço compatível com a OpenAI. Tem o jeito guiado, por pergunta e resposta, e o jeito manual, editando um arquivo.

Jeito guiado

No terminal, rode:

hermes model

Escolha a opção Custom endpoint e responda as três perguntas: endereço https://chat.devwservices.shop/v1, a sua chave dw_live_… e o modelo devworld/claude-sonnet-5-t. O Hermes salva sozinho.

Jeito manual

Edite ~/.hermes/config.yaml e deixe a seção model assim:

model:
  default: devworld/claude-sonnet-5-t
  provider: custom
  base_url: https://chat.devwservices.shop/v1
  api_key: dw_live_sua_chave_aqui

Para trocar de modelo depois, use o comando /model dentro do Hermes ou mude a linha default.

OpenCodex

O OpenCodex é um intermediário que roda na sua máquina: ele recebe os pedidos do Codex e do Claude Code e repassa para o provedor que você escolher. É o mesmo componente que o nosso Launcher usa por baixo. Vale a pena se você quer misturar a DevWorld com outros provedores ou controlar quais modelos aparecem.

1. Instale

   No terminal:

npm install -g @bitkyc08/opencodex

2. Deixe a chave em uma variável

   Siga o passo da chave e crie DEVWORLD_API_KEY. Assim ela não fica escrita no arquivo de configuração.

3. Rode o assistente

   Use ocx init e responda: provedor custom, endereço https://chat.devwservices.shop/v1, chave ${DEVWORLD_API_KEY}, modelo devworld/claude-sonnet-5-t, porta 10100. Aceite injetar a configuração no Codex quando ele perguntar.

4. Ou escreva o arquivo você mesmo

   O arquivo fica em ~/.opencodex/config.json (no Windows, C:\Users\SEU_USUARIO\.opencodex\config.json). Este é o conteúdo equivalente ao que o nosso Launcher escreve:

{
  "port": 10100,
  "hostname": "127.0.0.1",
  "defaultProvider": "devworld",
  "providers": {
    "devworld": {
      "adapter": "openai-chat",
      "baseUrl": "https://chat.devwservices.shop/v1",
      "apiKey": "${DEVWORLD_API_KEY}",
      "authMode": "key",
      "selectedModels": [
        "devworld/claude-sonnet-5-t",
        "devworld/claude-opus-5-t",
        "devworld/gpt-5.6-terra-t"
      ]
    }
  }
}

A lista selectedModels é opcional e serve para deixar o seletor de modelos limpo: só o que estiver nela aparece. Sem ela, todos os modelos do seu plano são exibidos.

5. Ligue o proxy

   Rode ocx start. O painel web fica em http://localhost:10100, onde você confere provedores e modelos. Use ocx status ou ocx doctor se algo parecer errado.

6. Para voltar atrás

   ocx restore devolve o Codex à configuração original e ocx codex-shim uninstall remove o atalho de inicialização automática.

Usar a API no seu código

Não existe SDK próprio: você usa os SDKs oficiais da OpenAI ou da Anthropic e troca a URL base. Tudo o que você já escreveu continua valendo.

Endereços e autenticação

Python, com o SDK da OpenAI

from openai import OpenAI

client = OpenAI(
    api_key="dw_live_sua_chave_aqui",
    base_url="https://chat.devwservices.shop/v1",
)

resposta = client.chat.completions.create(
    model="devworld/claude-sonnet-5-t",
    messages=[{"role": "user", "content": "Escreva um haicai sobre café"}],
    max_tokens=200,
)

print(resposta.choices[0].message.content)

Node.js, com o SDK da OpenAI

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.DEVWORLD_API_KEY,
  baseURL: 'https://chat.devwservices.shop/v1',
});

const resposta = await client.chat.completions.create({
  model: 'devworld/claude-sonnet-5-t',
  messages: [{ role: 'user', content: 'Escreva um haicai sobre café' }],
  max_tokens: 200,
});

console.log(resposta.choices[0].message.content);

Python, com o SDK da Anthropic

from anthropic import Anthropic

client = Anthropic(
    api_key="dw_live_sua_chave_aqui",
    base_url="https://chat.devwservices.shop",
)

mensagem = client.messages.create(
    model="claude-sonnet-5[1m]",
    max_tokens=200,
    messages=[{"role": "user", "content": "Escreva um haicai sobre café"}],
)

print(mensagem.content[0].text)

Respostas em tempo real

Streaming funciona como você já conhece: basta pedir. No SDK da OpenAI, use stream=True; no da Anthropic, client.messages.stream(...).

Detalhes que evitam surpresa

• Cada resposta traz o cabeçalho x-devworld-request-id. Guarde ele nos seus registros: é o que o suporte pede para investigar um caso específico.
• O endpoint /v1/responses é sem estado: mande a conversa inteira em input a cada chamada. Reaproveitar uma resposta anterior por previous_response_id não é suportado.
• Quando o limite for atingido, a resposta vem com 429 e o cabeçalho Retry-After, em segundos. Respeitar esse tempo evita bloqueios em sequência.
• O parâmetro n precisa ser 1: pedimos uma resposta por chamada.

Erros comuns e soluções

Procure aqui pelo trecho da mensagem que apareceu na sua tela. As mensagens da nossa API vêm em inglês, porque é o padrão que os aplicativos entendem.

Mensagens da API

Problemas por aplicativo

Acompanhar consumo

Quem usa o Launcher vê o consumo na tela inicial, em porcentagem do dia e da semana. Pelo terminal, o mesmo dado sai assim:

curl https://chat.devwservices.shop/v1/me \
  -H "Authorization: Bearer dw_live_sua_chave_aqui"

A resposta traz o seu plano, a validade da chave e o quanto do período já foi usado. É a forma mais rápida de confirmar que um aplicativo recém-configurado está mesmo passando pela DevWorld: mande uma mensagem nele e veja o número mudar.

Falar com o suporte

Se algo não se resolveu com este guia, chame a gente. Para uma resposta rápida, mande junto: qual aplicativo você está configurando, qual modelo escolheu, a mensagem de erro inteira e, se tiver, o x-devworld-request-id da resposta. Quem usa o Launcher pode clicar em Copiar diagnóstico e colar na conversa — já vem tudo.