Claude Code e Codex conectados à HiAPI: uma única Key para escolher o modelo conforme a tarefa

Nestes dias, uma frase de Karpathy do início do ano voltou a viralizar: the new default is that you are not writing the code directly 99% of the time, you are orchestrating agents who do and acting as oversight. Em tradução: o novo padrão é que em 99% do tempo você não escreve mais código pessoalmente, mas orquestra agentes que trabalham por você e atua apenas como supervisor. A frase vem de seu post quando propôs o conceito de agentic engineering, e ele ainda acrescentou no podcast No Priors: I don't think I've typed a line of code probably since December.

Viralização à parte, os dados mostram melhor que não se trata de um slogan. A receita anualizada de operação do Claude Code já ultrapassou US$ 2,5 bi (critério anunciado na Series G de fevereiro de 2026, ARR não auditado), enquanto o GitHub Copilot levou cerca de 3 anos para chegar a US$ 1 bi. Na pesquisa de ecossistema de desenvolvedores do JetBrains de 2026 (mais de 15 mil respondentes), cerca de 90% dos desenvolvedores profissionais usam agentes de programação com IA toda semana; a adoção do Claude Code em cenários de trabalho subiu de 18% para 39% (47% nos EUA), e a do Codex de 3% para 16%.

Os problemas também vieram: há mais agentes, mas configuração e fatura continuam separadas. Muitas pessoas usam Claude Code e Codex ao mesmo tempo, mas cada ferramenta solicita sua própria key, faz sua própria recarga e consulta seu próprio uso; para trocar de modelo é preciso refazer todo o processo de solicitação. Este artigo explica como conectar as duas ferramentas com uma única Key da HiAPI e, depois de conectadas, como escolher e trocar de modelo.

Conclusão primeiro

• Uma Key gerencia as duas ferramentas: a API Key da HiAPI serve ao mesmo tempo para Claude Code e Codex; saldo, uso e fatura ficam em um único painel
• Cada um usa seu modelo mais forte: o Claude Code usa o protocolo Anthropic Messages (/v1/messages) com os modelos Claude da HiAPI; o Codex usa a Responses API (/v1/responses) com modelos da família GPT-6.1
• Liberdade dentro de duas linhas vermelhas: o Claude Code oficialmente não suporta roteamento via qualquer gateway para modelos não-Claude, então a postura correta é cada ferramenta acessar sua própria família de modelos, e não uma ferramenta servir para tudo
• Conexão em 5 minutos no máximo: abra a página /connect/agents, escolha ferramenta + modelo + sistema e copie a configuração gerada; Claude Code e Codex suportam importação com um clique via CC Switch
• Trocar de modelo altera um único ponto: no Claude Code altere o campo de modelo em settings.json; no Codex altere uma linha model em hiapi.config.toml; a Key não muda

A solução da HiAPI: uma Key, duas ferramentas

A HiAPI é uma plataforma de API que agrega várias famílias de modelos e expõe externamente alguns protocolos padrão de forma unificada. Para agentes de programação, a equipe oficial criou uma página de conexão com um clique para 4 ferramentas: /zh/connect/agents (versão em inglês /en/connect/agents), com suporte a Claude Code, Codex CLI, OpenCode e Hermes Agent.

O mapeamento de protocolos é a chave para conectar corretamente:

Ferramenta	Protocolo	Caminho da interface	Modelos disponíveis no lado HiAPI
Claude Code	Anthropic Messages	/v1/messages	claude-opus-5-5, claude-sonnet-4-6, claude-opus-4-8, claude-opus-4-8@aws (4 no total)
Codex CLI	Responses API	/v1/responses	gpt-6.1-sol, gpt-6.1-terra, gpt-6-astra, família gpt-5.6, família deepseek-v4 (9 no total)
OpenCode / Hermes Agent	Chat Completions	/v1/chat/completions	Modelos de texto de cada família, a maior cobertura

Ou seja, o ponto forte do Claude Code está em tarefas longas de agentes de programação, e ele usa o carro-chefe da família Claude; o ponto forte do Codex está em volume, e ele usa a família GPT-6.1. Uma Key autentica os dois lados e consolida a fatura.

Uma frase que precisa ficar clara: a Anthropic oficialmente não suporta rotear o Claude Code por qualquer gateway para modelos não-Claude. Forçar modelos GPT dentro do Claude Code deixa a chamada de ferramentas e o comportamento do agente instáveis, e não há garantia oficial em caso de problema. Portanto, "uma Key para trocar de modelo a qualquer momento" significa com precisão: distribuir entre as duas ferramentas conforme a tarefa, cada ferramenta usando o modelo mais forte para si, e não misturar famílias dentro de uma ferramenta.

Se você usa apenas o Claude Code, consulte nosso guia anterior de configuração de ferramenta única "Conecte o Claude Code à HiAPI: guia completo de configuração para economizar US$ 100 por mês em assinatura". Este artigo foca no uso de uma Key compartilhada pelas duas ferramentas e na estratégia de troca.

Forma de conexão 1 (recomendada): gerar a configuração na página /connect/agents

A forma mais simples, todo o processo por seleção, sem escrever nenhuma configuração manualmente:

