Conecte a DevHub ao seu fluxo.

As três informações da conexão

1. Entre no console e abra Chaves de API. Crie uma chave com inference e models:read.
2. Copie e guarde a chave completa. Novas chaves podem ser consultadas em “Ver chave”; chaves antigas armazenadas apenas como hash não são recuperáveis.
3. Abra DevHub Chat. Escolha Automático ou um modelo e faça uma chamada curta.
4. Confira a resposta, o consumo e seu saldo antes de configurar uma ferramenta que executa muitas chamadas.

O modelo devhub-echo, quando habilitado, serve para testar a integração e retorna texto simulado. Para usar IA real, escolha um modelo de um provedor configurado no catálogo.

Cline

1. Abra a extensão Cline no VS Code e clique nas configurações.
2. Em API Provider, selecione OpenAI Compatible.
3. Informe a Base URL terminada em /v1 e sua chave dh_....
4. Preencha Model ID com o ID do catálogo DevHub.
5. Se a extensão pedir janela de contexto e limite de saída, use valores suportados pelo modelo. Comece com uma tarefa pequena e confirme o consumo.

Ative recursos como imagens ou ferramentas somente para modelos que os suportem. Fluxos de agente dependem também do comportamento do modelo e da versão da extensão.

Referência: configuração oficial do Cline.

Continue

Na configuração YAML do Continue, adicione um modelo com provider: openai e sua URL em apiBase. O gateway expõe Chat Completions; configure useResponsesApi: false quando necessário.

name: DevHub AI
version: 1.0.0
schema: v1
models:
  - name: Meu modelo DevHub
    provider: openai
    model: ID_DO_MODELO
    apiBase: https://api.devhubbrasil.com/v1
    apiKey: dh_SUA_CHAVE
    useResponsesApi: false

Guarde essa configuração em um arquivo local privado ou use o mecanismo de segredos da sua versão do Continue. Não envie a chave para um repositório.

Referência: provedores OpenAI compatíveis no Continue.

Cursor

1. Em Settings → Models, procure as opções de chaves de API próprias.
2. Se sua versão oferecer Override OpenAI Base URL, habilite e informe https://api.devhubbrasil.com/v1.
3. Configure a chave DevHub na conexão OpenAI e habilite seu uso.
4. Selecione ou adicione um Model ID que corresponda exatamente ao catálogo do gateway.
5. Teste um chat curto e confira se a requisição apareceu no histórico DevHub.

A disponibilidade de Base URL personalizada e os recursos que usam a chave dependem da versão e do plano do Cursor. Recursos próprios, modelos vinculados a outros protocolos e Tab Completion podem usar infraestrutura do Cursor. A conexão não substitui a assinatura da ferramenta nem garante suporte a todos os modelos ou recursos.

Referência: documentação oficial do Cursor. Consulte as opções de modelos e API Keys da versão instalada.

Claude Code

Claude Code usa o protocolo Anthropic. A DevHub expõe /v1/messages; configure a URL raiz, pois o cliente acrescenta /v1/messages. Não acrescente /v1 à variável abaixo.

PowerShell:

$env:ANTHROPIC_BASE_URL="https://api.devhubbrasil.com"
$env:ANTHROPIC_AUTH_TOKEN="dh_SUA_CHAVE"
$env:ANTHROPIC_MODEL="ID_DO_MODELO"
claude

macOS / Linux:

export ANTHROPIC_BASE_URL="https://api.devhubbrasil.com"
export ANTHROPIC_AUTH_TOKEN="dh_SUA_CHAVE"
export ANTHROPIC_MODEL="ID_DO_MODELO"
claude

A compatibilidade Anthropic desta instalação é experimental: inclui texto, streaming e tradução de ferramentas (tool use / tool result) para modelos que as suportem. O endpoint de contagem de tokens retorna uma estimativa local. Thinking, ferramentas nativas de servidor, documentos/PDFs e cache de prompt avançado não estão implementados. A configuração acima não equivale a uma certificação de funcionamento integral do agente. A Anthropic não oferece suporte ao uso do Claude Code com modelos não Claude.

