Model guidesBeginnersUpdated

How to use Qwen with Claude Code

To use Qwen through I Code Easy, set your service API Key, the root URL https://api.icodeeasy.cc, and model qwen3.8-max in Claude Code. You can also select qwen3.8-flash. This guide covers setup, verification, and common errors.

Before you start

  1. Install the client using the Claude Code guide. These instructions are for Claude Code, not the Qwen Code installation or login flow.
  2. Register and copy your service Key from API Keys. An official Alibaba Cloud Key or Coding Plan subscription is separate from this service.
  3. Open endpoint selection and select Qwen3.8-Max / Flash. Check the pricing page for current prices; access depends on what is available to your account.
  4. Keep the Key in your local configuration. Do not include it in repositories, screenshots, chats, or support tickets.

Model names and aliases

Qwen is the model; Claude Code is the client. Map its Haiku, Sonnet, and Opus aliases to the same Qwen model so earlier Claude or Kimi settings do not select a different model.

PurposeValue
Recommended modelqwen3.8-max
Alternative modelqwen3.8-flash
AuthenticationANTHROPIC_AUTH_TOKEN, using your service API Key
Base URLANTHROPIC_BASE_URL=https://api.icodeeasy.cc, without /v1

To switch to Flash, change all four values—ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, and ANTHROPIC_DEFAULT_OPUS_MODEL—to qwen3.8-flash, then restart Claude Code. Use the exact model names; do not invent version numbers or suffixes.

macOS / Linux setup

Run the following in the terminal where you will launch Claude Code. Replace the placeholder with your service Key. These settings apply to the current terminal session:

export ANTHROPIC_AUTH_TOKEN="your I Code Easy API Key"
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"

To keep the settings, add the same export lines to your shell’s startup file: ~/.zshrc for zsh or ~/.bashrc for bash. Then open a new terminal, or run only the line that matches your shell:

source ~/.zshrc
source ~/.bashrc

Windows PowerShell setup

Use these settings for the current PowerShell session:

$env:ANTHROPIC_AUTH_TOKEN = "your I Code Easy API Key"
$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"

For persistence at user level, run this code in the same window after setting the variables above. It saves those seven values:

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

Open a new PowerShell window after saving. If using an integrated terminal such as VS Code’s, restart the host application too. An existing Claude Code process will not receive the updated environment. See the Claude Code guide for more terminal setup details.

Verify the setup and your first request

First check the client version. This command prints the version without making a model request:

claude --version

Check whether the Key exists with a boolean result, without printing the Key itself:

macOS / Linux:

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

PowerShell:

[bool]$env:ANTHROPIC_AUTH_TOKEN

Run claude from the configured terminal, then enter /status to inspect the model and connection settings. The Claude Code name or a Haiku, Sonnet, or Opus alias in the interface alone does not establish which model handled a request.

Next, send a short prompt yourself in Claude Code, such as “Reply only OK.” This creates a real request, billed under current rules. Check request logs for success, the recorded model, and charges. Do not rely solely on the model’s self-identification in its response.

Common errors and troubleshooting

SymptomWhat to check
401 / authentication failedUse your service Key without extra spaces; check that it has not been rotated and that the Key and URL belong to the same service.
403 / access deniedCheck account status, endpoint selection, and current model access. Share the error text and time with support, without the Key.
429 / request limitedRead the full error and dashboard status, reduce concurrency, and retry later. Do not assume every 429 means insufficient balance.
404 / model or path errorCheck the exact model name, qwen3.8-max or qwen3.8-flash, and use a root BASE_URL without /v1. Keep the full error for diagnosis.
Wrong model / settings ignoredCheck the main model and all three default model variables for conflicting values. Exit the old client and restart from the terminal where you set the variables.
Timeout / network errorCheck the local proxy and network, try the JP/SG backup URLs below, and see connection troubleshooting.

If the main domain is slow, change only ANTHROPIC_BASE_URL. Keep other values unchanged. The two official backup URLs are also root addresses without /v1:

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

Restart the client after switching and repeat verification. For troubleshooting, share error codes, times, and redacted logs, never the raw Key.