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
- 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.
- 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.
- 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. - 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.
| Finalidade | Valor |
|---|---|
| Modelo recomendado | qwen3.8-max |
| Modelo alternativo | qwen3.8-flash |
| Autenticação | ANTHROPIC_AUTH_TOKEN, com sua API Key deste serviço |
| URL base | ANTHROPIC_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
| Sintoma | O que conferir |
|---|---|
| 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. |
| 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. |
| 404 / erro de modelo ou caminho | Confira 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 ignoradas | Confira 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 rede | Confira 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
- Instalação e configuração geral do Claude Code
- Guia de configuração do GLM
- Guia de configuração do Kimi
- Preços, saldo e uso
- 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.
Como usar o GLM-5.3 no Claude Code
Use GLM-5.3 no Claude Code: configure chave, URL da API e modelo, confira Windows ou Unix e resolva erros de autenticação, seleção de modelo e conexão.
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.