近期Claude Code的封号现象较多，许多中转平台也无法使用。于是有人在问，
Claude Code 能不能直接接阿里云的 Coding Plan，用国内大模型来干活？
答案是：
可以，而且目前阿里云官方已经给出了 Claude Code 的接入文档。
它本质上是通过 Anthropic 兼容接口，把 Claude Code 连到阿里云 Coding Plan 上，再由阿里云去调度对应的大模型。阿里云文档里已经明确写了 Claude Code 的安装方式、连接配置、模型切换方式，以及专用的 Base URL 和 API Key 规则。
但这里有必要告知大家，它实则是用固定月费，把 Claude Code 的工作流接到阿里云模型池上，做到低成本甚至接近免费的使用体验。
由于阿里云 Coding Plan 是按月订阅的，不是零成本免费服务。官方目前明确把它定义为面向 AI coding tools 的固定套餐。
许多人真正想要的，实则不是“绝对免费”，而是这三件事：
第一，Claude Code 能正常用。
第二，不用官方高价额度。
第三，能切到国内一批可用的大模型。
这篇文章，我就不讲空话，直接带你从 0 到 1 配好。
一、先搞清楚：你到底在连什么？
阿里云 Coding Plan，本质上是一个给 AI 编程工具使用的专用模型套餐。
官方文档明确写了，它支持给 Claude Code 这类工具使用，而且提供的是 Anthropic-compatible 的接入方式。对应的 Anthropic 兼容地址是：
同时，它要求你必须使用 Coding Plan 专属 API Key，格式是 sk-sp-xxxxx。如果你误用了普通百炼 API Key，额度不会按 Coding Plan 走，甚至会出现“为什么我明明买了套餐还在扣费”的情况。
阿里云目前给 Coding Plan 推荐的模型包括Qwen3系列旗舰模型，还包括DeepSeek、Kimi、GLM、MiniMax等第三方模型。
所以你可以把这套方案理解成一句话：
Claude Code 负责“工作流和终端智能体体验”，阿里云 Coding Plan 负责“模型后端和额度”。
二、准备工作：先确认你缺什么
想跑起来，最少需要 4 样东西：
- 阿里云账号
- 已订阅 Coding Plan
- Node.js 18 及以上
- Claude Code 已安装
阿里云官方文档写得很清楚：
Claude Code 安装前提是 Node.js v18.0 或更高版本。
三、第一步：去阿里云开通 Coding Plan
先去阿里云 Model Studio 的 Coding Plan 页面，订阅对应套餐。
这里大家要注意下⚠️：官方文档显示，Coding Plan 是固定月费订阅，并且是不可退款的。
另外还有两个很关键的限制，许多人会踩坑：
1. Coding Plan 只能用于编程工具。
阿里云 FAQ 明确说了，它只适用于 Claude Code、Qwen Code 这类 AI 编程工具，不支持拿去用 curl、Postman、Dify、自定义后端或非交互式批量调用。否则可能被判定为滥用。
2. 必定要拿到 Coding Plan 专属 Key。
你要找的是 sk-sp-xxxxx 这种格式，不是普通 sk-xxxxx。
四、第二步：拿到专属 API Key 和 Base URL
这一步最关键。
根据阿里云官方文档，Coding Plan 接 Claude Code 时，需要这两个值：
API Key： sk-sp-xxxxx
Base URL： 填写对应的地址
你后面所有配置，核心实则就围绕这两个参数展开。
五、第三步：安装 Claude Code
macOS / Linux
执行：
npm install -g @anthropic-ai/claude-code
claude --versionWindows
阿里云文档写的是：
Windows 下提议先装 WSL 或 Git for Windows，然后在 WSL 或 Git Bash 里执行：
npm install -g @anthropic-ai/claude-code
claude --version这一步成功后，你的本机就具备运行 Claude Code 的基础环境了。
六、第四步：真正开始连接阿里云
这里给你最稳的方式：直接改 Claude Code 的 settings.json。
由于这是 Anthropic 官方文档也认可的正式配置机制。Claude Code 的用户级配置文件是 ~/.claude/settings.json。
方案一：macOS / Linux
先创建目录并打开配置文件：
mkdir -p ~/.claude
nano ~/.claude/settings.json把下面这段内容粘进去，把 YOUR_API_KEY 换成你自己的 sk-sp-xxxxx：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.5-plus"
}
}保存后，再创建或编辑 ~/.claude.json：
nano ~/.claude.json填入：
{
"hasCompletedOnboarding": true
}这一步别省。
由于阿里云官方文档专门提到：如果没把 hasCompletedOnboarding 设成顶层字段 true，Claude Code 启动时可能报错：
Unable to connect to Anthropic services。
方案二：Windows
先创建文件夹和配置文件。
CMD：
if not exist "%USERPROFILE%.claude" mkdir "%USERPROFILE%.claude"
notepad "%USERPROFILE%.claudesettings.json"PowerShell：
mkdir -Force $HOME.claude
notepad $HOME.claudesettings.json写入同样内容：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.5-plus"
}
}然后创建或编辑：
C:Users你的用户名.claude.json
填入：
{
"hasCompletedOnboarding": true
}这些步骤，阿里云官方文档都已经给出了。
七、第五步：启动 Claude Code
进入你的项目目录，列如：
cd path/to/your_project
claude第一次进入后，Claude Code 会要求文件执行权限之类的授权，按提示通过即可。
启动成功后，直接输入：
/status如果你能看到当前的 model、Base URL、API key 配置状态，就说明你已经连通成功了。阿里云官方文档把 /status 明确列为检查配置是否正确的命令。
八、第六步：切换国内不同模型
许多人接上后来，只会用一个默认模型，这就有点浪费了。
阿里云官方给出的 Claude Code 模型切换方式有两种：
启动时切换
claude --model qwen3-coder-next会话中切换
/model qwen3-coder-next也就是说，你完全可以根据任务换模型。
我给你一个最实用的提议：
写代码、改项目：
优先试 qwen3-coder-next 或 qwen3-coder-plus。这两个本身就是偏 coding agent 能力的模型。阿里云模型页对 Qwen-Coder 的描述就是：更擅长工具调用、环境交互和自主编程任务。
看长文档、长上下文：
试 kimi-k2.5。
想要稳定一点的通用推理：
试 glm-5。
想要再试试别的响应风格：
试 MiniMax-M2.5。
九、第七步：最常用的 6 个命令，先记住
阿里云文档里专门列出了 Claude Code 的常用命令，最值得你先记住的是这几个：
/status看当前配置是否生效。
/model 模型名切换模型。
/init生成 CLAUDE.md，给项目补充上下文说明。
/plan进入规划模式，先分析方案，不直接改代码。
/clear清空对话上下文，避免旧上下文干扰。
/compact压缩上下文，节省上下文窗口。
如果你是第一次用 Claude Code，我真提议你把 /plan 和 /status 先用熟。
前者让你别一上来就让模型乱改文件，后者能快速判断到底是 Key 配错了，还是 Base URL 配错了。
十、最容易翻车的 5 个坑
坑 1：把普通百炼 API Key 当成 Coding Plan Key 用
必定要确认是 sk-sp-xxxxx。
不是这个前缀，大致率就不是 Coding Plan 专属 Key。
坑 2：Base URL 写错
Claude Code 接阿里云时，用的是 Anthropic 兼容地址：
https://coding-intl.dashscope.aliyuncs.com/apps/anthropic别写成普通百炼接口，也别写成 OpenAI 兼容地址。
坑 3：没写 .claude.json
如果启动时报 Unable to connect to Anthropic services，优先检查：
{
"hasCompletedOnboarding": true
}是不是写了，而且是不是顶层字段。
坑 4：想把套餐拿去跑脚本
阿里云 FAQ 已经说得很清楚：Coding Plan 不是给你拿去做自动化脚本后端批量调用的。
它定位就是 AI 编程工具。
坑 5：重点强调的还是收费的问题
这条我还是得提醒一句：
它是固定月费、低成本、高性价比，不是纯免费。
十一、给新手一个能直接抄的最小可用配置
如果你懒得折腾，直接照着下面抄。
~/.claude/settings.json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-sp-替换成你自己的key",
"ANTHROPIC_BASE_URL": "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.5-plus"
}
}~/.claude.json
{
"hasCompletedOnboarding": true
}启动
cd 你的项目目录
claude检查
/status切模型
/model qwen3-coder-next
/model kimi-k2.5
/model glm-5
/model MiniMax-M2.5这些模型都在阿里云 Coding Plan 的支持范围里。
十二、最后说一句：这套方案真正值钱的，不只是省钱
许多人看这个教程，只看到是不是免费，能不能“白嫖大模型”。
但我觉得更重大的是另一点：
你保留下来了 Claude Code 的工作流体验。
也就是说，你用的依旧是 Claude Code 的终端交互方式、项目理解方式、Plan 模式、上下文组织方式，只是把后端模型切到了阿里云的 Coding Plan。Claude Code 的配置体系本身也支持通过设置文件管理环境变量和项目级配置。
这件事的意义实则很大：
后来大家拼的，未必只是“你用哪个模型”，而是“你把哪套 AI 编程工作流真正跑通了”。
你要是已经装好了 Claude Code，但还没接过阿里云，可以按这篇文章试一遍。
真正跑通之后，你会发现：
许多人焦虑的是模型，真正提高效率的，往往是工作流。
© 版权声明
文章版权归作者所有，未经允许请勿转载。
[db:评论]