Claude Code

Use Alibaba Cloud Model Studio models in Claude Code.

Quick Start

Choose your client and complete the configuration.

Configure with a Configuration File

In addition to the options above, you can also connect using a configuration file.

1. 1

   Open or create the configuration file

   • macOS / Linux: ~/.claude/settings.json
   • Windows: C:\Users\<username>\.claude\settings.json
2. 2

   Add the configuration

   Token Plan

   Replace YOUR_API_KEY with your Token Plan API Key:

   • Token Plan Personal Edition: Create or view API Key
   • Token Plan Team Edition: Assign a seat and get the API Key

   {
       "env": {
           "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
           "ANTHROPIC_BASE_URL": "https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic",
           "ANTHROPIC_MODEL": "auto",
           "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
           "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-flash",
           "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.8-max",
           "CLAUDE_CODE_SUBAGENT_MODEL": "auto",
           "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
       }
   }
   

   Pay-as-you-go

   Replace YOUR_API_KEY with your Alibaba Cloud Model Studio API Key, and replace {WorkspaceId} with your actual Workspace ID. The following example uses China North 2 (Beijing).

   {
       "env": {
           "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
           "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic",
           "ANTHROPIC_MODEL": "qwen3.7-max",
           "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
           "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-max",
           "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
           "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max"
       }
   }
   

   Coding Plan

   Replace YOUR_API_KEY with your Coding Plan API Key.

   {
       "env": {
           "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
           "ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
           "ANTHROPIC_MODEL": "qwen3.7-plus",
           "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.7-plus",
           "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus",
           "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-plus",
           "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus"
       }
   }
   

3. 3

   Verify

   After saving, run the following command to verify:

   claude -p "Hello"
   

Configure Context Window Size

Claude Code defaults to a 200K context window. If the model supports 1M, extend it to 1M (1,000,000 tokens).

Add CLAUDE_CODE_MAX_CONTEXT_TOKENS to the env field in ~/.claude/settings.json:

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
    }
}

Append [1m] to the model name. This works with Model Studio models that support a 1M context window:

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus[1m]",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus[1m]",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-plus[1m]",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus[1m]"
    }
}

After modifying the configuration, open a new terminal window to restart Claude Code for the changes to take effect.

Permission modes

Claude Code provides six permission modes:

• default: Prompts for confirmation before every operation.
• acceptEdits: Approves file edits automatically. Other operations still prompt for confirmation.
• plan: Read-only planning mode. No changes are executed.
• dontAsk: Does not prompt. An operation that would require a prompt is rejected directly.
• bypassPermissions: Bypasses all permission checks.
• delegate: Delegated mode.

Use --permission-mode to set the default permission mode for a session:

claude --permission-mode plan
claude --permission-mode acceptEdits

Enter /permissions in a session to manage pre-approve and pre-deny rules for the bash, edit, and MCP tools.

Configure the permissions field in ~/.claude/settings.json:

{
    "permissions": {
        "allow": ["Bash(git:*)", "Read", "Edit"],
        "deny": ["Bash(rm:*)"],
        "defaultMode": "default"
    }
}

Integrate Bailian CLI

1. 1

   Install Bailian CLI

   Please install the Alibaba Cloud Bailian CLI globally: npm install -g bailian-cli
   

2. 2

   Configure the API Key

   Go to the Bailian console to get an API Key, then tell Claude Code:

   My API Key is: sk-xxxxxxxxxxxxx
   

3. 3

   Get started

   Describe your task in natural language, for example:

   Generate 6 Amazon e-commerce hero images for a white wireless Bluetooth headset.
   Generate a 30-second product demo video for a white wireless Bluetooth headset.
   

Error Codes

If you encounter errors during configuration, refer to the FAQ documentation for your billing plan:

• Token Plan: Personal Edition FAQ · Team Edition FAQ
• Pay-as-you-go: Error codes
• Coding Plan: Coding Plan FAQ

FAQ

{
  "hasCompletedOnboarding": true
}