Token Plan (Team Edition)
Best for Credits-based usage, assigned seats, and teams that want Alibaba-hosted models inside an established Claude Code workflow.
Tool + model pairing
Claude Code with Alibaba Coding Plan and Token Plan
Terminal coding assistant commonly used for natural-language programming, code edits, debugging, and repo navigation.
Claude Code can use Alibaba-hosted models through Alibaba's Anthropic-compatible endpoint. The key detail is that the authentication token, base URL, and all default model aliases must point to the same Alibaba plan.
Choose the right access route
Choose the right access route
This is a clear fit if your team already works in Claude Code. Configure the Anthropic-compatible endpoint, complete the local onboarding flag, then verify `/status` before doing repository work.
RecommendedCoding Plan for an individual; Token Plan for assigned team or sustained agent usage
Coding Plan
Best for an individual developer using Claude Code interactively under a fixed monthly request allowance.
Pay-as-you-go Model Studio API
Required when Claude Code is only the development surface for a backend, automation, or service that will call Model Studio directly.
Safe configuration pattern
Point Claude Code at Alibaba's Anthropic-compatible endpoint
The example is deliberately redacted. Replace placeholders only on your device and never paste a real API key into Nfero.
Before you start
- Install a current Node.js release supported by Claude Code and verify `claude --version`.
- On Windows, use WSL or Git Bash as described in Alibaba's setup guide.
- Set `hasCompletedOnboarding` to `true` in `~/.claude.json` so Claude Code does not attempt Anthropic login verification.
- Obtain the dedicated plan key and keep it out of shell history, repositories, screenshots, and shared settings files.
Safe configuration pattern
- Protocol
- Anthropic-compatible
- Configuration path
~/.claude/settings.json
- Use the Token Plan endpoint below, or replace it with `https://coding-intl.dashscope.aliyuncs.com/apps/anthropic` for Coding Plan.
- Use a model supported by the selected plan for the primary and default aliases.
- Replace the redacted placeholder only in the local file, open a new terminal, and test a minimal prompt.
- Run `/status` and verify the base URL is Alibaba Model Studio rather than `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"
}
}Verify the connection
- Open a new terminal and run `claude "hello"`.
- Run `/status` and inspect `ANTHROPIC_BASE_URL`, the model, and authentication route.
- Ask for a read-only repository summary before permitting file or terminal actions.
- Check plan usage after the first session to confirm requests are deducted from the intended subscription.
Model pairings
Recommended starting models
Use this tool to run interactive coding, reasoning, review, and documentation tasks with each model. Confirm final model availability and exact plan support in Alibaba Cloud before production use.
Qwenqwen3.7-plus
Text generationReasoningVisual understanding
Best pairing angle
Alibaba's current Coding Plan example and a strong general coding/reasoning default.
Qwenqwen3.7-max
Text generationReasoning
Best pairing angle
Flagship Token Plan choice for difficult reasoning and larger codebases.
Qwenqwen3.6-flash
Text generationReasoningVisual understanding
Best pairing angle
Useful as the lower-cost default for lightweight subtasks under Token Plan.
Common problems
Common problems
What you see
Unable to connect to Anthropic services or api.anthropic.com
Likely cause
The Alibaba environment variables are missing, the terminal has not reloaded them, or onboarding is incomplete.
What to do
Set `hasCompletedOnboarding`, confirm `settings.json`, open a new terminal, and verify the Alibaba URL with `/status`.
What you see
401 or invalid access token
Likely cause
The plan key and Anthropic-compatible base URL do not belong to the same subscription.
What to do
Pair the dedicated key with either the Token Plan or Coding Plan Anthropic endpoint—never mix the two.
What you see
Model not found
Likely cause
One of Claude Code's primary, Haiku, Sonnet, Opus, or subagent aliases names a model outside the selected plan's allowlist.
What to do
Set every alias to an exact supported ID, then restart Claude Code.
What you see
Context-length error or unexpectedly high usage
Likely cause
Claude Code can scan files and make multiple model calls during one task.
What to do
Open it in the smallest relevant project directory, exclude irrelevant files, split the task, and start a fresh session when needed.
Important restrictions
- Use the dedicated API key and base URL from the same Alibaba billing plan. Coding Plan, Token Plan, and general Model Studio credentials are not interchangeable.
- Plan keys are for the assigned user in an interactive coding or agent tool. Do not share them, commit them to a repository, or expose them in screenshots.
- Do not use a Coding Plan or Token Plan key for automated scripts, batch jobs, application backends, public services, or other non-interactive API workloads. Use pay-as-you-go Model Studio API access for those workloads.
- Model availability is an exact-string allowlist and can change. Confirm the model ID in the current Alibaba plan documentation before editing a working configuration.