Guia de Uso do Claude Code com Provedores de Terceiros - Análise Profunda e Melhores Práticas

Guia de Uso do Claude Code com Provedores de Terceiros

Introdução

Este artigo é baseado na minha experiência de longo prazo com o Claude Code, compartilhando como configurar provedores de terceiros de forma eficiente e evitar armadilhas comuns de configuração. Ao contrário da mídia que apenas repassa informações oficiais, o conteúdo aqui foi verificado na prática.

Configuração de Variáveis de Ambiente

Configuração Básica (Mencionada na maioria dos tutoriais)

ANTHROPIC_BASE_URL=URL da API do seu provedor
ANTHROPIC_AUTH_TOKEN=Seu token de autenticação
ANTHROPIC_MODEL=Nome do modelo padrão

ANTHROPIC_SMALL_FAST_MODEL foi descontinuado, substituído por ANTHROPIC_DEFAULT_HAIKU_MODEL.

Configuração Avançada (Pouco mencionada)

Atualmente, o Claude Code suporta a escolha de diferentes modelos para diferentes tarefas:

# Configure diferentes séries de modelos separadamente
ANTHROPIC_DEFAULT_OPUS_MODEL=modelo da série opus
ANTHROPIC_DEFAULT_SONNET_MODEL=modelo da série sonnet
ANTHROPIC_DEFAULT_HAIKU_MODEL=modelo da série haiku

# Modelo usado pelo subagente
CLAUDE_CODE_SUBAGENT_MODEL=modelo do subagente
# Definir tempo limite
BASH_DEFAULT_TIMEOUT_MS=10000
# Desativar tráfego não essencial
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# Desativar avisos de custo, caso contrário, avisará a cada $5 gastos conforme os preços do Claude Sonnet
DISABLE_COST_WARNINGS=1
# Desativar chamadas de modelo não essenciais
DISABLE_NON_ESSENTIAL_MODEL_CALLS=1
# Desativar telemetria
DISABLE_TELEMETRY=1

Para mais configurações, consulte: https://docs.claude.com/en/docs/claude-code/settings#environment-variables

Dicas de Uso do Modo Plan

O Modo Plan do Claude Code é um recurso muito útil; ele faz com que a IA pense mais sem modificar os arquivos diretamente. Este modo é particularmente adequado para uso com o modelo Reasoner do DeepSeek. No modo plan, você pode:

• Reduzir modificações de arquivos desnecessárias
• Fornecer um processo de raciocínio mais detalhado
• Adequado para revisão de código complexa e decisões de design

Alternância Rápida de Provedores de Terceiros

Alguns desenvolveram a ferramenta Claude Code Router para integrar provedores de modelos de terceiros ao Claude Code, e outros criaram alternadores de variáveis de ambiente, mas eu não recomendo o uso dessas operações extras. Tudo o que você realmente precisa é abrir as configurações do VS Code, pesquisar terminal.integrated.env e configurar os três primeiros itens configuráveis.

Assim como este:

Em seguida, sempre que um novo terminal for aberto dentro do VS Code, ele usará as novas variáveis de ambiente. Não é necessário usar ferramentas de terceiros extras; basta configurar o VS Code que você já tem.

Por Que Não Recomendar Ferramentas de Conversão de API

Muitos usuários, para usar o Claude Code convenientemente, tentam usar o Claude Code Router ou escrever scripts de conversão, mas esses métodos geralmente se originam de uma falta de familiaridade com o VS Code e as interfaces de API.

Recomendação: Escolha provedores que suportem nativamente a API do Anthropic oficialmente, em vez de gastar seu tempo convertendo a API. Os motivos são os seguintes:

• A conversão da API Anthropic é complexa e difícil de adaptar perfeitamente
• Provedores com suporte oficial oferecem um serviço mais estável
• Evitar problemas de compatibilidade e tempo de depuração desnecessário

Existe uma lacuna enorme entre APIs comuns e a API Anthropic. Esta é a tabela de compatibilidade da conversão oficial da DeepSeek para a API Anthropic: DeepSeek-anthropic_api#anthropic-api-兼容性细节

Como o encaminhamento oficial ainda tem tantas incompatibilidades, não preciso mencionar o encaminhamento por conta própria. Sugiro não perder tempo com essas coisas.

Provedores de Terceiros Nacionais que Suportam Claude Code

Atualmente, os provedores nacionais que conheço que suportam nativamente a API Anthropic incluem:

• DeepSeek - Desempenho geral excelente
• Z-AI - Oferece bom suporte de API
• Moonshot - Grande quantidade de parâmetros
• ModelScope - Apenas o GLM-4.5 pode ser usado sem problemas

Nenhum deles suporta perfeitamente o Claude Code, existindo vários problemas, por exemplo, o DeepSeek não suporta subagentes, e os quatro não suportam imagens e documentos, etc. Se você quiser sentir o poder completo do Claude Code, o limite de entrada mínimo é o plano Max de $100, e não o plano Pro de $20, pois o Pro não pode usar o modelo Opus.

DeepSeek

"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-reasoner",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-reasoner",

Z-AI

"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
"CLAUDE_CODE_SUBAGENT_MODEL": "glm-4.5",

Moonshot

"ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_MODEL": "kimi-k2-turbo-preview",

ModelScope

"ANTHROPIC_BASE_URL": "https://api-inference.modelscope.cn",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-R1-0528",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "ZhipuAI/GLM-4.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "Qwen/Qwen3-Coder-480B-A35B-Instruct",
"CLAUDE_CODE_SUBAGENT_MODEL": "ZhipuAI/GLM-4.5",

Conclusão

Sempre que publico um documento relacionado a IA, alguém posta spam nos comentários. Aqui, lembro solenemente a todos, absolutamente não use nenhuma API de retransmissão, existe um enorme risco de segurança.

Para questões de segurança específicas, consulte: Análise de Risco de Segurança de Roteadores de Modelo

• ←Anterior
• Próximo→