Como Usar o DeepSeek-V3.1 no Claude Code

Por volta de 2 min

Como Usar o DeepSeek-V3.1 no Claude Code

Claude Code é um assistente de codificação leve que normalmente se conecta aos modelos Claude da Anthropic. Graças à API compatível com Anthropic do DeepSeek, você também pode rodar o Claude Code sobre o DeepSeek V3.1 com apenas algumas variáveis de ambiente.

Este guia te orienta pela instalação, configuração e uso.

1. Instale o Claude Code

O Claude Code pode ser instalado de duas formas:

Opção A (instalador curl):

curl -fsSL https://claude.ai/install.sh | bash

Opção B (npm):

npm install -g @anthropic-ai/claude-code

2. Configure para o DeepSeek V3.1

O Claude Code depende das variáveis da API Anthropic. Para redirecioná-lo para o endpoint compatível com Anthropic do DeepSeek, defina estas variáveis de ambiente:

# Aponte para o endpoint compatível com Anthropic do DeepSeek
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

# Sua chave de API do DeepSeek
export ANTHROPIC_AUTH_TOKEN="SUA_CHAVE_DE_API_DEEPSEEK"

# Use o DeepSeek V3.1 como modelo principal
export ANTHROPIC_MODEL="deepseek-chat"

# Use o DeepSeek V3.1 também como modelo pequeno/rápido
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"

Notas:

deepseek-chat = DeepSeek V3.1 (modo sem raciocínio)
deepseek-reasoner = DeepSeek V3.1 modo raciocínio (suporta rastros detalhados de “pensamento”, mas uso limitado de ferramentas)

Se quiser o modelo de raciocínio, substitua deepseek-chat por deepseek-reasoner.

3. Script de Inicialização com Um Clique

Para simplificar o uso, você pode criar um script shell chamado start-claude-deepseek.sh:

#!/bin/bash
# DeepSeek V3.1 com Claude Code

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="SUA_CHAVE_DE_API_DEEPSEEK"
export ANTHROPIC_MODEL="deepseek-chat"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"

# Inicia o Claude Code
claude "$@"

Torne-o executável:

chmod +x start-claude-deepseek.sh

Agora execute o Claude Code com:

./start-claude-deepseek.sh

4. Uso

Navegue até a pasta do seu projeto e execute o script:

cd seu-projeto
../start-claude-deepseek.sh

A partir daqui, o Claude Code funciona exatamente igual — só que agora é alimentado pelo DeepSeek V3.1.

5. Solução de Problemas

Erro de token inválido → verifique se ANTHROPIC_AUTH_TOKEN está configurado com sua chave real da API DeepSeek.
Sem resposta → confirme se ANTHROPIC_BASE_URL está correto (https://api.deepseek.com/anthropic).
Chamada de ferramenta/função → suportada em deepseek-chat; deepseek-reasoner pode voltar para deepseek-chat.

✅ Agora você está pronto para usar o Claude Code com DeepSeek V3.1 como seu assistente de codificação AI.