Nota do autor: Codex e WorkBuddy não são clientes criados especificamente para o Claude. Quase todos os erros acontecem na camada de integração. Neste artigo, dividimos os problemas em três categorias — endpoints, ciclos de chamadas de ferramentas e blocos de raciocínio — e mostramos a solução para cada mensagem de erro.
Nós mesmos já passamos por isso. No começo, para simplificar, usamos o protocolo compatível com OpenAI para chamar o Claude, tratando-o como um modelo da OpenAI. Conversas simples funcionavam bem, mas bastava chamar uma ferramenta para o erro aparecer. Tentar de novo não adiantava. Só conseguimos fazer tudo funcionar ao voltar para o endpoint nativo da Anthropic, /v1/messages.
Primeiro, veja se este é o seu caso: o Codex apresenta um erro relacionado a wire_api assim que inicia; o WorkBuddy conversa normalmente, mas retorna um erro 400 ao chamar uma ferramenta; ou as respostas aparecem vazias sem motivo aparente.
- O modelo não está com defeito. O problema é que há três incompatibilidades na camada de integração: endpoints, ciclos de chamadas de ferramentas e blocos de raciocínio.
- A categoria mais fácil de corrigir é a 3ª (blocos de raciocínio e limite de saída): basta alterar no cliente a forma de leitura e o valor de
max_tokens. - A 2ª categoria (ciclos de chamadas de ferramentas) tem dificuldade intermediária e costuma exigir ajustes em uma camada de tradução ou em um gateway.
- A 1ª categoria (endpoints) é a mais trabalhosa: é preciso trocar de cliente ou adicionar um gateway de tradução.
A conclusão do artigo, em ordem de preferência, é: protocolo nativo da Anthropic > gateway com tradução para Anthropic > chat compatível com OpenAI. Para começar, use a tabela abaixo para identificar a categoria do seu erro.
Três causas principais de erros ao usar Claude com Codex e WorkBuddy
Primeiro, alguns termos. Responses, Messages e Chat Completions são como três formas de fazer um pedido: o prato preparado na cozinha é o mesmo, mas o formato do cardápio muda. O Codex só faz pedidos no formato Responses, enquanto o Claude aceita apenas Messages e Chat Completions. O bloco thinking funciona como um rascunho do modelo, e a Anthropic verifica se esse rascunho foi alterado.
| Categoria | Mecanismo em uma frase | Quem deve corrigir | Dificuldade |
|---|---|---|---|
| 1. Endpoints incompatíveis | O Codex só envia Responses, e o Claude não aceita esse formato | Trocar de ferramenta ou gateway | Mais difícil |
| 2. Troca de dados com ferramentas incompatível | IDs, blocos de conteúdo ou blocos thinking são alterados durante a tradução | Principalmente o gateway | Média |
| 3. Bloco thinking e orçamento incompatíveis | O modelo pensa em todas as chamadas, mas o cliente ainda lê os resultados da forma antiga | Cliente | Mais fácil |
Categoria 1: Incompatibilidade de endpoints ao usar Claude no Codex
Como é o erro: Error loading config.toml: wire_api = "chat" is no longer supported. How to fix: set wire_api = "responses".
A mensagem significa que wire_api = "chat" não é mais compatível e precisa ser substituído por responses.
Por que acontece: segundo a referência oficial de configuração do Codex, responses é o único valor aceito para wire_api. A antiga solução alternativa de mudar wire_api para chat não funciona mais: as versões recentes do Codex exibem um erro ao carregar a configuração. Mesmo que o provedor não esteja em uso, até o comando codex login status deixa de funcionar. Por outro lado, os modelos Claude disponíveis na APIYI apiyi.com oferecem apenas os endpoints anthropic e openai, sem suporte a /v1/responses. Como os formatos não são compatíveis e não há uma camada de tradução entre eles, o erro é inevitável.
Como corrigir:
1. Cliente: abra ~/.codex/config.toml e remova qualquer configuração chat que tenha ficado no arquivo, seguindo a mensagem de erro. Assim, o Codex poderá iniciar normalmente.
2. Troque de ferramenta: se você só quer usar o Claude para programar, use o Claude Code, que utiliza o formato nativo Messages.
3. Gateway: se precisar continuar no Codex, adicione um gateway capaz de traduzir Responses para Messages. No endereço do provedor, dê preferência ao endpoint nativo da Anthropic.
Critérios de validação: codex login status deve ser executado normalmente. Ao usar o gateway, envie uma instrução que exija a leitura de um arquivo e verifique se o Codex conclui uma chamada de ferramenta.
Categoria 2: Falhas na troca de chamadas de ferramentas do Claude
Como o erro aparece:
– tool_use ids were found without tool_result blocks immediately after
– An assistant message with 'tool_calls' must be followed by tool messages...
– thinking or redacted_thinking blocks in the latest assistant message cannot be modified
– Invalid signature in thinking block. The block is bound to a different conversation.
O primeiro indica que um tool_use não foi seguido imediatamente pelo tool_result correspondente. O segundo é o mesmo tipo de problema no formato Chat. O terceiro indica que o bloco de pensamento da rodada anterior foi alterado. O quarto indica que a assinatura do bloco de pensamento não corresponde à conversa atual.
Por que acontece: a camada de compatibilidade precisa converter, bloco a bloco, os conteúdos text, tool_use, tool_result e thinking do Claude em tool_calls e role: tool e depois convertê-los de volta. Se os IDs não corresponderem, os blocos forem combinados ou um bloco thinking for deslocado, a API retornará um erro 400. A API Responses tem o papel developer, mas a Messages não, então esse conteúdo precisa ser incorporado ao system. Além disso, o claude-opus-5-5 não aceita as seguintes práticas antigas: tool_choice forçado (any ou uma ferramenta específica), preenchimento antecipado da mensagem assistant (prefill) e os parâmetros temperature / top_p / top_k.
Como corrigir:
1. Gateway: cada tool_use deve ser seguido imediatamente por um tool_result com o mesmo ID, e o tool_result deve ficar no início dos blocos de conteúdo da mensagem user.
2. Gateway: retransmita a mensagem assistant da rodada anterior sem alterações, incluindo os blocos com o campo thinking vazio; incorpore o conteúdo developer ao system.
3. Cliente: mantenha apenas auto ou none em tool_choice e remova o prefill e os parâmetros de amostragem.
4. Cliente: se o erro de assinatura já apareceu, inicie uma nova conversa. Segundo o FAQ oficial da APIYI, esse tipo de erro às vezes aparece como Request rejected (429), mas não é uma limitação de taxa, e tentar novamente com espera progressiva não resolve.
5. Troque de ferramenta: se o harness tiver um tool_choice forçado e você não puder alterá-lo, troque de cliente.
Para investigar erros 400 semelhantes, consulte Erro 400 de concorrência no uso de ferramentas do Claude Code. O artigo explica como identificar, passo a passo, falhas no pareamento de tool_use e tool_result.
Critério de aceitação: várias rodadas consecutivas de chamadas de ferramentas (ler um arquivo, alterá-lo e lê-lo novamente) não geram mais erros 400, e não há mais erros de assinatura na mesma conversa.
Categoria 3: blocos de pensamento do Claude e orçamento de saída não estão alinhados
Como o erro aparece: "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior. Também pode aparecer "thinking.type.disabled" is not supported for this model. Em outros casos, não há erro, mas a resposta vem vazia ou é truncada.
Por que acontece: o claude-opus-5-5 pensa em todas as requisições, e a resposta pode começar com um bloco thinking. Se o cliente ler content[0].text pela posição, receberá um valor vazio. Os tokens de pensamento são cobrados como saída e também consomem o limite de max_tokens. A partir desta geração, as explicações entre chamadas de ferramentas também ficam nos blocos thinking. Como o valor padrão de display é omitted, elas parecem vazias.
Como corrigir:
1. Cliente: omita o parâmetro thinking ou use thinking: {"type": "adaptive"} e remova budget_tokens.
2. Cliente: controle a profundidade do pensamento com output_config.effort. As opções são low / medium / high / xhigh / max, com medium como padrão.
3. Cliente: ao ler a resposta, procure o bloco text pelo type, não pela posição.
4. Cliente: defina um max_tokens suficiente para o pensamento e para o texto da resposta. Para ver as explicações, configure thinking.display como summarized.
Para entender melhor esse mecanismo, confira Entendendo o Adaptive Thinking: pensamento adaptativo. O artigo explica como migrar de budget_tokens para os níveis de effort.
Critério de validação: envie o mesmo comando várias vezes seguidas. O texto da resposta deve vir preenchido em todas elas, sem novos erros relacionados a thinking.type.
Tabela rápida de referência dos erros do Claude
| Trecho da mensagem de erro | Categoria | Verificação em 5 minutos | Se o erro persistir, consulte |
|---|---|---|---|
wire_api = "chat" is no longer supported |
Tipo 1 | Verifique se ainda há alguma configuração com chat no config.toml |
Tutorial do Magpie |
tool_use ids were found without tool_result |
Tipo 2 | Verifique o ID e a posição de tool_result |
Erro 400 de concorrência no uso de ferramentas do Claude Code |
must be followed by tool messages |
Tipo 2 | Confira se a chamada passa por uma camada de compatibilidade com Chat | Erro 400 de concorrência no uso de ferramentas do Claude Code |
Invalid signature in thinking block |
Tipo 2 | Inicie uma nova sessão e tente novamente | Entendendo o Adaptive Thinking |
thinking.type.enabled / resposta vazia |
Tipo 3 | Remova budget_tokens e passe a ler pelo campo type |
Entendendo o Adaptive Thinking |
| Conversas simples funcionam, mas a chamada de ferramentas gera erro | Tipo 2 | Verifique o protocolo de integração do WorkBuddy | O WorkBuddy aceita chamadas no formato nativo do Claude? |
Duas formas de corrigir erros ao usar Claude no Codex e no WorkBuddy
| Caminho | Para quem | Prioridade de protocolo |
|---|---|---|
| A Voltar ao cliente nativo | Quem só quer usar Claude para programar | Mais alta, sem perdas na tradução |
| B Adicionar um gateway de tradução | Quem precisa continuar no Codex ou no WorkBuddy | Intermediária; use o endereço Anthropic do fornecedor |
| Continuar usando chat compatível a longo prazo | Não recomendado | Mais baixa; chamadas de ferramentas e blocos de raciocínio podem apresentar problemas |
Caminho A: se você quer usar Claude no Codex, passe a usar o Claude Code. A configuração oficial de modelos do WorkBuddy só oferece /chat/completions e a opção de «protocolo personalizado», sem uma entrada nativa da Anthropic. Por isso, não conte com o thinking nativo no WorkBuddy. Saiba mais em O WorkBuddy oferece suporte a chamadas no formato nativo do Claude?. O artigo explica por que «a conversa funciona, mas as ferramentas dão erro» e como contornar o problema.
Para configurar uma conexão direta no WorkBuddy, acesse «Configurações → Modelo → Personalizado». No campo Base URL, insira https://api.apiyi.com/v1; no nome do modelo, use claude-opus-5-5; e, em Key, use a chave criada na página de tokens da APIYI apiyi.com. A URL deve terminar em /v1: não acrescente /chat/completions por conta própria.
Legenda: confira se a URL termina em /v1, se o nome do modelo é claude-opus-5-5 e se a opção «protocolo personalizado» continua desativada.
Caminho B: ao adicionar um gateway ao Codex, mantenha wire_api = "responses" na configuração do Codex. O gateway traduzirá as solicitações para Messages antes de encaminhá-las. No WorkBuddy, aponte a URL do modelo personalizado para o gateway local e, para os modelos Claude, preencha o endereço do fornecedor com o endpoint nativo da Anthropic https://api.apiyi.com.
🎯 Dica técnica: uma única chave permite testar tanto o endpoint nativo Messages quanto o endpoint chat compatível. Primeiro, use os créditos de teste da APIYI apiyi.com para comparar as chamadas de ferramentas nos dois protocolos. Depois, decida qual caminho seguir.
Como conectar Claude ao Codex e ao WorkBuddy com o Magpie
O Magpie é uma ferramenta de código aberto da comunidade, licenciada sob MIT. Ela inicia um gateway local em 127.0.0.1:3425 e converte solicitações entre OpenAI Chat, Responses e Anthropic Messages, preenchendo justamente a lacuna da primeira categoria. Além da configuração manual, você pode configurar tudo visualmente no próprio Magpie. Basta preencher a chave API e a Base URL na interface gráfica e conectar Codex e WorkBuddy ao mesmo gateway, sem editar arquivos de configuração à mão. Veja o passo a passo completo no tutorial do Magpie, que mostra como usar um único gateway para unificar as fontes de modelos de vários agentes.
- Página de fornecedores: adicione a chave. A APIYI fica no grupo «Proxy»; você também pode clicar em «+ Fornecedor personalizado» e preencher os dados manualmente.
- Página de agentes: selecione claude-opus-5-5 para Codex e WorkBuddy.
- Abra uma nova sessão, sem reutilizar o histórico da sessão anterior.
Legenda: confira se o fornecedor aparece como disponível no grupo «Proxy», se a Base URL é o endereço nativo da Anthropic e se as duas opções na página de agentes estão ativadas.
Preços de invocação do Claude e custos de cache
Os preços abaixo estão em dólares por milhão de tokens. Consultados em 28/10/2026; confira os modelos e preços na lista de modelos da plataforma:
| Modelo | Entrada | Saída | Leitura de cache | Plataforma disponível |
|---|---|---|---|---|
| claude-opus-5-5 | $4 | $20 | $0.2 | APIYI apiyi.com |
| claude-sonnet-5-5 | $2 | $10 | $0.1 | APIYI apiyi.com |
| claude-haiku-5-5 | $0.1 | $0.5 | $0.01 | APIYI apiyi.com |
O agente reenvia o histórico completo a cada rodada, e os tokens de raciocínio do claude-opus-5-5 são cobrados pelo preço de saída. Se a camada de tradução alterar a ordem de system, tools ou do prefixo, o ponto de interrupção do cache_control deixa de funcionar, aumentando tanto o custo quanto a latência. Se a taxa de acertos estiver fora do normal, consulte Taxa de acertos do cache do Claude caiu para 0 (diagnóstico). O artigo explica como identificar por que o ponto de interrupção deixou de funcionar.
Riscos e responsabilidade por bloqueio de conta
Gateways como o Magpie são ferramentas de código aberto da comunidade, não componentes oficiais da APIYI. Não endossamos essas ferramentas nem oferecemos suporte técnico para elas. Encaminhar solicitações por meio delas pode resultar em limitação de requisições ou até no bloqueio da conta pelo serviço de destino. As consequências são de responsabilidade do usuário. Recomendamos testar todo o fluxo com uma conta de teste e, só depois de confirmar que está tudo funcionando, considerar o uso com uma conta de produção.
Quando não vale a pena complicar
Se você só usa o Claude no Codex de vez em quando, se a empresa não permite instalar softwares adicionais ou se você só precisa usar o Claude, não há necessidade de configurar um gateway. É bem mais simples trocar de cliente e usar o Claude Code ou escolher, no Codex, um modelo com suporte nativo à API Responses.
Perguntas frequentes
Q1: O Codex oferece suporte oficial ao Claude?
Não. O Codex usa apenas a API Responses, e o Claude não oferece esse endpoint. Para usá-los juntos, é necessária uma camada de tradução.
Q2: O Claude na APIYI aceita requisições pelo /v1/responses?
Não. Os modelos Claude na APIYI, em apiyi.com, oferecem apenas os endpoints anthropic e openai.
Q3: O erro 429 significa que atingi o limite de requisições?
Se a mensagem de erro contiver `Invalid signature in thinking block`, não é um limite de requisições: a validação da assinatura do bloco de raciocínio falhou. Basta iniciar uma nova sessão.
Q4: O WorkBuddy aceita o protocolo nativo da Anthropic?
A configuração oficial não oferece uma opção nativa para a Anthropic. É preciso usar a rota compatível com OpenAI ou fazer a conversão por um gateway.
Q5: Como verificar rapidamente se o problema foi resolvido?
Use os créditos de teste da APIYI, em apiyi.com, para iniciar uma nova sessão. Execute várias chamadas de ferramentas em sequência e confirme que o corpo da resposta não está vazio.
Checklist para investigar erros ao usar Claude no Codex e no WorkBuddy
- A configuração do Codex não usa mais nenhuma sintaxe de chat.
- As requisições ao Claude usam o protocolo nativo ou um gateway que traduz para o formato anthropic, em vez de usar compatibilidade com chat.
- Cada
tool_useé seguido imediatamente por umtool_resultcom o mesmo ID. - O bloco
thinkingda rodada anterior é devolvido exatamente como foi recebido, sem alterações. - Não são usados
tool_choiceobrigatório, prefill ou parâmetros de amostragem. - A resposta é lida de acordo com o campo
type, emax_tokensreserva espaço para o raciocínio.
Resumo
Os erros ao usar Claude no Codex e no WorkBuddy geralmente se encaixam em três categorias: endpoints, troca de chamadas e resultados de ferramentas e blocos de raciocínio. A ordem de correção é: primeiro, ajuste a forma como o cliente lê as respostas; depois, corrija a camada de tradução; por fim, considere trocar de cliente ou adicionar um gateway.
Na escolha do protocolo, use o Anthropic nativo sempre que possível. Se não der, deixe o gateway traduzir para o formato anthropic, mas não dependa da compatibilidade com chat a longo prazo. Recomendamos usar a APIYI, em apiyi.com, para comparar os resultados de diferentes protocolos com a mesma chave API.
📚 Referências
- Referência de configuração do Codex: valores aceitos por wire_api
- Link:
developers.openai.com/codex/config-reference - Detalhes: confirma que wire_api atualmente só aceita responses
- Exemplo de erro ao carregar a configuração do Codex
- Link:
github.com/openai/codex/issues/41816 - Detalhes: fonte da mensagem de erro original de wire_api
- Guia de migração do Claude Opus 5.5
- Link:
platform.claude.com/docs/en/models/opus-5-5/migration-guide - Detalhes: restrições obrigatórias para thinking, tool_choice e parâmetros de amostragem
- Solução de problemas com chamadas de ferramentas da Anthropic
- Link:
platform.claude.com/docs/en/agents-and-tools/tool-use/troubleshooting-tool-use - Detalhes: regras de pareamento entre tool_use e tool_result
- Configuração de modelos no WorkBuddy
- Link:
www.workbuddy.ai/docs/zh/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model - Detalhes: acesso à configuração de modelos personalizados e opção para ativar protocolos personalizados
- Repositório do Magpie
- Link:
github.com/yetone/magpie - Detalhes: gateway de código aberto da comunidade; avalie os riscos antes de usá-lo
Autor: Equipe técnica da APIYI
Discussões técnicas: entre em contato pela página inicial da APIYI em apiyi.com. Para mais informações, acesse a central de documentação em docs.apiyi.com
