模型指南入门读者更新于

通义千问 Qwen 如何通过 Claude Code 接入?

在 Claude Code 中设置 I Code Easy API Key、根地址 https://api.icodeeasy.cc,并把模型设为 qwen3.8-max,即可通过本站使用 Qwen。需要 Flash 时可改为 qwen3.8-flash;下文说明配置、验证与常见错误。

开始前准备

  1. 先按 Claude Code 安装指南安装客户端;本页介绍的是 Claude Code,不是 Qwen Code 的安装或登录流程。
  2. 注册账号后,在 API Keys复制本站 Key。这里不使用阿里云官方 Key 或官方 Coding Plan 订阅。
  3. 到接入点选择确认并选择 Qwen3.8-Max / Flash,在价格页核对当前价格。可用范围以账号当前页面为准。
  4. Key 只保存在自己的本地配置中,不放进仓库、截图、聊天或工单。

模型名与别名配置

Qwen 是模型,Claude Code 是客户端。客户端使用 Haiku、Sonnet 或 Opus 别名时,也要把它们映射到相同的 Qwen 模型,避免沿用之前的 Claude 或 Kimi 设置。

用途配置值
推荐模型qwen3.8-max
可选模型qwen3.8-flash
鉴权变量ANTHROPIC_AUTH_TOKEN,填本站 API Key
接入地址ANTHROPIC_BASE_URL=https://api.icodeeasy.cc,不加 /v1

切换 Flash 时,把 ANTHROPIC_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL 四个值一起改为 qwen3.8-flash,然后重启 Claude Code。模型名须完整一致,不要自行拼接版本或后缀。

macOS / Linux 配置

在准备启动 Claude Code 的终端执行以下配置,将占位文本替换为本站 Key。这些值先对当前终端会话生效:

export ANTHROPIC_AUTH_TOKEN="你的 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"

需要持久化时,将同一组 export 写入所用 shell 的启动文件:zsh 用 ~/.zshrc,bash 用 ~/.bashrc。保存后重新打开终端,或仅运行与你的 shell 对应的一行:

source ~/.zshrc
source ~/.bashrc

Windows PowerShell 配置

当前 PowerShell 会话使用以下配置:

$env:ANTHROPIC_AUTH_TOKEN = "你的 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"

如需用户级持久化,在已完成上述配置的同一窗口运行以下代码,保存这七个变量:

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

保存后重新打开 PowerShell;使用 VS Code 等集成终端时,也重启宿主应用。旧的 Claude Code 进程不会自动读入新环境。更多终端配置说明见 Claude Code 指南。

验证配置与首个请求

先检查客户端版本。下面命令只输出版本,不发送模型请求:

claude --version

检查 Key 是否存在时只输出布尔值,不打印 Key 原文:

macOS / Linux:

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

PowerShell:

[bool]$env:ANTHROPIC_AUTH_TOKEN

从配置好的终端运行 claude,在客户端输入 /status 检查模型与连接信息。界面上的 Claude Code 名称或 Haiku、Sonnet、Opus 别名不能单独证明请求使用了哪一个模型。

然后由你在 Claude Code 中发送一句“只回复 OK”。这会发起真实请求并按当前规则计费。在请求日志核对成功状态、记录的模型与费用;不要只看回答中模型自称的名称。

常见问题与排错

现象检查方向
401 / 鉴权失败确认使用本站 Key、没有多余空格、未因轮换失效,且 Key 与接入地址属于同一服务。
403 / 无权限检查账号状态、接入点选择与当前模型访问范围;向支持提供错误文字和时间,不附 Key。
429 / 请求受限阅读完整错误和控制台状态,降低并发后稍后重试;不要直接认定为余额不足。
404 / 模型或路径错误核对模型为 qwen3.8-max 或 qwen3.8-flash,BASE_URL 是根地址且不含 /v1;记录完整错误再排查。
模型不对 / 配置未生效检查主模型及三个默认模型变量,清理冲突配置;退出旧客户端,从设置变量的同一终端重启。
超时 / 网络错误检查本地代理和网络,尝试下方 JP/SG 备域名,并参阅连接排查。

主域名连接慢时,只替换 ANTHROPIC_BASE_URL,其他值不变。两个官方备域名同样填写根地址,不加 /v1:

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

切换后重启客户端并重新验证。排错时仅分享错误码、发生时间和脱敏日志,不提供 Key 原文。

相关指南与官方参考