Claude Code 接入阿里千问 Qwen3：环境变量与 settings.json 配置实战

1. 为什么 Claude Code 默认模型跑不起来Claude Code 是 Anthropic 官方出的命令行编码助手装完之后默认连的是 Claude Sonnet 系列模型。问题在于很多国内开发者在本地直接claude启动时会发现它连不上——不是网络配置的问题而是默认的模型端点根本不在你能访问的范围内。你敲下回车它转两圈就报连接超时或者 401整个工具等于废了。这时候最直接的思路就是把 Claude Code 背后调用的模型换掉让它走一个你能正常访问、而且兼容 Anthropic 接口协议的服务。阿里千问 Qwen3 系列里的qwen3-coder-plus就是专门为编码场景优化的模型支持 Anthropic 兼容接口正好能接进 Claude Code。我试过几种替换方案早期有人靠改端口转发但随着 Claude Code 版本更新那套办法已经失效了。现在稳定可用的方式是通过环境变量和settings.json两个入口来覆盖默认配置。这篇文章就把这两条路径都拆开讲清楚环境变量怎么设、settings.json 骨架怎么写、配完之后怎么验证调用真的生效了、以及最常见的几个报错怎么排。适合谁看已经在本地装好 Claude Code、但卡在“连不上默认模型”这一步的开发者或者想把编码助手切到 Qwen3 系列、又不想折腾复杂网关的人。跟着做十分钟内能让claude正常跑起来。2. 接入前的前置准备密钥与 TaoToken 入口在动配置文件之前你得先有一个能用的 API Key。这里分两种情况说。如果你直接用阿里云百炼DashScope的密钥去阿里云控制台的密钥管理页面新建一个就行拿到一串sk-开头的 key。这个 key 对应的是https://dashscope.aliyuncs.com/apps/anthropic这个 Anthropic 兼容端点。如果你希望统一管理多个模型的密钥、或者想要一个更稳定的调用入口可以用 TaoToken 来做中转层。TaoToken 的 API 地址是https://taotoken.net/api它兼容 Anthropic 的消息协议Claude Code 可以直接把 base URL 指过去。官网在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册后在控制台里生成 API Key。不管走哪条路你最终需要手里握着三样东西一个Base URLAnthropic 兼容端点地址一个Auth Token也就是你的 API Key一个模型名比如qwen3-coder-plus这三样东西接下来会分别填进环境变量和 settings.json。先把它们记在记事本里别到配置的时候再回头找。注意API Key 属于敏感凭证不要直接提交到 Git 仓库也不要在公开截图里暴露完整字符串。后面讲 settings.json 时会说怎么用环境变量引用它。3. 可复制配置环境变量与 settings.json 双路径Claude Code 读取配置的优先级是环境变量 settings.json 默认值。所以你可以只用环境变量也可以只用 settings.json或者两者配合。我建议两条都配上环境变量做兜底settings.json 做精细控制。3.1 环境变量清单Windows / macOS / Linux需要设置的核心变量有三个变量名作用示例值ANTHROPIC_BASE_URL覆盖默认 API 端点https://dashscope.aliyuncs.com/apps/anthropicANTHROPIC_AUTH_TOKEN鉴权令牌你的 API KeyANTHROPIC_MODEL指定调用的模型qwen3-coder-plusWindows 下用 PowerShell 设置当前会话生效$env:ANTHROPIC_BASE_URL https://dashscope.aliyuncs.com/apps/anthropic $env:ANTHROPIC_AUTH_TOKEN sk-你的密钥 $env:ANTHROPIC_MODEL qwen3-coder-plus如果想永久生效用系统环境变量界面添加或者[Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, https://dashscope.aliyuncs.com/apps/anthropic, User) [Environment]::SetEnvironmentVariable(ANTHROPIC_AUTH_TOKEN, sk-你的密钥, User) [Environment]::SetEnvironmentVariable(ANTHROPIC_MODEL, qwen3-coder-plus, User)macOS / Linux 下写进~/.zshrc或~/.bashrcexport ANTHROPIC_BASE_URLhttps://dashscope.aliyuncs.com/apps/anthropic export ANTHROPIC_AUTH_TOKENsk-你的密钥 export ANTHROPIC_MODELqwen3-coder-plus改完记得source ~/.zshrc让配置生效。3.2 settings.json 骨架配置Claude Code 会在项目根目录或用户目录下读取settings.json。用户级配置一般放在~/.claude/settings.jsonWindows 是C:\Users\你的用户名\.claude\settings.json。一个可复制的最小骨架{ env: { ANTHROPIC_BASE_URL: https://dashscope.aliyuncs.com/apps/anthropic, ANTHROPIC_AUTH_TOKEN: sk-你的密钥, ANTHROPIC_MODEL: qwen3-coder-plus } }如果你用 TaoToken 作为入口把ANTHROPIC_BASE_URL换成https://taotoken.net/apiANTHROPIC_AUTH_TOKEN换成 TaoToken 控制台生成的 key模型名保持qwen3-coder-plus即可。settings.json 里还可以加一些控制项比如关闭遥测、指定权限模式{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的密钥, ANTHROPIC_MODEL: qwen3-coder-plus }, permissions: { allow: [] }, telemetry: false }提示settings.json 里的env字段会在 Claude Code 启动时注入进程环境优先级高于系统环境变量。如果你发现改了系统变量没生效检查一下是不是 settings.json 里写死了旧值。4. 验证请求确认 Qwen3 真的被调用了配置写完不代表生效必须验证。最直接的方式是启动 Claude Code 后发一条消息看它返回的内容和模型标识。第一步打开终端确认环境变量已经加载echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_MODELWindows PowerShell 用echo $env:ANTHROPIC_BASE_URL。第二步直接启动claude如果配置正确你会看到 Claude Code 正常进入交互界面不再报连接错误。这时候输入一句测试用一句话解释什么是快速排序如果返回的是 Qwen3 生成的回答说明调用链已经通了。第三步想更精确地确认模型身份可以用 curl 直接打端点curl -X POST $ANTHROPIC_BASE_URL/v1/messages \ -H x-api-key: $ANTHROPIC_AUTH_TOKEN \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: qwen3-coder-plus, max_tokens: 100, messages: [{role: user, content: 回复 OK 两个字母}] }正常返回会是一段 JSON里面content字段有模型输出。如果返回 401说明 key 不对返回 404说明 base URL 路径写错了返回 400 且提示 model 不存在说明模型名拼错了。实测下来qwen3-coder-plus在代码补全和解释场景响应很快Claude Code 里的文件读写、命令执行这些工具调用也能正常触发。5. 本篇常见报错排查配置过程中最容易踩的坑集中在下面几类对照着查基本能解决。报错一401 Unauthorized或invalid api key原因通常是ANTHROPIC_AUTH_TOKEN没设对或者 settings.json 里写的是占位符没替换。检查两点key 有没有多余空格环境变量和 settings.json 是不是同时存在且值冲突。Claude Code 优先读 settings.json 的env如果你系统变量改了但文件里还是旧 key就会一直 401。报错二Connection error或ECONNREFUSEDbase URL 写错了。注意 Anthropic 兼容端点的路径通常带/apps/anthropic或/api后缀不能只写到域名。另外确认你的网络能正常访问该地址可以用curl -I $ANTHROPIC_BASE_URL看返回状态码。报错三model not found或invalid model模型名拼写问题。Qwen3 系列在百炼上的编码模型标识是qwen3-coder-plus不要写成qwen3-coder或Qwen3-Coder-Plus大小写和连字符都要一致。如果你不确定当前端点支持哪些模型去对应控制台的模型列表页确认。报错四改了配置但 Claude Code 还是走默认模型两种情况一是 settings.json 放错了目录Claude Code 只读~/.claude/settings.json和项目根目录的.claude/settings.json二是环境变量在启动 Claude Code 的终端里没生效比如你在 A 终端设了变量却在 B 终端启动。用claude --version确认版本新版对配置路径的要求更严格。报错五JSON 格式错误导致启动失败settings.json 里多一个逗号、少一个引号都会让解析失败。用编辑器的 JSON 校验功能检查或者python -m json.tool settings.json验证格式。如果排查完还是不通优先去 API Keys 页面重新生成一个 key排除密钥本身失效的可能。接入文档里有各端点的完整参数说明对照着核对 base URL 和模型名。6. 后续怎么用模型对话、Coding Plan 与密钥管理配置通了之后日常使用就顺了。如果你只是想验证 Qwen3 的回答质量可以直接在模型对话页面里试不同 prompt对比qwen3-coder-plus和其他模型的输出差异找到最适合你编码习惯的那个。如果你打算长期用 Claude Code 做项目开发、跑 Agent 任务建议走 Coding Plan 这条线。它针对编码场景做了额度和并发优化比按量计费更适合高频调用。密钥管理统一在 API Keys 页面做可以给不同项目分配不同 key方便追踪用量和随时吊销。接入文档里有完整的端点列表、参数说明和错误码对照遇到本篇没覆盖的报错可以直接查。配置这件事一次配好后面就是纯用工具了把时间花在写代码上比反复调环境划算得多。