Claude Code

更新时间: 2025-08-14 19:53:27

在 Claude Code 中使用百炼提供的 qwen3-coder-plus 模型,只需配置以下两个环境变量:

  • ANTHROPIC_BASE_URL:设置为https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy

  • ANTHROPIC_AUTH_TOKEN:设置为阿里云百炼API Key

当前仅支持 qwen3-coder-plus,无法通过ANTHROPIC_MODEL环境变量修改调用模型。

效果展示

在 Claude Code 中使用 qwen3-coder-plus。

image (2)

快速开始

开通阿里云百炼并获取免费额度

如果您是首次访问阿里云百炼服务平台,请按照以下步骤进行开通。

  1. 登录阿里云百炼大模型服务平台

  2. 若页面顶部显示image,需开通阿里云百炼的模型服务,并获得免费额度。如果未显示该消息,则表示您已经开通。

首次开通百炼后,您可领取新人免费额度(有效期:30 至 180 天),用于模型推理服务。超出额度或期限将产生费用(开启免费额度用完即停功能将避免此情况下产生费用),具体费用请以控制台的实际报价和最终账单为准。免费额度领取方法和详情,请查看新人免费额度页面。
Claude Code 无法使用Qwen Code 每日 2000 次免费额度

支持的模型

当前仅支持 qwen3-coder-plus模型。

安装及配置 Claude Code

macOS

  1. 在终端中执行下列命令,安装 Claude Code。

    如果安装过程出现错误,请参考Claude Code官方文档
    npm install -g @anthropic-ai/claude-code
  2. 将阿里云百炼提供的 Base URL 和 API Key 设置为环境变量。首先在终端中执行以下命令,查看默认 Shell 类型。

    echo $SHELL
  3. 根据 Shell 类型设置环境变量,命令如下:

    Zsh

    # 用您的百炼API KEY代替YOUR_DASHSCOPE_API_KEY
    echo 'export ANTHROPIC_BASE_URL="https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy"' >> ~/.zshrc
    echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_DASHSCOPE_API_KEY"' >> ~/.zshrc

    Bash

    # 用您的百炼API Key代替YOUR_DASHSCOPE_API_KEY
    echo 'export ANTHROPIC_BASE_URL="https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy"' >> ~/.bash_profile
    echo "export ANTHROPIC_AUTH_TOKEN='YOUR_DASHSCOPE_API_KEY'" >> ~/.bash_profile
  4. 在终端中执行下列命令,使环境变量生效。

    Zsh

    source ~/.zshrc

    Bash

    source ~/.bash_profile
  5. 打开一个新的终端,执行下列命令,查看环境变量是否生效。

    echo $ANTHROPIC_BASE_URL
    echo $ANTHROPIC_AUTH_TOKEN

Windows

  1. Claude Code 默认只支持macOS和Linux,如果您想在Windows上使用的话,请首先安装WSL或Git for Windows,然后在WSL或Git Bash中执行以下命令。

    npm install -g @anthropic-ai/claude-code
