Windows 系统 Claude Code 配置阿里云百炼模型（官方文档版）

1. Windows 下 Claude Code 接入阿里云百炼到底卡在哪Claude Code 是 Anthropic 推出的命令行编程助手能在终端里直接读写文件、跑命令、改代码。它默认走 Anthropic 官方接口但很多国内开发者手里已经有阿里云百炼DashScope的 API Key想把 Claude Code 的请求切到百炼上省去额外申请账号的麻烦。问题在于Windows 的环境变量机制和 macOS/Linux 差别不小setx写进去的变量不会在当前窗口立刻生效settings.json的路径也容易放错位置结果就是终端里claude一跑要么报鉴权失败要么一直转圈连不上。这篇面向 Windows 用户聚焦 Claude Code 接入阿里云百炼的官方配置路径。核心就三件事用 CMD 的setx写永久环境变量、用settings.json补全配置骨架、用 CMD 做连通性验证。适合已经装好 Node.js、拿到百炼 API Key、但卡在“配了没反应”这一步的人。全程在 Windows 自带 CMD 里操作不需要额外装终端工具。需要说明的是百炼提供了兼容 Anthropic 协议的接入地址所以 Claude Code 只要把ANTHROPIC_BASE_URL指向百炼的对应端点再配上ANTHROPIC_API_KEY就能把请求发到百炼的模型上。下面按顺序走一遍每一步都给出可直接复制的命令和预期输出。2. 前置准备TaoToken 与百炼 Key 的获取在动手配环境变量之前先把两样东西准备好一个可用的百炼 API Key以及一个稳定的接入入口。如果你还没拿到百炼 Key去阿里云百炼控制台创建即可这里不展开注册流程。关于接入入口我平时会用 TaoToken 做统一管理它的 API 地址是https://taotoken.net/api控制台在https://taotoken.net/consoleAPI Key 管理页在https://taotoken.net/api-keys。它的好处是把多个模型的 Key 收在一处切换模型时不用来回翻控制台。模型对话入口在https://taotoken.net/model-chat接入文档在https://taotoken.net/doc需要长期跑编码任务或 Agent 的话可以看 Coding Planhttps://taotoken.net/coding-plan。这里要区分两个 Key一个是百炼自己的 DashScope API Key形如sk-开头的一长串另一个是你在 TaoToken 里管理的 Key。本篇演示的是 Claude Code 直连百炼的官方路径所以环境变量里填的是百炼的 Key。如果你走 TaoToken 中转把ANTHROPIC_BASE_URL换成 TaoToken 的地址、Key 换成 TaoToken 的 Key 即可后面的验证步骤完全一样。注意环境变量里不要带引号以外的空格setx会把整串当成值写进去多一个空格都会导致鉴权失败。3. 可复制配置CMD 环境变量 settings.json 骨架3.1 用 setx 写永久环境变量打开 CMDWinR 输入cmd回车执行下面两条命令。把YOUR_DASHSCOPE_API_KEY替换成你真实的百炼 Keysetx ANTHROPIC_API_KEY YOUR_DASHSCOPE_API_KEY setx ANTHROPIC_BASE_URL https://dashscope.aliyuncs.com/apps/anthropicsetx的作用是把变量写进用户级环境变量永久保存。但它有个坑不会影响当前已经打开的 CMD 窗口。所以执行完必须关掉这个窗口重新开一个新的变量才会被加载。很多人配完直接在当前窗口echo发现是空的就以为没配上其实是没重开窗口。3.2 验证环境变量是否生效新开一个 CMD执行echo %ANTHROPIC_API_KEY% echo %ANTHROPIC_BASE_URL%预期输出是你的 Key 和https://dashscope.aliyuncs.com/apps/anthropic。如果第一条输出%ANTHROPIC_API_KEY%原样带百分号说明变量没写进去回去检查setx是否报错比如权限不足。如果输出为空行多半是 Key 里带了特殊字符被截断。3.3 settings.json 配置骨架Claude Code 支持用settings.json做更细的控制比如指定模型、超时、代理等。Windows 下的路径是C:\Users\你的用户名\.claude\settings.json如果.claude目录不存在手动建一个。文件内容骨架如下{ env: { ANTHROPIC_API_KEY: YOUR_DASHSCOPE_API_KEY, ANTHROPIC_BASE_URL: https://dashscope.aliyuncs.com/apps/anthropic }, model: claude-sonnet-4-20250514, timeout: 60000 }几个参数说明字段作用建议值env.ANTHROPIC_API_KEY鉴权 Key你的百炼 Keyenv.ANTHROPIC_BASE_URL请求端点百炼 Anthropic 兼容地址model默认模型按百炼支持的模型名填timeout请求超时毫秒60000 起网络慢可加大提示settings.json里的env优先级高于系统环境变量。如果你两边都配了且不一致以settings.json为准。排查问题时先确认这里没写错。4. 验证请求CMD 里跑通第一次调用环境变量和配置文件都就位后新开一个 CMD直接输入claude第一次启动会做一些初始化然后进入交互界面。发一条测试请求比如写一段 Python 打印 Hello World 的代码如果配置正确模型会正常返回代码。返回内容里能看到 Python 代码块说明请求已经打到百炼的模型上了。想更直接地验证连通性可以用非交互模式跑一条命令claude -p 用一句话说明你是什么模型-p是 print 模式执行完直接输出结果并退出适合脚本化验证。如果这条命令能返回内容说明从 CMD 到百炼的整条链路是通的。实测下来第一次调用可能会慢几秒因为要建立连接。如果超过timeout还没返回会报超时错误这时候先把timeout调到 120000 再试。5. 本篇常见错排查5.1 报 401 鉴权失败最常见的原因是 Key 写错或没生效。按顺序查先echo %ANTHROPIC_API_KEY%确认变量值再打开settings.json确认env里的 Key 一致最后确认 Key 本身在百炼控制台是启用状态。三者任一不对都会 401。5.2 报连接超时或 DNS 解析失败先确认ANTHROPIC_BASE_URL拼写完全正确注意结尾没有多余的斜杠。然后在 CMD 里ping dashscope.aliyuncs.com看能否解析。如果公司网络有限制可能需要走内网出口这种情况联系网络管理员不要自行改动系统网络配置。5.3 setx 报“拒绝访问”说明当前 CMD 不是管理员权限或者变量名冲突。右键 CMD 选择“以管理员身份运行”再执行。如果还是不行改用系统属性里的“环境变量”图形界面手动添加效果一样。5.4 claude 命令找不到说明 Claude Code 没装好或没进 PATH。先node -v确认 Node.js 正常再npm list -g看有没有装 Claude Code。没装的话用npm install -g装一次装完重开 CMD。5.5 改了 settings.json 没反应Claude Code 启动时读一次配置改完要退出重进。另外确认文件是 UTF-8 无 BOM 编码Windows 记事本默认可能带 BOM导致 JSON 解析失败。用 VS Code 另存为 UTF-8 即可。6. 配好之后下一步怎么走环境变量和settings.json都配通之后Claude Code 在 Windows 上就算正式接上阿里云百炼了。日常用的时候如果只是临时切模型改settings.json里的model字段比重新setx快得多。如果你后面要长期跑编码任务或者搭 Agent建议把 Key 统一放到 TaoToken 管理接入文档在https://taotoken.net/docAPI Key 页在https://taotoken.net/api-keys需要模型对话测试就去https://taotoken.net/model-chat。长期编码场景可以看 Coding Planhttps://taotoken.net/coding-plan。这样换模型、换端点只改一处不用每次动系统环境变量。最后留一个我踩过的坑setx写的变量有长度限制超过 1024 字符会被截断。百炼的 Key 一般不会超但如果你用的是拼接出来的长 Key记得检查一下echo出来的值是不是完整的。