Guias de modelosIniciantesAtualizado em

Como usar o Qwen no Claude Code

Para usar o Qwen pela I Code Easy, configure sua API Key do serviço, a URL raiz https://api.icodeeasy.cc e o modelo qwen3.8-max no Claude Code. Você também pode escolher qwen3.8-flash. Veja como configurar, verificar e resolver erros comuns.

Antes de começar

  1. Instale o cliente seguindo o guia do Claude Code. Esta página trata do Claude Code, não da instalação ou do login no Qwen Code.
  2. Cadastre-se e copie a Key deste serviço em API Keys. Uma Key oficial da Alibaba Cloud ou assinatura oficial do Coding Plan é separada deste serviço.
  3. Em seleção de pontos de acesso, confira e selecione Qwen3.8-Max / Flash. Consulte os preços atuais na página de preços. A disponibilidade é a que aparece para sua conta.
  4. Guarde a Key na sua configuração local. Não a inclua em repositórios, capturas de tela, conversas ou chamados de suporte.

Nomes de modelos e aliases

Qwen é o modelo; Claude Code é o cliente. Aponte também os aliases Haiku, Sonnet e Opus para o mesmo modelo Qwen, evitando que configurações anteriores de Claude ou Kimi selecionem outro modelo.

FinalidadeValor
Modelo recomendadoqwen3.8-max
Modelo alternativoqwen3.8-flash
AutenticaçãoANTHROPIC_AUTH_TOKEN, com sua API Key deste serviço
URL baseANTHROPIC_BASE_URL=https://api.icodeeasy.cc, sem /v1

Para mudar para Flash, altere os quatro valores — ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL e ANTHROPIC_DEFAULT_OPUS_MODEL — para qwen3.8-flash e reinicie o Claude Code. Use os nomes exatos, sem inventar versões ou sufixos.

Configuração no macOS / Linux

Execute o seguinte no terminal em que abrirá o Claude Code e substitua o texto de exemplo pela sua Key deste serviço. As definições valem para a 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="qwen3.8-max"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3.8-max"
export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3.8-max"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen3.8-max"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

Para manter as definições, adicione as mesmas linhas export ao arquivo de inicialização do shell: ~/.zshrc para zsh ou ~/.bashrc para bash. Salve e abra um novo terminal, ou execute somente a linha correspondente ao seu shell:

source ~/.zshrc
source ~/.bashrc

Configuração no Windows PowerShell

Use estas definições na sessão atual do PowerShell:

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

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

$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")
}

Abra uma nova janela do PowerShell depois de salvar. Se usar um terminal integrado, como o do VS Code, reinicie também o aplicativo que o hospeda. Um processo do Claude Code já aberto não recebe o novo ambiente. Veja mais detalhes no guia do Claude Code.

Verifique a configuração e a primeira solicitação

Primeiro, confira a versão do cliente. Este comando mostra a versão sem enviar uma solicitação ao modelo:

claude --version

Confira se a Key existe 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 para conferir o modelo e a conexão. O nome Claude Code ou um alias Haiku, Sonnet ou Opus na interface, por si só, não comprova qual modelo processou uma solicitação.

Depois, 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 confie apenas no nome que o modelo informa na resposta.

Erros comuns e diagnóstico

SintomaO que conferir
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.
403 / acesso negadoConfira 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 limitadaLeia o erro completo e o estado no painel, reduza a simultaneidade e tente depois. Nem todo 429 significa saldo insuficiente.
404 / erro de modelo ou caminhoConfira o nome exato, qwen3.8-max ou qwen3.8-flash, e use uma BASE_URL raiz sem /v1. Guarde o erro completo para diagnóstico.
Modelo incorreto / definições ignoradasConfira conflitos no modelo principal e nas três variáveis padrão. Encerre o cliente antigo e reinicie pelo terminal em que definiu as variáveis.
Tempo esgotado / erro de redeConfira o proxy local e a rede, 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 os demais valores. As duas URLs alternativas oficiais também são endereços raiz, sem /v1:

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

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

Guias relacionados e referências oficiais