您可以参考Claude Code官方文档的Windows安装教程
  1. 在Windows中,你可以通过CMD或PowerShell将阿里云百炼提供的Base URL和API Key设置为环境变量。

    CMD

    1. 在CMD中运行以下命令,设置环境变量。

      # 用您的百炼API Key代替YOUR_DASHSCOPE_API_KEY
      setx ANTHROPIC_AUTH_TOKEN "YOUR_DASHSCOPE_API_KEY"
      setx ANTHROPIC_BASE_URL "https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy"
    2. 打开一个新的CMD窗口,运行以下命令,检查环境变量是否生效。

      echo %ANTHROPIC_AUTH_TOKEN%
      echo %ANTHROPIC_BASE_URL%

    PowerShell

    1. 在PowerShell中运行以下命令,设置环境变量。

      # 用您的百炼API Key代替YOUR_DASHSCOPE_API_KEY
      [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_DASHSCOPE_API_KEY", [EnvironmentVariableTarget]::User)
      [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy", [EnvironmentVariableTarget]::User)
    2. 打开一个新的PowerShell窗口,运行以下命令,检查环境变量是否生效。

      echo $env:ANTHROPIC_AUTH_TOKEN
      echo $env:ANTHROPIC_BASE_URL

运行Claude Code

  1. 在终端中执行以下命令,运行 Claude Code。

    claude

    效果如下图所示。

    image

  2. 在对话框中输入以下内容,测试 Claude Code。

    如何用python判断质数?

    效果如下图所示。

    如果执行报错,请参见错误信息。

    image

进阶操作

更多 Claude Code 的进阶功能或其他通义千问系列代码模型,可以参考 Claude Code 官方文档及阿里云百炼模型列表

常见问题

为什么显示的模型名称不是 qwen3-coder-plus?

Claude Code 界面仅会显示其默认的模型名称( 如 Claude-3-5-haiku 等),而非实际调用的 qwen3-coder-plus,这属于正常现象,可以直接忽略。如果想进一步确认,可以在阿里云百炼的模型观测中查询是否有 qwen3-coder-plus 的调用记录。

Token 如何计费?

  1. qwen3-coder-plus 根据本次请求输入的 Token 数,采取阶梯计费,详情参见模型列表与价格

  2. qwen3-coder-plus 支持上下文缓存功能,命中缓存的输入 Token 按原价的 40% 计费,详情参见上下文缓存

  3. qwen3-coder-plus 模型将于 2025 年 7 月 23 日 20:00 起开启限时折扣,最高可享 5 折优惠,详情参见 qwen3-coder-plus 限时优惠

如何监控 Token 消耗?

使用 Claude Code 内置命令查询 Token 用量

  1. 在 Claude Code 的对话框中执行/cost命令。

    image

  2. 系统将显示已使用的 Token 数量及费用。

    image

使用 Ccusage 工具查询 Token 用量

/cost只能查看当前会话的消耗,推荐您使用 Ccusage 工具来获取更详细的 Token 消耗信息。

  1. 在终端执行以下命令以安装 Ccusage。

    npm install -g ccusage
  2. 安装完成后,在终端执行ccusage命令来查看每天的 Token 使用情况及费用。

    image

  3. 您也可以尝试 Ccusage 的其他常用指令

    Ccusage常用指令

    # 基本用法
    ccusage           # 显示每日报告(默认)
    ccusage daily     # 每日Token用量与费用
    ccusage monthly   # 月度报告
    ccusage session   # 按会话统计用量
    ccusage blocks    # 5小时计费窗口
    
    # 实时监控
    ccusage blocks --live  # 实时用量仪表盘
    
    # 筛选与选项
    ccusage daily --since 20250525 --until 20250530  # 指定时间段用量报告
    ccusage daily --json  # 输出 JSON 格式
    ccusage daily --breakdown  # 各模型成本明细
    
    # 项目分析
    ccusage daily --instances  # 按项目/实例分组
    ccusage daily --project myproject  # 筛选特定项目
    ccusage daily --instances --project myproject --json  # 组合用法

如何节省 Token?

  1. 减少无关文件:为避免扫描不相关文件而造成 Token 消耗,建议在具体的项目目录中启动 Claude Code,同时仅保留必要的项目文件。

  2. 总结对话:Claude Code 会将历史对话内容作为上下文,当对话长度达到上下文窗口的 95% 时,Claude Code 会自动地总结对话内容。也可以通过执行/compact命令来手动地总结对话内容。

    image

  3. 精确指令:模糊的请求会触发非必要的文件扫描,消耗更多的 Token。请在使用 Claude Code 时提出更明确、具体的问题或指令。

  4. 分解任务:在处理复杂任务时,可以将其分解为若干简单任务。

  5. 重置上下文:在开启一个全新的任务之前,使用/clear命令重置上下文,避免无关信息消耗 Token。

    image

您可以参考 Claude Code 官方文档了解更多节省 Token 的技巧。

为什么报 API Error: 403 App access denied 错误?

您可能使用了子业务空间的API Key,目前 Claude Code 只支持默认业务空间的API Key。请前往阿里云百炼大模型服务平台,单击顶部模型,确保左侧导航栏中为默认业务空间,单击密钥管理,将环境变量 ANTHROPIC_AUTH_TOKEN 替换为默认业务空间的 API Key  。

能否修改模型?

当前仅支持 qwen3-coder-plus 模型,无法修改。

上一篇: Chatbox 下一篇: 用户指南(应用)