UTILITÁRIO DE CONFIGURAÇÃO DE CLIENTES E SDK

Gerador de configuração de API para Claude Code, Codex e Cursor

Escolha seu agente de codificação IA ou SDK backend, selecione um ID ativo do catálogo e copie a configuração verificada junto com um teste rápido de conexão.

ExecuçãoSem login · 100% local no navegadorTemplates de protocolo conferidos em 11 de novembro de 2026

Cliente ou SDK de destinoID do modelo no catálogoNome da variável de ambienteModo streaming

1. Configuration file or SDK snippet

request.example

// ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://app.llmfly.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_CLAUDE_GROUP_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-5-5"
  }
}

2. Minimal connectivity smoke test

request.example

claude -p "Reply with OK." --model claude-sonnet-5-5

Referência técnica e checagens de deploy

Diferenças de protocolo entre Claude Code, Codex CLI e Cursor

As ferramentas de desenvolvimento não usam o mesmo protocolo mesmo conectadas ao mesmo domínio de gateway. O Claude Code usa o protocolo nativo Messages da Anthropic e exige ANTHROPIC_BASE_URL em https://app.llmfly.ai sem o sufixo /v1, pareado com uma chave do grupo Claude Code.

Por outro lado, o Codex CLI e os novos modelos de raciocínio da OpenAI (como gpt-6-astra, gpt-6.1-sol, gpt-6-sol e gpt-6.1-terra) usam a API /v1/responses da OpenAI para preservar resumos, patches e chamadas em múltiplos turnos. O Cursor e bibliotecas padrão de chat conectam-se a https://app.llmfly.ai/v1 usando /v1/chat/completions.

Cliente / SDK	URL base	Protocolo	Local do arquivo
Claude Code	https://app.llmfly.ai	API Messages da Anthropic	~/.claude/settings.json
Codex CLI	https://app.llmfly.ai/v1	API Responses da OpenAI (responses)	~/.codex/config.toml
Cursor IDE	https://app.llmfly.ai/v1	Chat Completions da OpenAI	Configurações do Cursor -> Models
SDK Python / TS da OpenAI	https://app.llmfly.ai/v1	Responses ou Chat Completions	Variáveis de ambiente do servidor

Como evitar erros 401, 403 e 404 na configuração inicial

Três erros causam mais de 90% das falhas iniciais: duplicar /v1 (gerando 404 em /v1/v1/chat/completions), digitar o nome de exibição "GPT-6 Astra" em vez do ID exato em minúsculas gpt-6-astra, ou usar uma chave de outro grupo de modelos.

Mantenha credenciais oficiais e chaves da LLMFly AI em perfis de shell ou pastas separadas para que sessões CLI nunca cobrem da conta errada.
Execute o teste rápido sem streaming do passo 2 antes de ativar servidores MCP, indexação de repositório ou subagentes em segundo plano.
Emita chaves de API distintas por máquina de desenvolvedor, runner de CI e ambiente de staging para revogá-las individualmente.

Dúvidas frequentes

Por que o Claude Code omite /v1 em ANTHROPIC_BASE_URL?

O Claude Code adiciona /v1/messages internamente conforme a convenção do SDK da Anthropic. Incluir /v1 em ANTHROPIC_BASE_URL gera /v1/v1/messages e falha com HTTP 404.

Quando usar client.responses.create em vez de chat.completions.create em Python ou TypeScript?

Use client.responses.create para GPT-6 Astra, GPT-6.1 Sol, GPT-6 Sol e GPT-6.1 Terra — especialmente ao combinar esforço de raciocínio com chamadas de função ou ferramentas Responses.

Posso usar qualquer chave de API tanto no Claude Code quanto em modelos GPT?

Verifique o grupo atribuído à sua chave no console da LLMFly AI. As rotas do Claude Code e as rotas Codex/GPT da OpenAI pertencem a grupos de cobrança específicos no Model Plaza.

Crie uma chave dedicada para seu ambiente de código

Gere uma chave de API com escopo no console e valide sua primeira chamada CLI ou SDK em menos de um minuto.

Criar chave de API