Claude Code 配置通义千问教程

通义千问是阿里巴巴的大语言模型，免费额度充裕，非常适合初学者使用。配置方法和 GLM 类似，整个过程大约 10-15 分钟。

第一步：注册阿里云账号

通义千问的 API 通过阿里云平台提供，所以先要有一个阿里云账号。

1. 打开浏览器，访问 aliyun.com
2. 点击右上角”免费注册”
3. 可以用手机号、邮箱或支付宝注册
4. 完成手机验证码验证

提示： 如果你已经有淘宝、支付宝账号，可以直接用支付宝扫码登录，不需要重新注册。

第二步：开通通义千问 API 服务

账号注册好之后，需要开通 AI 服务：

1. 登录阿里云控制台（console.aliyun.com）
2. 在搜索框里搜索”通义千问”或”百炼”
3. 点击进入”阿里云百炼”产品页
4. 点击”开通服务”（免费开通，不需要付费）
5. 同意服务协议，完成开通

开通后，新用户通常会获得免费额度，足够你体验使用。

第三步：获取 API Key

1. 进入阿里云百炼控制台（bailian.console.aliyun.com）
2. 点击左侧菜单”API Key 管理”
3. 点击”创建 API Key”
4. 给 Key 命名，比如”my-claude-code”
5. 复制生成的 API Key，保存到记事本

API Key 格式看起来像：

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

同样重要： 这个 Key 只显示一次，请务必复制保存好。

第四步：在 Claude Code 中配置

打开 Trae，配置 Claude Code 使用通义千问：

配置信息如下：

• Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1
• API Key：你刚才复制的 Key（sk-开头）
• Model（模型名称）：qwen-plus（推荐）

具体操作步骤：

1. 在 Claude Code 对话框里输入 /config 打开设置
2. 找到 API 相关配置项
3. 填入上面三项信息
4. 保存配置

或者通过设置文件：

{
  "apiBaseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  "apiKey": "sk-你的Key",
  "model": "qwen-plus"
}

第五步：测试是否成功

在 Claude Code 里发送：

你好，帮我写一句话介绍一下通义千问

收到回复说明配置成功。

通义千问可用的模型

模型名称	免费额度	特点
qwen-turbo	有	速度快，适合简单任务
qwen-plus	有	质量和速度平衡，推荐日常使用
qwen-max	少量免费	最高质量，适合重要任务
qwen-long	有	超长文档，最长 100 万字

推荐新手使用 qwen-plus：质量好、速度快、有免费额度。

通义千问的特色：超长文档

通义千问有一个特别强大的功能：处理超长文档。

qwen-long 模型最多可以一次性处理约 100 万个汉字（约 1 百万 token）的文档，这相当于几十本小说的长度。

对于需要处理长报告、法律文件、书籍内容的用户来说，这个能力非常有价值。

查看使用情况和余额

1. 登录阿里云百炼控制台
2. 点击”用量统计”查看已用量
3. 点击”账单”查看费用情况
4. 可以设置消费提醒，避免超出预算

常见问题

Q：开通阿里云需要实名认证吗？ A：是的，需要完成实名认证才能使用 API 服务。认证过程需要上传身份证，通常几分钟内完成。

Q：免费额度用完后多少钱？ A：qwen-plus 的价格大约是每百万 token 约 4 元人民币。对于日常工作，几十块钱可以用很长时间。

Q：通义千问和 GLM 质量差不多吗？ A：两者质量都很好，各有优势。通义千问在长文本和逻辑推理上稍强，GLM 在某些中文写作场景上稍好。建议都注册，根据任务选择。

Q：可以用企业账号申请吗？ A：可以。阿里云支持企业账号注册，企业客户还有更大的免费额度和优惠。

Q：配置之后，Claude Code 对话框的样子会变化吗？ A：不会变。界面完全一样，只是背后使用的 AI 模型从 Claude 变成了通义千问。

---

现在你已经学会了配置两种国内大模型。下一节，我们来学习 AICodeSwitch 工具，它可以让你在多个模型之间一键切换，非常方便。