Skip to main content

Claude Code

Use modelos do Alibaba Cloud Model Studio no Claude Code.

Início Rápido

Escolha seu cliente e conclua a configuração.
  • CLI
  • CC Switch
  • IDE plugin
  • Desktop
  1. 1

    Configure the model

    • Token Plan
    • Pay-as-you-go
    • Coding Plan
    Substitua YOUR_API_KEY pela sua chave de API do Token Plan:
    export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
    export ANTHROPIC_BASE_URL="https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic"
    export ANTHROPIC_MODEL="auto"
    export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3.6-flash"
    export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3.8-flash"
    export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen4-max-preview"
    export CLAUDE_CODE_SUBAGENT_MODEL="auto"
    export CLAUDE_CODE_MAX_CONTEXT_TOKENS="983616"
    
    Ao usar qwen4-max-preview, defina CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000 se a saída longa for truncada.
    Para usar qwen4-max, defina ANTHROPIC_DEFAULT_OPUS_MODEL como qwen4-max e mantenha CLAUDE_CODE_MAX_CONTEXT_TOKENS em 983616. Se a saída longa for truncada, defina CLAUDE_CODE_MAX_OUTPUT_TOKENS=131072. qwen4-max tem contexto de 1 M de tokens. A saída máxima é de 131.072 tokens no modo sem pensamento e de 262.144 tokens para pensamento e resposta final combinados. Os padrões são reasoning_effort=high e thinking_budget=131072.
    Essas variáveis de ambiente se aplicam apenas ao terminal atual. Para configuração persistente, use Configurar com um arquivo de configuração.
  2. 2

    Verify

    Execute o seguinte comando para verificar:
    claude -p "Hello"
    

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
    • Pay-as-you-go
    • Coding Plan
    Substitua YOUR_API_KEY pela sua 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": "qwen4-max-preview",
            "CLAUDE_CODE_SUBAGENT_MODEL": "auto",
            "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
        }
    }
    
  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). Método 1: Definir por variável de ambiente 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"
    }
}
Método 2: Usar um sufixo no nome do modelo 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 os seguintes 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.
  • auto: Um classificador decide se uma operação pode ser executada, reduzindo as solicitações de confirmação. Em sessões de terminal interativo e do VS Code, o Claude Code v2.1.283 e versões posteriores usa esse modo por padrão.
  • 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.
Ao usar o modo auto com o endpoint do Token Plan, a verificação do classificador pode não retornar um resultado. Alguns modelos exibem Not run · auto mode's check had no usable answer e a operação não é executada.Se isso ocorrer, defina permissions.defaultMode como default ou acceptEdits, ou ajuste o modelo usado pelo classificador (ANTHROPIC_DEFAULT_SONNET_MODEL; o Claude Code v2.1.302 e versões posteriores também oferece suporte a CLAUDE_CODE_AUTO_MODE_MODEL) e reinicie a sessão.
Método 1: Sinalizador de linha de comando Use --permission-mode para definir o modo de permissão padrão de uma sessão:
claude --permission-mode plan
claude --permission-mode acceptEdits
Método 2: Comando interativo 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. Método 3: Configuração do settings.json 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:

Perguntas frequentes

A configuração de pagamento conforme o uso permanece a mesma: use a chave de API geral do Model Studio e a Base URL. Após comprar um plano de economia, ele entra em vigor automaticamente e o uso elegível é deduzido automaticamente. Consulte Planos de economia.

Como ignoro a verificação de login oficial da Anthropic?

Edite ou crie ~/.claude.json (caminho no Windows: C:\Users\<username>\.claude.json) e defina hasCompletedOnboarding como true para ignorar a verificação de login oficial da Anthropic.
{
  "hasCompletedOnboarding": true
}
O tipo da chave de API não corresponde a ANTHROPIC_BASE_URL. O Model Studio fornece três métodos de acesso, e cada método de acesso usa uma URL base diferente e uma chave de API dedicada.

Método de acesso

URL base

Chave de API

Token Plan

https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

Chave de API do Token Plan

Pay-as-you-go

https://dashscope-intl.aliyuncs.com/apps/anthropic

Chave de API do Model Studio (começa com sk-)

Coding Plan

https://coding-intl.dashscope.aliyuncs.com/apps/anthropic