Use uma chave específica para esse cliente e faça um teste completo de leitura, edição e execução em um projeto descartável antes de adotar em trabalho real.

Referência: guia oficial de gateways do Claude Code.

Usar a API DevHub no Mac

Este tutorial configura o Claude Code CLI no macOS para enviar as chamadas à DevHub. Não existe instalador macOS do Gateway DevHub nesta página; a conexão é feita pelo terminal.

1. Entre no console DevHub, crie uma chave de API com permissão de inferência e guarde-a em local privado. Não a envie por mensagem ou captura de tela.
2. Abra o app Terminal. Instale o Claude Code usando o instalador oficial da Anthropic e confirme a instalação:

curl -fsSL https://claude.ai/install.sh | bash
claude --version

Para testar primeiro nesta janela do Terminal, configure a URL raiz (sem /v1) e a chave. Depois inicie o Claude Code:

export ANTHROPIC_BASE_URL="https://api.devhubbrasil.com"
export ANTHROPIC_AUTH_TOKEN="dh_SUA_CHAVE"
claude

Dentro do Claude Code, rode /status e confirme que a URL base mostra https://api.devhubbrasil.com. Escolha um Model ID que apareça no catálogo DevHub e teste uma pergunta curta. As variáveis acima valem para essa janela do Terminal.

Para manter a conexão em novas janelas, crie a pasta e abra o arquivo pessoal de configurações:

mkdir -p ~/.claude
nano ~/.claude/settings.json

Coloque este conteúdo no arquivo, substituindo dh_SUA_CHAVE pela sua chave privada:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.devhubbrasil.com",
    "ANTHROPIC_AUTH_TOKEN": "dh_SUA_CHAVE"
  }
}

Salve e feche o editor, depois proteja a chave: chmod 600 ~/.claude/settings.json. Evite salvar a chave em arquivos do projeto ou repositórios. Se usar a extensão do VS Code, configure também as variáveis nas configurações de ambiente da extensão; ela pode não herdar valores do Terminal.

A integração Anthropic com o Claude Code é experimental. Texto, streaming e algumas ferramentas podem funcionar; recursos dependentes de extensões próprias do protocolo podem não estar disponíveis. O uso de modelos que não sejam Claude não é suportado pela Anthropic. Se algo falhar, confira /status, a chave/permissão no console e o ID exato do modelo.

Referências: instalação oficial do Claude Code · conexão oficial com um gateway.

Instalar e abrir o Gateway no Linux

O Gateway DevHub 1.0.4 é distribuído para Linux amd64/x86-64. Em Ubuntu/Debian, prefira o pacote .deb, que instala as dependências do sistema. Baixe o arquivo nesta página de downloads e abra o Terminal na pasta Downloads:

cd ~/Downloads
sudo apt update
sudo apt install ./DevHub-Brasil-Gateway-1.0.4-linux.deb

Depois, abra DevHub Brasil Gateway pelo menu de aplicativos. No primeiro uso, conecte com a chave DevHub e selecione o modelo do catálogo. A versão AppImage pode ser iniciada com:

chmod +x ~/Downloads/DevHub-Brasil-Gateway-1.0.4-linux.AppImage
~/Downloads/DevHub-Brasil-Gateway-1.0.4-linux.AppImage

Se o sistema disser “dependência não satisfeita”, atualize a lista com sudo apt update e repita sudo apt install ./arquivo.deb; não use dpkg -i sozinho, pois ele não baixa dependências automaticamente. Se o aplicativo não abrir, envie ao suporte a distribuição/versão do Linux e a mensagem completa do Terminal. O pacote é para sistemas x86-64, não ARM.

SDK OpenAI e HTTP

Use Chat Completions com a Base URL DevHub. Mantenha a chave no servidor ou em variáveis de ambiente de uma aplicação local.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEVHUB_API_KEY"],
    base_url="https://api.devhubbrasil.com/v1",
)
response = client.chat.completions.create(
    model="ID_DO_MODELO",
    messages=[{"role": "user", "content": "Olá"}],
    max_tokens=512,
)
print(response.choices[0].message.content)

Streaming:

