Guias de modelosIniciantesAtualizado em 2026-10-31

Como usar o DeepSeek-V4.1-Flash no Claude Code

Configure sua API Key da I Code Easy, a URL raiz https://api.icodeeasy.cc e o modelo deepseek-flash no Claude Code para usar o DeepSeek-V4.1-Flash por este serviço. Este guia cobre macOS, Linux, Windows, verificação e erros comuns.

Modelo e cliente são diferentes

DeepSeek-V4.1-Flash é o modelo; Claude Code é o cliente de programação da Anthropic. Este guia usa a API Key e a URL da I Code Easy, não uma Key ou assinatura oficial da DeepSeek. O nome Claude Code não indica que um modelo Claude atende à solicitação: esta configuração seleciona DeepSeek.

O nome exibido é DeepSeek-V4.1-Flash; o ID canônico recomendado é deepseek-flash. O serviço também aceita deepseek-v4.1-flash como alias, mas os exemplos usam o ID canônico. Não cole o nome exibido nas variáveis nem copie nomes genéricos de modelos de outros guias DeepSeek.

Antes de começar

Se ainda não instalou o cliente, siga o guia de instalação do Claude Code e volte aqui. No Windows, siga as instruções atuais da Anthropic para terminais e requisitos de Git Bash.
Cadastre-se e copie a Key deste serviço em API Keys. Escolha um ponto de acesso adequado conforme o guia inicial.
Consulte os preços atuais na página de preços e os recursos disponíveis no catálogo de capacidades dos modelos. Preços, cotas e assinaturas oficiais da DeepSeek não se aplicam a este serviço.
Guarde a Key na sua configuração local. Não a inclua em repositórios, capturas de tela, conversas ou chamados de suporte.

Referência de configuração

Variável	Valor / finalidade
`ANTHROPIC_AUTH_TOKEN`	Sua API Key da I Code Easy
`ANTHROPIC_BASE_URL`	`https://api.icodeeasy.cc`, URL raiz sem `/v1`
`ANTHROPIC_MODEL`	`deepseek-flash`, modelo da sessão atual
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	`deepseek-flash`, mapeamento do alias Haiku
`ANTHROPIC_DEFAULT_SONNET_MODEL`	`deepseek-flash`, mapeamento do alias Sonnet
`ANTHROPIC_DEFAULT_OPUS_MODEL`	`deepseek-flash`, mapeamento do alias Opus
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	`1`, desativa tráfego não essencial

As três variáveis padrão também apontam os aliases Haiku, Sonnet e Opus para deepseek-flash; elas não transformam DeepSeek em Claude. Essas variáveis configuram a CLI do Claude Code. Para o Desktop, veja o guia geral.

A URL oficial da DeepSeek compatível com Anthropic inclui /anthropic e usa uma Key oficial. Neste guia, a conexão é pela I Code Easy: use apenas a URL raiz acima, sem /anthropic, /v1 ou /v1/messages. Em ANTHROPIC_AUTH_TOKEN, coloque somente a Key do site, sem o prefixo Bearer .

Não defina CLAUDE_CODE_ATTRIBUTION_HEADER=0; mantenha os metadados nativos de atribuição. Veja as restrições no guia geral do Claude Code.

Linux / MacOS

Cole esta configuração no terminal em que executará o Claude Code e substitua o texto de exemplo pela sua Key deste serviço. Os valores se aplicam inicialmente à sessão atual do terminal:

export ANTHROPIC_AUTH_TOKEN="sua API Key da I Code Easy"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export ANTHROPIC_MODEL="deepseek-flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

Para persistir os valores, adicione as mesmas linhas export ao arquivo de inicialização do shell: ~/.zshrc para zsh ou ~/.bashrc para bash, e reabra o terminal. Veja a configuração do Claude Code para mais orientações de persistência e Windows.

Você também pode abrir outro terminal. Um processo do Claude Code já em execução não recebe as novas variáveis; encerre-o e inicie-o novamente pelo terminal configurado.

Windows

Para configurar apenas a sessão atual do PowerShell, execute:

$env:ANTHROPIC_AUTH_TOKEN = "sua API Key da I Code Easy"
$env:ANTHROPIC_BASE_URL = "https://api.icodeeasy.cc"
$env:ANTHROPIC_MODEL = "deepseek-flash"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "deepseek-flash"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "deepseek-flash"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "deepseek-flash"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

