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.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": "qwen4-max-preview",
           "CLAUDE_CODE_SUBAGENT_MODEL": "auto",
           "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
       }
   }
   

   按量计费

   将 YOUR_API_KEY 替换为阿里云百炼 API Key，并将 {WorkspaceId} 替换为真实的 Workspace ID，以华北2（北京）地域为例。

   {
       "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

   将 YOUR_API_KEY 替换为 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

   验证

   保存后运行以下命令验证：

   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}.cn-beijing.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}.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]"
    }
}

修改配置后，需新开终端窗口重新启动 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：Token Plan 常见问题
• 按量计费：错误码
• Coding Plan：Coding Plan 常见问题

常见问题

{
  "hasCompletedOnboarding": true
}