Usando DeepSeek no Claude Code: Guia de Configuração V4 Flash / Pro

Execute DeepSeek V4 Flash e Pro no Claude Code através do APIMaster. Defina o gateway e a chave de API, alterne modelos, verifique as ferramentas de leitura de arquivos e corrija erros de configuração.

O Claude Code pode usar DeepSeek? Nossos testes com Claude Code 2.1.239 usaram com sucesso deepseek-v4-flash e deepseek-v4-pro através do endpoint Messages do APIMaster. Defina ANTHROPIC_BASE_URL para https://apimaster.ai, forneça uma chave APIMaster e selecione o modelo explicitamente. Esta configuração executa o DeepSeek, mesmo que o cliente seja chamado de Claude Code.

Último teste: 2026-09-07, Claude Code 2.1.239, Linux. Ambos os modelos retornaram o texto esperado e completaram uma ida e volta com a ferramenta de leitura de arquivos. Todas as execuções saíram com código 0. A CLI imprimiu unrecognized_model, mas as solicitações testadas foram bem-sucedidas. Essas verificações não estabelecem suporte para todos os recursos do Claude Code, sessões longas ou versões futuras. Os comandos de configuração para Windows / macOS estão incluídos; o teste registrado foi executado no Linux.

1. Prepare a CLI e a chave de API

Siga o guia de ambiente e o guia de configuração do Claude Code para instalação. Verifique sua versão:

claude --version

Obtenha uma chave de API APIMaster com acesso ao modelo DeepSeek selecionado e cota suficiente. Use as configurações de sessão abaixo para este tutorial; não há necessidade de sobrescrever seu settings.json normal.

2. Defina o gateway e a chave

Abra um novo terminal para manter essas configurações separadas da sua sessão CLI usual.

macOS / Linux:

export ANTHROPIC_BASE_URL='https://apimaster.ai'
export ANTHROPIC_API_KEY='YOUR_APIMASTER_API_KEY'
unset ANTHROPIC_AUTH_TOKEN

Windows PowerShell:

$env:ANTHROPIC_BASE_URL = 'https://apimaster.ai'
$env:ANTHROPIC_API_KEY = 'YOUR_APIMASTER_API_KEY'
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue

Use a origem do site aqui, sem /v1: o Claude Code acrescenta /v1/messages. A chave de API deve vir do APIMaster. Esses comandos afetam este terminal e seus processos filhos, não seus arquivos de login salvos. Não coloque uma chave real em um arquivo de configuração compartilhado ou repositório.

3. Envie uma solicitação de teste mínima

claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools "" --output-format json -p "Reply with exactly: DEEPSEEK_TEST_OK"

Esperado: is_error é false, result é DEEPSEEK_TEST_OK, e o processo sai com código 0. Altere --model para deepseek-v4-pro e execute novamente.

O modo --bare da versão testada usa autenticação explícita por chave de API e ignora integrações normais em segundo plano. --setting-sources "" exclui fontes de configuração salvas, enquanto --tools "" desabilita ferramentas para este teste de texto único. Estas são configurações de diagnóstico deliberadas, não requisitos para desabilitar ferramentas durante o uso normal. Versões mais antigas da CLI podem não aceitar todas essas flags.

4. Verifique as ferramentas de leitura de arquivos

Crie probe.txt no diretório atual com este conteúdo:

TOOL_PROBE_739182

Execute:

claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools Read --allowedTools Read --output-format json -p "Use the Read tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."

Esperado: a CLI lê o arquivo e retorna TOOL_PROBE_739182. Repita com deepseek-v4-pro. Isso verifica se o modelo pode solicitar uma ferramenta, receber seu resultado e então responder. Apenas a ferramenta Read está habilitada para este teste.

Para trabalho interativo comum com as mesmas configurações de terminal:

claude --bare --setting-sources "" --model deepseek-v4-flash

Para iniciar com Pro:

claude --bare --setting-sources "" --model deepseek-v4-pro

Os comandos interativos omitem --tools "", então as ferramentas padrão estão disponíveis. Revise os prompts de permissão como de costume. --bare ignora conveniências como hooks e instruções automáticas de projeto; habilite suas configurações normais deliberadamente após a configuração mínima funcionar e verifique se elas não sobrescrevem o gateway ou o modelo. Feche este terminal quando terminar para deixar o ambiente desta sessão para trás.

Solução de problemas

Sintoma	O que verificar
`unrecognized_model`	Observado para ambos os IDs DeepSeek em 2.1.239. Não impediu que nossas solicitações fossem concluídas. Verifique o resultado final em vez de tratar o aviso sozinho como falha.
401 ou um prompt de login inesperado	Confirme se `ANTHROPIC_API_KEY` está definido, remova um `ANTHROPIC_AUTH_TOKEN` conflitante neste terminal e tente novamente o modo bare.
404	`ANTHROPIC_BASE_URL` deve ser `https://apimaster.ai`, não o endpoint completo `/v1/messages` ou uma base terminando em `/v1`.
Opção `--bare` desconhecida	Verifique sua versão em relação à testada 2.1.239. Use o guia de instalação geral para atualizar se apropriado.
Não é possível ler `probe.txt`	Execute a partir do diretório do arquivo. Para o teste de ferramenta, habilite Read em vez de usar `--tools ""`.
Um modelo diferente está selecionado	Passe o ID completo do modelo com `--model` e verifique as configurações salvas ou sobrescritas de alias de modelo antes de habilitá-las.
Limite de taxa, cota insuficiente ou erro upstream	Leia o corpo do erro, verifique a cota e as permissões do modelo e registre o timestamp para suporte.

Perguntas frequentes

Isso é o mesmo que usar um modelo Claude?

Não. O Claude Code é o cliente aqui; o modelo selecionado é o DeepSeek. Recursos que dependem de um modelo Claude específico não são automaticamente cobertos por esta configuração.

Por que a URL base é diferente do exemplo do SDK Python?

O SDK Python OpenAI usa https://apimaster.ai/v1 e acrescenta /chat/completions. O Claude Code usa https://apimaster.ai e acrescenta /v1/messages. Use o formato base documentado de cada cliente.

Posso usar uma chave oficial DeepSeek com este gateway?

Este tutorial requer uma chave emitida pelo APIMaster. As chaves são específicas do provedor que as emite; alterar apenas o endpoint não transfere credenciais ou cota.

O uso real de ferramentas foi testado, ou apenas uma resposta de texto?

Ambos foram testados para ambos os modelos. O teste de ferramenta leu um arquivo local e retornou seu conteúdo. Isso não estabelece que todas as ferramentas, agentes em segundo plano ou tarefas longas de codificação são suportados.