Nota do autor: Solução completa para o erro "modelo não encontrado" no Claude Code ao usar um serviço proxy de API de terceiros: como escrever a Base URL corretamente, métodos de configuração no settings.json e tabela de nomes dos modelos mais recentes.
Ao usar o Claude Code, o erro mais comum que aparece é este:
There's an issue with the selected model (claude-sonnet-4-6). It may not exist or you may not have access to it. Run /model to pick a different model.
Esse erro geralmente acontece em duas situações:
- Você usou uma chave API oficial, mas errou a grafia do nome do modelo (basta rodar
/modele escolher um novo). - Você conectou um serviço proxy de API de terceiros, e a Base URL não está configurada corretamente, causando falha na rota do modelo.
Este artigo foca na solução completa para o segundo caso, usando o APIYI (apiyi.com) como exemplo, cobrindo as configurações via variáveis de ambiente e pelo arquivo settings.json, além de trazer uma tabela comparativa com os nomes dos modelos Claude mais recentes.
Valor central: Ao terminar de ler, você saberá como configurar corretamente o Claude Code para usar um serviço proxy de API de terceiros, eliminando o erro de modelo não encontrado e garantindo estabilidade total no uso das funções do Claude Code.
1. Localizando o problema rapidamente: é o nome do modelo ou a Base URL?
Antes de sair configurando, gaste 30 segundos para identificar qual é o seu problema:
| Sintoma | Causa provável | Como resolver |
|---|---|---|
Erro Run /model to pick a different model |
Nome do modelo inexistente ou sem permissão | Execute /model e escolha novamente |
| Inseriu o nome correto, mas o erro persiste | Problema na configuração da Base URL | Verifique a ANTHROPIC_BASE_URL |
| Falha na validação da chave API | Chave inválida ou não configurada | Reconfigure a ANTHROPIC_API_KEY |
| Timeout de rede / Conexão recusada | Endereço do proxy preenchido incorretamente | Verifique o formato da Base URL |
| Todos os modelos dão erro | O proxy não é compatível com o formato Anthropic | Confirme se o proxy suporta o protocolo nativo da Anthropic |
Se você estiver usando uma chave API oficial da Anthropic e tiver acesso normal ao site anthropic.com, basta executar o comando /model dentro do Claude Code para trocar de modelo, sem necessidade de configurações extras.
Se você estiver usando um serviço proxy de API de terceiros (como o apiyi.com), siga as soluções de configuração abaixo.
🎯 Sugestão: Recomendamos a plataforma APIYI (apiyi.com) para conectar ao Claude Code. Ela é totalmente compatível com o formato nativo da Anthropic e suporta toda a linha de modelos, incluindo os novos
claude-opus-4-6eclaude-sonnet-4-6, com alta estabilidade.
II. Configuração principal para acessar o Claude Code via API proxy de terceiros
2.1 Formato correto da Base URL: remova o /v1
Este é o passo mais crítico e onde a maioria das pessoas comete erros.
O Claude Code possui uma lógica de processamento especial para a Base URL: ele adiciona automaticamente /v1/messages ao final da URL que você configurar. Por isso:
-
❌ Forma incorreta:
ANTHROPIC_BASE_URL=https://api.apiyi.com/v1- O caminho real da requisição se torna:
https://api.apiyi.com/v1/v1/messages(o/v1fica duplicado) - Resultado: a rota não encontra o endpoint e o modelo retorna erro.
- O caminho real da requisição se torna:
-
✅ Forma correta:
ANTHROPIC_BASE_URL=https://api.apiyi.com- O caminho real da requisição se torna:
https://api.apiyi.com/v1/messages - Resultado: atinge corretamente a interface nativa da Anthropic.
- O caminho real da requisição se torna:
📌 Resumo da regra: ao configurar
ANTHROPIC_BASE_URL, preencha apenas o domínio raiz, sem o sufixo/v1. O Claude Code completará o caminho inteiro automaticamente.
2.2 Obtendo a chave API
Acesse o painel da APIYI para obter seu token: Página de gerenciamento de tokens da APIYI
Sugestões para escolha do token:
| Tipo de Token | Cenário de Uso | Desconto |
|---|---|---|
| Token Padrão | Uso geral, pronto para usar | Preço padrão |
| Token do grupo ClaudeCode | Exclusivo para o Claude Code | 12% de desconto (88% do preço) |
Ao criar um novo token, selecione o grupo ClaudeCode para aproveitar o desconto de 12%, reduzindo o custo de uso a longo prazo.
三、Explicação detalhada das duas formas de configuração
Método 1: Configuração via variáveis de ambiente (Recomendado para testes temporários)
Execute os seguintes comandos no terminal. A configuração entrará em vigor imediatamente (válida apenas para a sessão atual):
# Configura a Base URL do serviço proxy de terceiros (Atenção: não adicione /v1)
export ANTHROPIC_BASE_URL="https://api.apiyi.com"
# Configura a chave API (substitua pela sua chave real)
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
# Inicia o Claude Code
claude
Verifique se a configuração está ativa:
# Visualiza as variáveis de ambiente atuais
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY
# A saída deve ser:
# https://api.apiyi.com
# sk-xxxxxx...
Prós e contras:
- ✅ Simples e rápido, sem necessidade de modificar arquivos.
- ✅ Não afeta a configuração de outras sessões.
- ❌ Precisa ser configurado toda vez que abrir um novo terminal (a menos que seja adicionado ao
.zshrc/.bashrc).
Solução para tornar permanente (escrevendo no arquivo de configuração do Shell):
# Para usuários de zsh (padrão no macOS)
echo 'export ANTHROPIC_BASE_URL="https://api.apiyi.com"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-sua-chave"' >> ~/.zshrc
source ~/.zshrc
# Para usuários de bash
echo 'export ANTHROPIC_BASE_URL="https://api.apiyi.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-sua-chave"' >> ~/.bashrc
source ~/.bashrc
Método 2: Configuração via settings.json (Recomendado para uso a longo prazo)
Edite o arquivo ~/.claude/settings.json (configuração global, válida para todos os projetos):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-SuaChaveAPI"
}
}
🎯 Recomendação: Use o
~/.claude/settings.jsonpara configurações globais. Uma vez configurado, ele funciona para sempre, sem precisar repetir as variáveis de ambiente. Acesse APIYI apiyi.com para obter sua chave e escolha os tokens do grupo ClaudeCode para aproveitar 12% de desconto.
Se o arquivo não existir, crie-o manualmente:
# Cria o diretório .claude (se não existir)
mkdir -p ~/.claude
# Cria o arquivo settings.json
cat > ~/.claude/settings.json << 'EOF'
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-substitua-pela-sua-chave"
}
}
EOF
Prioridade de configuração (da mais alta para a mais baixa):
| Prioridade | Origem da Configuração | Descrição |
|---|---|---|
| 1 (Mais alta) | Variáveis de ambiente | export direto no terminal |
| 2 | .claude/settings.local.json |
Configuração local do projeto (não enviada ao git) |
| 3 | .claude/settings.json |
Configuração compartilhada do projeto |
| 4 (Mais baixa) | ~/.claude/settings.json |
Configuração global do usuário |
Para o mesmo item de configuração, a prioridade mais alta substituirá a mais baixa. Se você tiver um settings.json no diretório do projeto, lembre-se desta relação de precedência.
四、Nomes dos modelos mais recentes suportados pelo Claude Code
Estes são os nomes dos modelos Claude mais recentes para 2026. Eles devem ser preenchidos com precisão, respeitando letras maiúsculas, minúsculas e números:
Modelos de raciocínio padrão
| Nome do Modelo | Série | Posicionamento de Capacidade | Cenário de Uso |
|---|---|---|---|
claude-opus-4-6 |
Claude 4.6 | Capacidade máxima | Código complexo, análise profunda, processamento de documentos longos |
claude-sonnet-4-6 |
Claude 4.6 | Equilíbrio entre poder e velocidade | Programação diária, revisão de código, redação de documentos |
claude-haiku-4-5-20251001 |
Claude 4.5 | Resposta ultra-rápida | Perguntas simples, preenchimento de código, tarefas rápidas |
Modelos de raciocínio aprimorado (Modo de Pensamento)
Ao adicionar o sufixo -thinking ao nome do modelo, você ativa o modo de pensamento estendido, onde o modelo realiza um raciocínio profundo antes de responder:
| Nome do Modelo | Modelo Base | Características |
|---|---|---|
claude-opus-4-6-thinking |
claude-opus-4-6 | Raciocínio mais forte, ideal para matemática/lógica/decisões complexas |
claude-sonnet-4-6-thinking |
claude-sonnet-4-6 | Equilíbrio entre raciocínio e velocidade, primeira escolha para uso diário |
claude-haiku-4-5-20251001-thinking |
claude-haiku-4-5-20251001 | Raciocínio leve |
💡 Sugestão de escolha: Para o uso diário do Claude Code, recomendamos o
claude-sonnet-4-6, que oferece o melhor equilíbrio entre qualidade de codificação e velocidade de resposta. Para design de arquiteturas complexas ou depuração de bugs difíceis, mude paraclaude-opus-4-6ouclaude-sonnet-4-6-thinking.
5. Como trocar de modelo no Claude Code
Após configurar a Base URL e a chave API, existem duas formas de alternar entre os modelos:
5.1 Usando o comando /model (o mais simples)
Na conversa com o Claude Code, digite diretamente:
/model
O Claude Code exibirá uma lista de seleção de modelos. Se estiver usando um serviço proxy de API de terceiros, pode ser que nem todos os modelos apareçam automaticamente na lista; nesse caso, você precisará digitar o nome do modelo manualmente.
5.2 Especificando modelos padrão no settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-SuaChaveAPI",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6"
}
}
Através das variáveis de ambiente ANTHROPIC_DEFAULT_*_MODEL, você pode especificar o nome exato para cada nível de modelo, evitando que o Claude Code use os nomes padrão internos (que podem não ser compatíveis com o serviço proxy).
🎯 Exemplo de configuração completa: Recomendamos salvar a configuração acima em
~/.claude/settings.json, utilizando o token do grupo ClaudeCode da APIYI (apiyi.com) como sua ANTHROPIC_API_KEY.
6. Erros comuns e soluções (FAQ)
Q1: Após configurar a ANTHROPIC_BASE_URL, o Claude Code não inicia de jeito nenhum?
Verifique se o formato JSON está correto. Erros comuns incluem:
- Uma vírgula extra após o último par de chave-valor (o formato JSON não permite vírgulas no final).
- Uso de aspas curvas
“”em vez de aspas retas padrão"".
# Validar o formato JSON
cat ~/.claude/settings.json | python3 -m json.tool
Se a saída for exibida corretamente, o formato está ok; se houver erro, existe um problema de sintaxe.
Q2: Recebo o erro Invalid API key, mas tenho certeza de que minha chave está correta?
Causas possíveis:
- Espaços antes ou depois da chave → Verifique se não copiou espaços extras ao colar.
- Chave expirada ou desativada → Faça login em
api.apiyi.com/tokene gere uma nova. - Conflito de variáveis de ambiente → Pode haver uma
ANTHROPIC_API_KEYantiga configurada no seu sistema.
# Verificar se existem variáveis de ambiente de múltiplas fontes
env | grep ANTHROPIC
Q3: A invocação do modelo funciona, mas os resultados são de baixa qualidade ou o formato está estranho?
Causa provável: O serviço proxy de API pode não suportar totalmente o formato da Anthropic, especialmente no processamento do system prompt.
Método de verificação: Teste diretamente com um comando curl para ver se o serviço proxy retorna os dados corretamente:
curl https://api.apiyi.com/v1/messages \
-H "Content-Type: application/json" \
-H "x-api-key: sk-SuaChave" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 100,
"messages": [{"role": "user", "content": "Diga olá"}]
}'
Uma resposta normal deve conter o campo content com a saída de texto real. Se o retorno for um erro ou algo inesperado, o problema está no serviço proxy.
🎯 Diagnóstico rápido: A APIYI (apiyi.com) é totalmente compatível com o formato nativo da Anthropic, e o teste curl acima funcionará perfeitamente na plataforma. Se estiver testando outro serviço proxy, use este comando para validar a compatibilidade rapidamente.
Q4: Como configurar variáveis de ambiente no Windows?
Para usuários Windows, recomendamos usar o método do arquivo settings.json, que é mais simples e confiável:
// C:\Users\SeuUsuario\.claude\settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-SuaChaveAPI"
}
}
Se preferir usar o PowerShell para definir variáveis temporárias:
$env:ANTHROPIC_BASE_URL = "https://api.apiyi.com"
$env:ANTHROPIC_API_KEY = "sk-SuaChaveAPI"
claude
Q5: Como usar configurações de API diferentes para projetos diferentes?
Crie um arquivo .claude/settings.json na raiz do seu projeto (este arquivo terá prioridade sobre a configuração global):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-ChaveEspecificaDoProjeto"
}
}
Atenção: Se este arquivo contiver sua chave, recomendamos adicioná-lo ao seu .gitignore para evitar que ele seja enviado ao repositório de código. Usar .claude/settings.local.json (configuração local) é ainda mais seguro, pois ele não é rastreado pelo git por padrão.
7. Checklist de Verificação da Configuração
Após concluir a configuração, siga estes passos para validar:
# Passo 1: Confirmar se as variáveis de ambiente estão ativas
echo "Base URL: $ANTHROPIC_BASE_URL"
echo "API Key: ${ANTHROPIC_API_KEY:0:10}..."
# Passo 2: Testar a conectividade da API
curl -s https://api.apiyi.com/v1/models \
-H "x-api-key: $ANTHROPIC_API_KEY" | head -c 200
# Passo 3: Iniciar o Claude Code e testar
claude --version
claude
No chat do Claude Code, digite /status para verificar o status da conexão atual e confirmar se a Base URL e a configuração do modelo estão corretas.
🎯 Após a configuração: Recomendamos enviar uma mensagem simples para confirmar se o Claude Code está respondendo normalmente. A plataforma APIYI (apiyi.com) permite consultar o saldo, possibilitando o monitoramento em tempo real do uso de Tokens do Claude Code no painel, o que facilita o controle de custos.
Resumo
Se você encontrar o erro "modelo não encontrado" ao conectar o Claude Code a um serviço proxy de API de terceiros, 90% das vezes o motivo é o formato incorreto da Base URL. Os princípios fundamentais são:
- Base URL sem o
/v1: Preencha comohttps://api.apiyi.com. O Claude Code adicionará automaticamente/v1/messages. - Correspondência exata do nome do modelo: Use nomes completos como
claude-sonnet-4-6,claude-opus-4-6,claude-haiku-4-5-20251001, etc. - Configuração recomendada no settings.json: Salve em
~/.claude/settings.jsonpara que as alterações sejam permanentes, sem precisar configurar variáveis de ambiente toda vez. - Token exclusivo para Claude Code: Selecione o grupo ClaudeCode no painel da APIYI para aproveitar descontos especiais.
Se você utiliza apenas a chave API oficial da Anthropic e sua rede possui conexão direta, basta executar o comando /model dentro do Claude Code para selecionar o modelo, sem necessidade de configurações extras.
🎯 Obter chave API: Acesse APIYI (apiyi.com) para criar sua conta e gerar um token do grupo ClaudeCode na página de gerenciamento de tokens (
api.apiyi.com/token). A plataforma funciona no modelo pré-pago, sem consumo mínimo, cobrando apenas pelo uso real de Tokens — ideal para uso individual ou em equipe.
Este artigo foi organizado pela equipe técnica da APIYI, baseado em testes reais com o Claude Code v2.x. Se tiver problemas de configuração, visite a Central de Ajuda da APIYI em help.apiyi.com para obter suporte.