Chave de API dedicada do Coding Plan

Etapas de solução de problemas:
  1. Verifique a URL da requisição. Verifique ANTHROPIC_BASE_URL em ~/.claude/settings.json.
  2. Confirme o tipo da chave de API. Usando a tabela acima, confirme se o tipo da sua chave de API corresponde à URL base.
  3. Corrija a configuração. Quando você usar uma chave de API Pay-as-you-go do Model Studio, defina ANTHROPIC_BASE_URL como https://dashscope-intl.aliyuncs.com/apps/anthropic.
O Claude Code está se conectando ao serviço oficial da Anthropic em vez do Alibaba Cloud Model Studio. Isso geralmente significa que as variáveis de ambiente estão ausentes ou não entraram em vigor. Siga estas etapas:
  1. Verifique a configuração. Execute o comando /status após iniciar o Claude Code. Verifique se ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN apontam para o endereço do Model Studio. Se a saída estiver vazia ou mostrar um endereço que não seja do Model Studio, verifique a configuração do settings.json.
  2. Verifique hasCompletedOnboarding. Confirme se hasCompletedOnboarding está definido como true em ~/.claude.json. Sem isso, o Claude Code tenta se conectar ao serviço oficial da Anthropic para verificação de login na inicialização.
  3. Abra um novo terminal. Após editar o arquivo de configuração, abra uma nova janela de terminal e execute claude para que as alterações entrem em vigor.
  4. Atualize o Claude Code. Se o problema persistir após todas as etapas acima, a versão do Claude Code pode estar desatualizada. Execute npm install -g @anthropic-ai/claude-code@latest para atualizar para a versão mais recente e tente novamente.
A interface compatível legada https://dashscope-intl.aliyuncs.com/api/v2/apps/claude-code-proxy suporta apenas modelos descontinuados. Especificar outros modelos não tem efeito. Para usar os modelos disponíveis, migre para a nova interface seguindo a configuração neste documento.
Essa mensagem vem da verificação de conectividade que o CC Switch executa ao salvar um provedor: ele testa um endpoint de lista de modelos (como /v1/models) na URL de requisição configurada. O endpoint compatível com Anthropic do Model Studio (terminando em /apps/anthropic) fornece apenas o endpoint de mensagens /v1/messages e não fornece um endpoint de lista de modelos, portanto o teste retorna 404 e o CC Switch reporta "No available model list endpoint found".Essa mensagem não afeta o uso normal do Claude Code e pode ser ignorada. O Claude Code envia conversas por /v1/messages, e os modelos que ele usa são especificados diretamente pelo mapeamento de modelos nas Advanced options do CC Switch, sem depender da descoberta automática de um endpoint de lista de modelos. Quando a URL de requisição e a chave de API estiverem configuradas corretamente, basta clicar em Enable e iniciar uma nova sessão do Claude Code para conversar normalmente.Se você ainda não conseguir conversar, verifique se a URL de requisição termina em /apps/anthropic sem um /v1 extra e se você preencheu os modelos suportados pelo seu plano no mapeamento de modelos em Advanced options.
Se as chamadas de modelo falharem no Claude Code com um erro AccessDenied (HTTP 403, código: access_denied) depois que você configurar o mapeamento de modelos, verifique se o modelo está marcado como Upcoming deprecation no console do Model Studio > Model Gallery. Modelos marcados para descontinuação futura ainda aparecem na lista, mas as chamadas de API retornam 403 AccessDenied. Siga estas etapas:
  1. Verifique se o modelo está marcado para descontinuação. No console do Model Studio > Model Gallery, pesquise o modelo que você está usando e verifique o rótulo de status.
  2. Mude para o modelo disponível mais recente. Substitua o modelo legado (como qwen-coder-turbo-0919) no mapeamento de modelos pelo modelo disponível mais recente (como qwen3.8-max).
  3. Reconfigure o mapeamento de modelos e teste. Atualize o mapeamento de modelos em Advanced options no CC Switch, clique em Enable e inicie uma nova sessão do Claude Code para verificar.
Preste atenção ao ciclo de vida do modelo. Modelos marcados para descontinuação futura no console do Model Studio > Model Gallery podem ficar indisponíveis a qualquer momento. Você pode verificar o status de disponibilidade de um modelo lá.