1. Abra hiapi.ai/zh/connect/agents e clique em "Conectar a HiAPI ao seu Agent"
2. Escolha a ferramenta: Claude Code ou Codex CLI
3. Escolha o modelo: por exemplo, no lado Claude Code escolha claude-opus-5-5; no lado Codex escolha gpt-6.1-sol
4. Escolha o sistema operacional: macOS / Windows / Linux; os caminhos na configuração mudam conforme a escolha
5. Copie a configuração gerada e cole no arquivo correspondente conforme as instruções

Claude Code e Codex suportam importação com um clique via CC Switch: na página de API Keys da HiAPI, clique em importar; o navegador abrirá o CC Switch para concluir a escrita da configuração. O link de importação em si não carrega sua chave; a Key fica em variável de ambiente local, o que traz tranquilidade.

Verifique antes os requisitos de versão: o Codex CLI precisa de 0.134 ou superior, confira com codex --version; no Claude Code, confirme com claude --version que a versão é exibida normalmente.

Forma de conexão 2: escrever manualmente os arquivos de configuração

A configuração manual também não é complexa: dois arquivos, um para cada ferramenta.

Claude Code: ~/.claude/settings.json

Em ~/.claude/settings.json (no Windows, %USERPROFILE%\.claude\settings.json), escreva dentro do bloco env:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.hiapi.ai",
    "ANTHROPIC_AUTH_TOKEN": "sua HiAPI API Key",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Explicação campo a campo:

• ANTHROPIC_BASE_URL aponta para https://api.hiapi.ai, sem /v1; o cliente monta /v1/messages sozinho
• ANTHROPIC_AUTH_TOKEN recebe sua HiAPI API Key, com autenticação Bearer
• ANTHROPIC_MODEL e os dois aliases OPUS / SONNET apontam para o modelo escolhido na HiAPI (a HiAPI não serve os IDs oficiais de modelo Claude; os aliases apontam todos para lá)
• ANTHROPIC_DEFAULT_HAIKU_MODEL fica fixo em claude-sonnet-4-6; é o slot usado pelo Claude Code para tarefas de fundo (compactar contexto, gerar mensagens de commit e similares)
• CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 porque o novo pipeline de texto rejeita campos de requisição experimental beta; desligar evita problemas

Codex: ~/.codex/hiapi.config.toml

Crie ~/.codex/hiapi.config.toml (no Windows, %USERPROFILE%\.codex\hiapi.config.toml):

model_provider = "hiapi"
model = "gpt-6.1-sol"

[model_providers.hiapi]
name = "HiAPI"
base_url = "https://api.hiapi.ai/v1"
env_key = "HIAPI_API_KEY"
wire_api = "responses"

Depois, defina a variável de ambiente no shell e inicie:

export HIAPI_API_KEY="sua HiAPI API Key"
codex --profile hiapi

No Windows PowerShell, o correspondente é $env:HIAPI_API_KEY = "...". Note que aqui o base_url inclui /v1, diferente do lado Claude Code; não copie e misture os dois.wire_api = "responses" declara o uso do protocolo Responses, exigência obrigatória do Codex.

Como escolher o modelo: Opus para tarefas complexas, GPT-6.1 para volume

Com as duas ferramentas conectadas, a escolha do modelo passa a ser uma questão de roteamento por tarefa. Nossa recomendação é direta:

• Tarefas difíceis e longas com claude-opus-5-5: refatoração entre arquivos, depuração de maratona, tarefas que exigem entender todo o repositório. É o carro-chefe do lado Claude Code, com janela de contexto de até 1M
• Volume diário de alta frequência com gpt-6.1-sol / gpt-6.1-terra: reescritas em lote, funcionalidades em arquivo único, geração de scripts; tarefas em grande quantidade e pouco complexas individualmente, usando um modelo mais barato, com diferença visível na fatura
• gpt-6-astra fica para cenários Responses mais sensíveis à qualidade: preço um nível acima, ative conforme a necessidade

Preços de plataforma dos principais modelos (US$/M token, vigentes em 2026-10, nível básico):

Modelo	Entrada	Saída	Leitura de cache	Contexto
claude-opus-5-5	$2.02	$10.08	$0.10	1M
claude-sonnet-4-6	$3.00	$15.00	$0.30	—
gpt-6.1-sol	$0.50	$2.50	$0.025	1.05M
gpt-6.1-terra	$0.25	$1.25	$0.0125	1.05M
gpt-6-astra	$2.50	$12.50	$0.25	1.05M (acima de 272K aciona faixa de preço maior para texto longo)

Observe a coluna de preço de leitura de cache: em sessões de agente, muitos tokens vêm de acertos de cache; a leitura de cache do gpt-6.1-terra custa apenas $0.0125/M, e em sessões longas alterando repetidamente o mesmo repositório a fatura real fica bem abaixo da estimada pelo preço de entrada. Volume e economia não são uma escolha excludente.

