Guias de modelosIniciantesAtualizado em

Como usar Doubao Seed 2.1 Turbo no Claude Code

Configure sua API Key da I Code Easy, a URL raiz https://api.icodeeasy.cc e o modelo doubao-seed-2.1-turbo no Claude Code para usar Doubao Seed 2.1 Turbo. Este guia cobre macOS, Linux, Windows, verificação e solução de problemas.

Diferencie modelo, cliente e conta

Doubao Seed 2.1 Turbo é um modelo de texto; Claude Code é o cliente de programação da Anthropic. Esta configuração seleciona Doubao e não implica que um modelo Claude processe a solicitação. Os modelos de texto Seed são separados da geração de imagens Seedream e da geração de vídeos Seedance.

Use uma API Key da I Code Easy, não uma chave oficial da Volcengine / Ark, um plano oficial ou o login do aplicativo Doubao para consumidores. Não misture chaves e URLs de serviços diferentes.

Antes de começar

  1. Instale o cliente pelo guia do Claude Code; veja a preparação do ambiente para sistema e terminal.
  2. Cadastre-se e copie sua chave em API Keys. Guarde-a apenas na configuração local.
  3. Confira preços e uso atuais e o catálogo de capacidades para os recursos publicamente disponíveis.

Use doubao-seed-2.1-turbo diretamente em configurações novas. O nome antigo doubao-seed-2.0-pro é atualizado de forma transparente para Seed 2.1 Turbo e não seleciona mais um modelo antigo separado. As três variáveis ANTHROPIC_DEFAULT_*_MODEL também apontam os aliases Haiku, Sonnet e Opus para este modelo.

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="doubao-seed-2.1-turbo"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="doubao-seed-2.1-turbo"
export ANTHROPIC_DEFAULT_SONNET_MODEL="doubao-seed-2.1-turbo"
export ANTHROPIC_DEFAULT_OPUS_MODEL="doubao-seed-2.1-turbo"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

Para persistir a configuração, adicione as mesmas linhas export ao arquivo de inicialização do seu shell: ~/.zshrc para zsh ou ~/.bashrc para bash. Execute somente a linha correspondente ao shell utilizado:

source ~/.zshrc
source ~/.bashrc

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 = "doubao-seed-2.1-turbo"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "doubao-seed-2.1-turbo"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "doubao-seed-2.1-turbo"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "doubao-seed-2.1-turbo"
$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

SintomaPrimeiras verificações
401 / falha de autenticaçãoConfira 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 negadoConfira o estado da conta e o acesso atual ao modelo. Envie ao suporte o texto do erro e o horário, sem a chave.
429 / solicitação limitadaLeia o erro completo e o estado no painel; reduza a simultaneidade e tente depois. Nem todo 429 significa saldo insuficiente.
Ainda aparecem nomes ClaudeConfira 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 aplicadaEncerre 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 redeConfira 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