---
title: "Claude Code 配置通义千问教程"
description: "从阿里云账号到百炼控制台，开服务、建密钥、填接入地址与模型名，再用一句测试话确认链路打通。附长文档任务的分段策略。"
updated: 2026-11-13
canonical: https://docai.cc/learn/connect-qwen-to-claude-code/
markdown_mirror: https://docai.cc/learn/connect-qwen-to-claude-code.md
---
## 和上一节的区别只在入口

同样是接一个国内模型，同样是填三项：地址、密钥、模型标识。上一节的入口是智谱的开放平台，这一节的入口是阿里云的百炼。流程多了一步「开通服务」，因为模型挂在云平台上，账号和服务是分开的。

如果你已经配过 GLM，这一节对你来说就是换三个值的事。如果你还没配过，按下面的顺序走一遍，第一次大约十几分钟。

## 从账号到密钥

打开阿里云官网注册。手机号、邮箱都能走，如果你本来就有淘宝或支付宝账号，扫码登录更快，实名信息通常也能带过来。

注意区分两件事：注册账号和实名认证。账号建好就能登录，但调用模型服务一般要求完成实名。个人认证要身份证，企业认证要营业执照。认证没做完时，控制台里不少按钮是灰的，不是浏览器的问题。

进入阿里云控制台后，在搜索框里找「百炼」或「通义千问」，打开产品页，点开通。开通本身通常不收费，费用产生在你实际调用之后。

开通后先别急着建密钥，去模型列表看一眼：哪些模型对你的账号开放、各自的上下文长度、计费档位。这一页的信息比任何教程都准，因为它跟着你的账号状态走。

进入百炼控制台，左侧找 API Key 管理，创建一枚。名字写清用途，比如「claude-code-办公电脑」。

密钥只完整显示一次，创建后立刻复制。存放位置建议是密码管理器，差一点的选择是本机一个不进版本库的配置文件。别放在桌面新建的 txt 里，也别贴进聊天窗口让任何人帮你「看看对不对」。密钥的管理原则见[API Key 是什么](/concepts/api-key/)。

## 填三项配置

| 配置项 | 该填什么 | 注意 |
|---|---|---|
| 接口地址 | 平台文档里的接入地址 | 末尾不要自己加路径 |
| 密钥 | 刚复制的那串 | 不带引号、不带前缀 |
| 模型标识 | 模型列表里的字符串 | 别用宣传名 |

平台文档里常见的地址是 `https://dashscope.aliyuncs.com/compatible-mode/v1`，常用模型标识有 `qwen-plus`、`qwen-turbo`、`qwen-max`、`qwen-long` 这几种。这些值会随平台调整，填之前以控制台当前文档为准。还要注意协议：`compatible-mode` 是给 OpenAI 兼容客户端用的，Claude Code 认的是 Anthropic 形状的接口；平台若为 Claude Code 单独提供了接入地址，就填那个，两者不要混用。

地址为什么长这样，值得多看一眼：`compatible-mode` 说明它是给 OpenAI 兼容协议准备的入口，`v1` 是版本段。少写一段就变成 404，多写一段具体路径又会和客户端自己拼的路径撞车。这类问题的通用解法见[base_url 怎么填](/concepts/base-url/)。

如果客户端要求用环境变量，把三项分别写进对应的变量名，重启客户端再试。写进配置文件的好处是换项目不用重填；坏处是容易跟着项目一起被提交，所以配置文件要进忽略名单。

## 验证与排查

第一句测试要短：

> 你好，请用一句话说明你是什么模型。

回复正常，说明地址、密钥、模型名三样同时对上了。这时再看一眼客户端状态栏显示的模型，确认不是你之前配的另一个。

第二句加一点真实任务：

> 读当前打开的文件，用三行概括它讲了什么，再列两个你可能不确定的地方。

第二句验证的是工具调用还通不通。有些兼容层能聊天但读不了文件，这一句会把问题暴露出来。

## 长文档：它的强项，也是最容易踩的坑

通义千问系列里有专门面向长文本的档位，能一次吃下很长的材料。这是它相对好用的地方，但「能发」不等于「该发」。

三个判断：

- **先看长度。** 文档超过上下文上限时可能直接报错，也可能被截断；被截断时后半段它根本没看到，却不一定提醒你。
- **再看费用。** 输入越长，单次成本越高。一份几百页的材料反复问十遍，账单会很难看。计费按 token 走，换算关系见[token 是什么](/concepts/token/)。
- **看任务类型。** 要通读找矛盾，整篇发；只要某一章的内容，先切出来再发，准确率反而更高。

分段时保留一点重叠：上一段结尾的几行也放进下一段，避免结论被切断在边界上。每段让模型输出结构化的小结，最后再用一份小结汇总，比让它一次读完全文更稳。

## 出问题时的顺序

先分清是「连不上」还是「答得不好」。连不上看状态码：401 查密钥，404 查地址，429 查频率和额度。答得不好则跟配置无关，是提示词和任务拆分的问题。

还有一类常被忽略：服务开通、密钥也对，但账号欠费或额度耗尽，表现同样是拒绝服务。去用量页看一眼就知道。

把地址、密钥、模型名三样对齐，再用一句短话验证，接模型这件事就没有神秘感了。想随时在两家之间切换、不必每次改配置，下一节讲一个专门管切换的工具：[AICodeSwitch 一键切换模型](/learn/aicodeswitch-model-switching/)。