stream = client.chat.completions.create(
    model="ID_DO_MODELO",
    messages=[{"role": "user", "content": "Olá"}],
    max_tokens=512,
    stream=True,
    stream_options={"include_usage": True},
)
for chunk in stream:
    if chunk.choices:
        print(chunk.choices[0].delta.content or "", end="")

cURL (macOS/Linux; troque curl por curl.exe no Windows e adapte a continuação de linhas ao seu terminal):

curl https://api.devhubbrasil.com/v1/models \
  -H "Authorization: Bearer $DEVHUB_API_KEY"

curl https://api.devhubbrasil.com/v1/chat/completions \
  -H "Authorization: Bearer $DEVHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"ID_DO_MODELO","messages":[{"role":"user","content":"Olá"}],"max_tokens":512,"stream":true}'

PowerShell, sem depender do escape de aspas do cURL:

$body = @{
  model = "ID_DO_MODELO"
  messages = @(@{ role = "user"; content = "Olá" })
  max_tokens = 512
} | ConvertTo-Json -Depth 10

Invoke-RestMethod -Method Post `
  -Uri "https://api.devhubbrasil.com/v1/chat/completions" `
  -Headers @{ Authorization = "Bearer $env:DEVHUB_API_KEY" } `
  -ContentType "application/json" -Body $body

O contrato desta versão inclui GET /v1/models e POST /v1/chat/completions. Não configure clientes que exigem /v1/responses, embeddings, imagens ou áudio sem uma implementação específica desses endpoints. Ferramentas e formatos de saída dependem do modelo e do adaptador configurado.

Passes, limites e respostas de erro

O passe ativo dá acesso ilimitado à API durante o período contratado: não há cobrança por chamada ou token nem quota fixa por conta. O gateway mede o uso para segurança e operação. Continuam valendo os limites técnicos de taxa/contexto, disponibilidade e políticas de uso justo dos provedores.

Guarde o X-Request-ID retornado para localizar a chamada no histórico. Interromper streaming pode gerar consumo pelos tokens já processados. Um modelo simulado não valida os recursos de um provedor real.

Boas práticas para suas chaves

• Use uma chave por projeto ou ferramenta e conceda só as permissões necessárias.
• Não coloque chaves em sites públicos, capturas de tela, logs ou repositórios.
• Rotacione uma chave exposta e atualize sua configuração. A chave antiga deixa de funcionar imediatamente.
• Use HTTPS no ambiente publicado e consulte o histórico quando houver dúvidas sobre consumo.

Passes via PIX

Use Passes e PIX no console. Confira valor e recebedor no seu banco antes de pagar. Um pedido pendente pode ser retomado no histórico sem gerar uma nova cobrança. O passe começa somente após confirmação; se o pedido estiver em revisão, aguarde a verificação antes de fazer outro pagamento.

API OpenAI-compatible e Gateway Anthropic

Use uma chave de API DevHub com permissão de inferência. O passe precisa estar ativo. Envie a chave no header indicado abaixo; não exponha chaves no código de páginas públicas.

API ilimitada durante o passe ativo: sem cobrança ao cliente por requisição ou token e sem quota fixa por conta (RPM/TPM ou limites diários do DevHub). Passe ativo e chave válida continuam obrigatórios. Contexto e saída máxima por chamada, limites de taxa, disponibilidade e políticas de uso justo do provedor continuam aplicáveis.

Chat Completions

curl https://api.devhubbrasil.com/v1/chat/completions \
  -H "Authorization: Bearer dh_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"Olá!"}],"max_tokens":512,"stream":false}'

A resposta segue o formato choices[0].message.content. Com stream: true, leia os eventos SSE data: até [DONE].

Anthropic Messages

curl https://api.devhubbrasil.com/v1/messages \
  -H "x-api-key: dh_SUA_CHAVE" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":512,"messages":[{"role":"user","content":"Olá!"}]}'

Erros e limites

401: confira a chave. 403: confira permissões e acesso. 429: limite técnico, aguarde a janela indicada. 502/503: falha ou indisponibilidade temporária do upstream. Consulte as seções de integração e erros para detalhes.

Esta é a referência pública de integração. O Swagger interno não é exposto em produção. Todas as chamadas e limites continuam nas rotas existentes.