DeepSeek V4 Flash e Pro no Claude Code: configuração e troca de modelos

Configure o DeepSeek no Claude Code usando a APIMaster. Defina o settings.json no Windows, macOS e Linux, inicie o claude, selecione um modelo com /model e comece a conversar.

Configure a APIMaster no settings.json, execute claude e digite /model MODEL_ID na conversa para usar o DeepSeek. Os IDs disponíveis abordados aqui são deepseek-v4-flash e deepseek-v4-pro. O Claude Code é o cliente; o DeepSeek é o modelo que responde.

Antes de começar

Conclua a verificação do ambiente e a configuração do Claude Code. Obtenha uma chave de API da APIMaster com saldo suficiente e acesso aos modelos selecionados.

claude --version

A URL base do gateway é https://apimaster.ai, sem /v1. O Claude Code adiciona /v1/messages por conta própria.

1. Abra o diretório de configuração

Windows

Pressione Win + R, digite o caminho abaixo e pressione Enter:

%USERPROFILE%\.claude

Crie a pasta, se necessário. Abra ou crie o settings.json. Verifique se ele não foi nomeado como settings.json.txt.

macOS / Linux

No macOS, no Finder pressione Command + Shift + G e digite:

~/.claude

No Linux, abra o mesmo diretório com seu gerenciador de arquivos ou editor. Crie-o, se necessário:

mkdir -p ~/.claude

Abra ou crie o settings.json nesse local. Se você definiu um diretório de configuração personalizado para o Claude Code, use esse diretório.

2. Edite o settings.json

Windows, macOS e Linux usam a mesma configuração. Substitua YOUR_APIMASTER_API_KEY pela sua chave da APIMaster:

{
  "model": "deepseek-v4-flash",
  "env": {
    "ANTHROPIC_BASE_URL": "https://apimaster.ai",
    "ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
    "ANTHROPIC_AUTH_TOKEN": "",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Se o arquivo já existir, faça um backup e mescle esses campos no objeto JSON existente e no objeto env. Mantenha as outras configurações de que precisa. Não acrescente um segundo objeto JSON nem duplique a chave env. JSON não permite comentários nem vírgulas finais.

O guia geral do Claude Code mostra autenticação por token. Este guia usa a autenticação por chave de API exercitada em nossos testes de integração. Mantenha ANTHROPIC_AUTH_TOKEN vazio ao usar ANTHROPIC_API_KEY e remova credenciais conflitantes de outras configurações ou do seu terminal. Use uma chave da APIMaster para este gateway.

O campo model define o modelo inicial. Você pode selecionar outro após o início. Mantenha este arquivo de configurações de usuário privado; não faça commit de chaves reais em um repositório compartilhado. Salve o arquivo e reinicie o Claude Code para carregar a nova configuração.

3. Inicie o Claude Code

Em um terminal aberto no diretório do seu projeto, execute:

claude

Conclua os prompts normais de primeira execução e revise o prompt de confiança do projeto. O modelo inicial deve ser o deepseek-v4-flash. Esta é uma sessão interativa normal, com as ferramentas e configurações de projeto habituais.

4. Selecione um modelo e comece a conversar

Na conversa do Claude Code, digite um dos comandos abaixo e pressione Enter:

/model deepseek-v4-flash
/model deepseek-v4-pro

Execute uma linha por vez, escolhendo o modelo desejado. Depois que o Claude Code confirmar a troca, envie uma mensagem curta:

Reply with exactly OK.

Uma resposta normal em texto confirma a conexão básica. Você pode então continuar conversando ou pedir para ele trabalhar no seu projeto. Para trocar novamente na mesma conversa, digite outro comando /model MODEL_ID.

Digitar apenas /model abre o seletor de modelos. IDs personalizados do gateway podem não aparecer na lista padrão dele. Nesse caso, digite o ID completo como mostrado acima. O comando de barra pertence ao interior do Claude Code, não ao PowerShell ou ao Bash. Os nomes dos modelos descrevem modelos do DeepSeek, não Claude Sonnet ou Opus.

Você também pode escolher um modelo ao iniciar pelo terminal. Execute um comando por vez:

claude --model deepseek-v4-flash
claude --model deepseek-v4-pro

Para definir o padrão para sessões futuras de forma explícita, edite model no settings.json. Uma flag de inicialização, a variável de ambiente ANTHROPIC_MODEL ou uma configuração de projeto/gerenciada podem afetar o modelo selecionado; verifique esses pontos se o modelo inicial for diferente do valor salvo.

Solução de problemas

Sintoma	Verificação
401 / prompt de login inesperado	Verifique a chave da APIMaster, a URL base e as variáveis de autenticação conflitantes; reinicie a CLI após editar as configurações.
404	Use `https://apimaster.ai`, sem `/v1` ou `/v1/messages`.
As configurações não têm efeito	Verifique a localização do arquivo, a validade do JSON e sobrescritas vindas do terminal, do projeto ou de configurações gerenciadas.
Modelo ausente no seletor	Digite `/model MODEL_ID` com o ID exato, ou inicie com `claude --model MODEL_ID`.
Modelo indisponível / 403	Verifique a ortografia, os modelos permitidos para a chave, o saldo da conta e a disponibilidade atual da rota.
`unrecognized_model`	Observado com IDs personalizados em nossos testes. Verifique a resposta real e o resultado da ferramenta; os padrões nativos de capacidade do Claude não foram verificados para o DeepSeek.
Permissão negada para arquivo ou comando	Revise e aprove a operação pretendida por meio dos prompts de permissão habituais.
429 / 5xx / resposta interrompida	Guarde o erro, o ID do modelo, a versão da CLI, o horário UTC e o ID da requisição, se disponível, para o suporte.

Validação e diagnósticos opcionais

Testes de integração registrados: 2026-09-07 UTC, Claude Code 2.1.239, Linux. Todos os modelos listados aqui retornaram o texto esperado e leram um arquivo local por meio de uma ferramenta. Tarefas complexas de programação ficaram fora do escopo desse teste. Windows e macOS não fizeram parte dessas execuções registradas.

As verificações automatizadas anteriores usaram o modo bare para isolar a configuração. O uso diário normal segue o settings.json e as etapas interativas acima. O modo bare e --setting-sources "" ignoram integrações normais ou configurações salvas, portanto não devem ser adicionados ao comando de inicialização do dia a dia deste guia.

Para uma verificação rápida não interativa usando sua configuração salva:

claude --model deepseek-v4-flash -p "Reply with exactly OK."

Para verificar uma ferramenta, crie o arquivo probe.txt contendo FILE_PROBE_739182, inicie o Claude Code nesse diretório e peça para ele ler o arquivo usando uma ferramenta e retornar o conteúdo exato. Confirme que a ferramenta realmente foi executada.

Estas são verificações de integração delimitadas, não uma garantia de todos os recursos do Claude Code, do comportamento em sessões longas ou do contexto máximo. A documentação de gateway da Anthropic não oferece suporte oficial ao roteamento do Claude Code para modelos que não sejam da Claude; este guia descreve a integração da APIMaster.

FAQ

Minha assinatura do Claude paga por essas requisições?

Não. Com esta configuração da APIMaster, as requisições usam sua chave e seu saldo da APIMaster.

Posso continuar conversando depois de trocar de modelo?

Sim, use o comando de troca de modelo na conversa aberta e aguarde a confirmação antes de enviar a próxima mensagem. Para uma comparação limpa entre modelos, inicie uma sessão separada com claude --model MODEL_ID.