Para se aprofundar na comparação de orientação entre Opus 5.5 e GPT-6.1 Sol, veja "Claude Opus 5.5 comparado ao GPT-6.1 Sol"; sobre a magnitude e o contexto do recente corte de preço do Terra, há uma análise completa em "Análise do corte de preço do GPT-6.1 Terra". Os preços e parâmetros em tempo real dos dois modelos prevalecem na página de detalhes do modelo.

Como é fácil trocar de modelo

Este é o benefício mais subestimado desta solução. Trocar de modelo exige apenas duas ações:

• Claude Code: altere os valores de ANTHROPIC_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL em ~/.claude/settings.json (na HiAPI os aliases opus/sonnet apontam para lá; basta alterar para o mesmo novo ID de modelo) e reabra a sessão para aplicar
• Codex: altere a linha model = "..." em ~/.codex/hiapi.config.toml; aplica no próximo codex --profile hiapi

A Key não precisa ser alterada do início ao fim. Comparado ao caminho antigo de "solicitar uma key oficial separada para cada ferramenta": trocar de modelo exigia nova solicitação, espera por aprovação e mudança na gestão de chaves; agora é uma linha de configuração. Se você usou a importação via CC Switch, também pode selecionar novamente o modelo na página /connect/agents e clicar em importar outra vez, tudo por operação gráfica.

Se quiser conectar ainda mais modelos, OpenCode e Hermes Agent usam o protocolo Chat Completions, com a maior cobertura de modelos disponíveis, no mesmo fluxo da página. Se tiver interesse em modelos novos multimodais e de world model, veja também "Teste prático do world model Genie 4".

Perguntas frequentes

O Claude Code pode usar modelos GPT através da HiAPI?

Não, e não é necessário. A Anthropic oficialmente não suporta rotear o Claude Code por qualquer gateway para modelos não-Claude; forçar a conexão deixa a chamada de ferramentas e o comportamento do agente instáveis, sem garantia oficial. Os modelos disponíveis para Claude Code na HiAPI são estes 4: claude-opus-5-5, claude-sonnet-4-6, claude-opus-4-8 e claude-opus-4-8@aws. Para usar modelos da família GPT-6.1, vá pelo lado Codex, com suporte nativo ao protocolo Responses.

Uma Key da HiAPI pode ser usada ao mesmo tempo no Claude Code e no Codex?

Sim, esse é exatamente o núcleo desta solução. As duas ferramentas compartilham a mesma Key; a forma de autenticação é diferente (Claude Code usa ANTHROPIC_AUTH_TOKEN, Codex usa a variável de ambiente HIAPI_API_KEY), mas é a mesma Key. Saldo, uso e fatura são vistos no mesmo painel, com estatísticas agrupadas por ferramenta.

A importação com um clique via CC Switch é segura?

Sim. O link de importação em si não carrega a chave; a Key fica na sua variável de ambiente local. O fluxo é: após gerar a Key na HiAPI, vá à página de API Keys e clique em importar CC Switch; o navegador abre o CC Switch para escrever a configuração. Se não se sentir seguro com o fluxo gráfico, escrever manualmente settings.json e hiapi.config.toml é totalmente equivalente.

Com as duas ferramentas configuradas, como confirmar que a conexão funcionou?

No lado Claude Code, execute claude --version para confirmar que o cliente está normal e depois abra uma sessão qualquer e envie uma frase; volte ao painel da HiAPI e veja se o uso aumentou. No lado Codex, é exigido CLI 0.134+; após iniciar com codex --profile hiapi, envie também uma tarefa e verifique a medição no painel. Na primeira vez, recomenda-se executar uma tarefa pequena em cada ferramenta para confirmar que a cobrança e o ID do modelo estão corretos, e só depois liberar o uso.

Vale a pena conectar OpenCode e Hermes Agent?

Depende dos hábitos da sua equipe. Essas duas ferramentas usam o protocolo Chat Completions, com o maior número de famílias de modelos disponíveis, adequadas a cenários que precisam abranger várias famílias em um único cliente. O fluxo de configuração é idêntico ao do Claude Code / Codex, na mesma página /connect/agents.

Trocar de modelo afeta sessões em andamento?

A alteração vale para novas sessões. Sessões já abertas usam o modelo lido na inicialização; após alterar a configuração, basta reabrir a sessão; o histórico de sessões não é afetado.

Conclusões principais

A frase dos 99% de Karpathy voltou a viralizar, mostrando que o agentic engineering já não é jogo de jogadores de ponta, mas o modo de trabalho padrão. Nesse modo de trabalho padrão, cada vez mais pessoas usarão Claude Code e Codex ao mesmo tempo, e a fragmentação de configuração e fatura é um atrito real. A solução da HiAPI é conectar as duas ferramentas com uma única Key: Claude Code usa o protocolo Messages com o carro-chefe da família Claude; Codex usa o protocolo Responses com a família GPT-6.1; cada um usa seu modelo mais forte e a fatura é consolidada. A conexão usa a geração de configuração na página /connect/agents mais a importação via CC Switch, funcionando em 5 minutos; trocar de modelo altera uma linha de configuração, sem mexer na Key. Roteamento por tarefa (tarefas difíceis com Opus 5.5, volume com GPT-6.1 Sol/Terra) é a solução ótima no momento para segurar ao mesmo tempo qualidade e fatura.