Alibaba Cloud Model Studio：Claude Code

在 Claude Code 中使用阿里雲百煉模型。

快速接入

選擇你使用的用戶端，完成設定。

透過設定檔接入

除了上述方式，也可以透過設定檔接入。

1. 1

   開啟設定檔

   • macOS / Linux：~/.claude/settings.json
   • Windows：C:\Users\<用户名>\.claude\settings.json
2. 2

   寫入設定

   Token Plan

   將 YOUR_API_KEY 替換為 Token Plan API Key：

   • Token Plan 個人版：建立或查看 API Key
   • Token Plan 團隊版：分配席位並取得 API Key

   {
       "env": {
           "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
           "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.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"
       }
   }
   

   按量計費

   將 YOUR_API_KEY 替換為阿里雲百煉 API Key，並將 {WorkspaceId} 替換為實際的 Workspace ID，以新加坡區域為例。

   {
       "env": {
           "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
           "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.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

   將 YOUR_API_KEY 替換為 Coding Plan API Key。

   {
       "env": {
           "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
           "ANTHROPIC_BASE_URL": "https://coding-intl.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

   驗證

   儲存後執行以下命令驗證：

   claude -p "你好"
   

設定上下文視窗大小

Claude Code 預設為 200K 上下文視窗。當模型支援 1M 時，可擴充至 1M（1,000,000 tokens）。

在 ~/.claude/settings.json 的 env 欄位中新增 CLAUDE_CODE_MAX_CONTEXT_TOKENS：

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

在模型名稱後新增 [1m] 後綴，適用於百煉支援 1M 上下文的模型：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.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]"
    }
}

修改設定後，需開啟新的終端機視窗並重新啟動 Claude Code，以使設定生效。

權限模式設定

Claude Code 提供 6 種權限模式：

• default：每次操作詢問使用者確認。
• acceptEdits：自動核准檔案編輯，其他操作仍詢問。
• plan：唯讀規劃模式，不執行修改。
• dontAsk：不詢問，需要詢問的操作直接拒絕。
• bypassPermissions：繞過所有權限檢查。
• delegate：委託模式。

使用 --permission-mode 指定本次工作階段的預設權限模式：

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

在工作階段中輸入 /permissions 管理工具的預先核准和預先拒絕規則，支援 bash、edit 和 MCP 工具。

在 ~/.claude/settings.json 的 permissions 欄位中設定：

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

接入百煉 CLI

1. 1

   安裝 百煉 CLI

   请帮我全局安装阿里云百炼 CLI 命令行工具：npm install -g bailian-cli
   

2. 2

   配置 API Key

   前往百煉控制台取得 API Key，然後告訴 Claude Code：

   配置我的 API Key 是：sk-xxxxxxxxxxxxx
   

3. 3

   開始使用

   直接用自然語言描述需求，例如：

   帮我生成 6 张亚马逊电商主图，产品是白色无线蓝牙耳机。
   帮我生成一段 30 秒的白色无线蓝牙耳机产品演示视频。
   

錯誤碼

設定過程中遇到錯誤時，請參考對應方案的常見問題文件：

• Token Plan：個人版常見問題 · 團隊版常見問題
• 按量計費：錯誤代碼
• Coding Plan：Coding Plan 常見問題

常見問題

{
  "hasCompletedOnboarding": true
}