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
- Instale o cliente pelo guia do Claude Code; veja a preparação do ambiente para sistema e terminal.
- Cadastre-se e copie sua chave em API Keys. Guarde-a apenas na configuração local.
- 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
| 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 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 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
- Preparação do ambiente
- Preços, saldo e uso
- Capacidades dos modelos
- Variáveis de ambiente da Anthropic
- Configuração de modelos da Anthropic
Guias relacionados
Instalar o Claude Code, Configurar a API e Resolver Erros no Windows
Instale o Claude Code, configure chave e URL da API, verifique o ambiente e resolva erros de autenticação, limites e conexão no Windows, macOS e Linux.
Configurar Kimi Code: API Key, K3.1 Pro e Claude Code
Configure K3.1 Pro no Kimi Code CLI ou Claude Code. Compare opções persistentes e temporárias, valide a primeira chamada e resolva erros 401, de modelo e URL.
Onde vejo preços em RMB, saldo e detalhes de uso?
Consulte preços RMB ao vivo, saldo, logs, uso de tokens, detalhes de cobrança e disponibilidade atual de pagamento nas superfícies públicas e do painel.