Alibaba Cloud Model Studio:Claude Code

Use modelos do Alibaba Cloud Model Studio no Claude Code.

Início Rápido

Escolha seu cliente e conclua a configuração.

Configurar com um arquivo de configuração

Além das opções acima, você também pode se conectar usando um arquivo de configuração.

1. 1

   Abra ou crie o arquivo de configuração

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

   Add the configuration

   Token Plan

   Substitua YOUR_API_KEY pela sua Token Plan API Key:

   • Token Plan Personal Edition: Criar ou visualizar API Key
   • Token Plan Team Edition: Atribuir assento e obter 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"
       }
   }
   

   Pay-as-you-go

   Substitua YOUR_API_KEY pela sua Alibaba Cloud Model Studio API Key e substitua {WorkspaceId} pelo seu Workspace ID real. O exemplo a seguir usa Singapore.

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

   Substitua YOUR_API_KEY pela sua 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

   Verify

   Após salvar, execute o seguinte comando para verificar:

   claude -p "Hello"
   

Configurar o tamanho da janela de contexto

O Claude Code usa como padrão uma janela de contexto de 200K. Se o modelo suportar 1M, estenda-a para 1M (1.000.000 tokens).

Adicione CLAUDE_CODE_MAX_CONTEXT_TOKENS ao campo env em ~/.claude/settings.json:

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

Anexe [1m] ao nome do modelo. Isso funciona com modelos do Model Studio que suportam uma janela de contexto de 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]"
    }
}

Depois de modificar a configuração, abra uma nova janela do terminal para reiniciar o Claude Code e fazer as alterações entrarem em vigor.

Modos de permissão

O Claude Code fornece seis modos de permissão:

• default: Solicita confirmação antes de cada operação.
• acceptEdits: Aprova edições de arquivo automaticamente. Outras operações ainda solicitam confirmação.
• plan: Modo de planejamento somente leitura. Nenhuma alteração é executada.
• dontAsk: Não faz solicitações. Uma operação que exigiria uma solicitação é rejeitada diretamente.
• bypassPermissions: Contorna todas as verificações de permissão.
• delegate: Modo delegado.

Use --permission-mode para definir o modo de permissão padrão de uma sessão:

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

Digite /permissions em uma sessão para gerenciar regras de aprovação prévia e negação prévia para as ferramentas bash, edit e MCP.

Configure o campo permissions em ~/.claude/settings.json:

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

Integrar o Bailian CLI

1. 1

   Instale o Bailian CLI

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

2. 2

   Configure a API Key

   Acesse o console do Bailian para obter uma API Key e informe ao Claude Code:

   My API Key is: sk-xxxxxxxxxxxxx
   

3. 3

   Primeiros passos

   Descreva sua tarefa em linguagem natural, por exemplo:

   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.
   

Códigos de erro

Se você encontrar erros durante a configuração, consulte a documentação de FAQ do seu plano de cobrança:

• Token Plan: FAQ da Edição Pessoal · FAQ da Edição de Equipe
• Pagamento conforme o uso: Códigos de erro
• Coding Plan: FAQ do Coding Plan

Perguntas frequentes

{
  "hasCompletedOnboarding": true
}