Token Plan（团队版）
适用于基于 Credits 的使用场景、已分配席位的团队，以及希望在既定 Claude Code 工作流中集成阿里云托管模型的团队。
选择合适的访问方式
选择合适的访问方式
若您的团队已在 Claude Code 中开展日常工作，此方案是明确适配的选择。请配置 Anthropic 兼容端点，完成本地入门标记（onboarding flag），并在执行仓库相关操作前验证 `/status` 接口。
推荐个人用户推荐选用 Coding Plan；团队分配席位或长期运行智能体（Agent）场景推荐选用 Token Plan
Coding Plan
适用于个人开发者在固定月度请求额度内，以交互方式使用 Claude Code 的场景。
Pay-as-you-go Model Studio API
当 Claude Code 仅作为后端、自动化流程或服务的开发界面，且该服务将直接调用 Model Studio 时，必须选用按量付费模式。
安全配置模式
将 Claude Code 指向阿里云 Anthropic 兼容端点
示例已做脱敏处理。请仅在本机替换占位符，切勿将真实的 API 密钥粘贴到 Nfero 中。
开始之前
- 安装 Claude Code 支持的当前 Node.js 版本，并执行 `claude --version` 验证安装。
- Windows 用户请按阿里云配置指南说明，使用 WSL 或 Git Bash。
- 在 `~/.claude.json` 中将 `hasCompletedOnboarding` 设为 `true`，以避免 Claude Code 尝试 Anthropic 登录验证。
- 获取专属计划密钥（plan key），并确保其不被记录于 Shell 历史、代码仓库、截图或共享配置文件中。
安全配置模式
- 协议
- Anthropic-compatible
- 配置路径
~/.claude/settings.json
- 使用下方的 Token Plan 终端节点；如需使用 Coding Plan，请将其替换为 `https://coding-intl.dashscope.aliyuncs.com/apps/anthropic`。
- 为主模型别名（Primary）和默认别名选择所选套餐支持的模型。
- 仅在本地文件中替换被遮蔽的占位符，然后打开新终端，测试一个最简提示。
- 运行 `/status` 命令，并确认基础 URL 为 Alibaba Model Studio，而非 `api.anthropic.com`。
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_TOKEN_PLAN_API_KEY",
"ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.7-plus",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
"CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus"
}
}验证连接
- 打开一个新终端，运行 `claude "hello"`。
- 运行 `/status`，检查 `ANTHROPIC_BASE_URL`、所用模型及认证路径。
- 在允许执行文件或终端操作前，先请求只读仓库摘要。
- 首次会话后检查套餐用量，确认请求已从目标订阅中扣除。
模型配对
推荐入门模型
使用本工具通过每个模型运行交互式编码、推理、审查和文档任务。在生产使用前，请在阿里云确认最终模型的可用性和确切计划支持。 (Alibaba Cloud)
Qwenqwen3.7-plus
文本生成推理视觉理解
最佳配对角度
阿里云当前推荐的 Coding Plan 示例模型，亦是通用编程与推理任务的优质默认选择。
Qwenqwen3.7-max
文本生成推理
最佳配对角度
面向复杂推理与大型代码库的旗舰级 Token Plan 选择。
Qwenqwen3.6-flash
文本生成推理视觉理解
最佳配对角度
可作为 Token Plan 下轻量级子任务的低成本默认选项。
常见问题
常见问题
现象描述
无法连接 Anthropic 服务或 api.anthropic.com
可能原因
缺少 Alibaba 环境变量、终端未重新加载变量，或新手引导尚未完成。
解决方法
设置 `hasCompletedOnboarding`，确认 `settings.json` 配置正确，开启新终端，并通过 `/status` 命令验证 Alibaba URL。
现象描述
401 错误或访问令牌无效
可能原因
套餐密钥与 Anthropic 兼容的基础 URL 不属于同一订阅。
解决方法
将专用密钥与 Token Plan 或 Coding Plan Anthropic 终端节点配对使用——切勿混用两者。
现象描述
模型未找到
可能原因
Claude Code 的主模型别名（Primary）、Haiku、Sonnet、Opus 或子代理别名之一，指向了所选套餐白名单之外的模型。
解决方法
将所有别名精确设置为该套餐支持的模型 ID，然后重启 Claude Code。
现象描述
上下文长度错误或用量意外升高
可能原因
Claude Code 在单个任务中可扫描文件并发起多次模型调用。
解决方法
在最小相关项目目录中打开它，排除无关文件，拆分任务，并在必要时启动全新会话。
重要限制
- 必须使用来自同一阿里云计费方案的专属 API 密钥与基础 URL。Coding Plan、Token Plan 及通用 Model Studio 凭据不可混用。
- 计划密钥仅限分配给指定用户的交互式编码或智能体工具使用；严禁共享、提交至代码仓库，或在截图中暴露。
- 禁止将 Coding Plan 或 Token Plan 密钥用于自动化脚本、批量作业、应用后端、公共服务或其他非交互式 API 工作负载；此类场景请使用 pay-as-you-go Model Studio API 访问方式。
- 模型可用性基于精确字符串白名单，且可能随时调整。请在修改已生效的配置前，查阅当前 Alibaba Cloud Token Plan 文档中确认模型 ID。