Claude Code 配置通义千问教程

和上一节的区别只在入口

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

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

从账号到密钥

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

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

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

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

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

密钥只完整显示一次，创建后立刻复制。存放位置建议是密码管理器，差一点的选择是本机一个不进版本库的配置文件。别放在桌面新建的 txt 里，也别贴进聊天窗口让任何人帮你「看看对不对」。密钥的管理原则见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 怎么填。

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

验证与排查

第一句测试要短：

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

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

第二句加一点真实任务：

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

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

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

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

三个判断：

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

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

出问题时的顺序

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

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

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