Para salvar no ambiente do usuário, execute este código na mesma janela após definir as variáveis acima. Ele salva esses sete valores no ambiente do usuário:

$names = @(
  "ANTHROPIC_AUTH_TOKEN",
  "ANTHROPIC_BASE_URL",
  "ANTHROPIC_MODEL",
  "ANTHROPIC_DEFAULT_HAIKU_MODEL",
  "ANTHROPIC_DEFAULT_SONNET_MODEL",
  "ANTHROPIC_DEFAULT_OPUS_MODEL",
  "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC"
)
foreach ($name in $names) {
  $value = [Environment]::GetEnvironmentVariable($name, "Process")
  [Environment]::SetEnvironmentVariable($name, $value, "User")
}

As variáveis do usuário são lidas por processos iniciados depois. Abra uma nova janela do PowerShell após salvar. Se usar VS Code ou outro terminal integrado, reinicie também o aplicativo que o hospeda e só então inicie o Claude Code.

Verifique localmente e envie uma solicitação real

Primeiro, confirme a instalação do cliente. Este comando mostra a versão sem fazer uma solicitação ao modelo:

claude --version

Verifique a existência da Key com um resultado booleano, sem mostrar seu conteúdo:

macOS / Linux:

test -n "$ANTHROPIC_AUTH_TOKEN" && echo true || echo false

PowerShell:

[bool]$env:ANTHROPIC_AUTH_TOKEN

Execute claude no terminal configurado e digite /status no cliente para conferir o modelo e a conexão. A tela de status ajuda a verificar a configuração. Ver Claude Code, Haiku, Sonnet ou Opus na interface, por si só, não comprova que um modelo Claude processou a solicitação.

Em seguida, envie você mesmo uma instrução curta no Claude Code, como “Responda apenas OK”. Isso gera uma solicitação real, cobrada conforme as regras atuais. Confira o sucesso, o modelo registrado e o custo nos logs de solicitações. Não use apenas o nome que o modelo informa na resposta como prova.

Problemas comuns e diagnóstico

Sintoma	Primeiras verificações
401 / falha de autenticação	Confira se a Key é deste serviço, não contém espaços extras, não foi invalidada por rotação e pertence ao mesmo serviço da URL. Não compartilhe a Key para verificação.
403 / acesso negado	Confira a situação da conta, o ponto de acesso selecionado e a permissão atual para o modelo. Envie ao suporte o erro e o horário, sem a Key.
429 / solicitação limitada	Leia o erro completo e o estado no painel; reduza a simultaneidade e tente depois. Nem todo 429 significa saldo insuficiente.
Ainda aparecem nomes Claude	Confira `ANTHROPIC_MODEL` e as três variáveis padrão. Nome do cliente, alias e modelo da solicitação são informações diferentes; compare com os logs.
Configuração não aplicada	Encerre o cliente antigo e abra-o em um novo terminal. Confira valores conflitantes nos arquivos de inicialização, no ambiente do usuário e nas configurações do cliente; confirme que alterou o shell utilizado.
Tempo esgotado / erro de rede	Confira o proxy local e a conexão. Teste as URLs JP/SG abaixo e consulte o diagnóstico de conexão.

Se o domínio principal estiver lento, altere apenas ANTHROPIC_BASE_URL e mantenha as outras variáveis. As URLs alternativas também não incluem /v1:

https://jp.icodeeasy.cc
https://sg.icodeeasy.cc

Reinicie o Claude Code após a troca e repita a verificação. Para diagnóstico, compartilhe código do erro, horário e logs sem dados sensíveis, nunca o conteúdo da Key.

Guias relacionados e referências oficiais

Instalação e configuração geral do Claude Code
Guia de configuração do GLM
Guia de configuração do Kimi: use as instruções dessa página ao escolher Kimi; não misture nomes de modelos.
Preços, saldo e uso
Variáveis de ambiente da Anthropic
Configuração de modelos da Anthropic
API da DeepSeek compatível com Anthropic
Guia de agentes de programação da DeepSeek

As referências oficiais explicam interfaces compatíveis e configurações do cliente. Keys, URLs, preços e assinaturas do acesso direto são separados deste serviço.