Alibaba Cloud Model Studio:Claude Code

Instalação

npm install -g @anthropic-ai/claude-code

Ignorar a verificação de login

Edite ou crie o arquivo ~/.claude.json (caminho no Windows: C:\Users\<username>\.claude.json) e defina hasCompletedOnboarding como true para pular a verificação de login oficial da Anthropic.

{
  "hasCompletedOnboarding": true
}

Token Plan (Team Edition)

Substitua YOUR_API_KEY pela API Key dedicada do Token Plan (Team Edition). Para os modelos disponíveis, consulte os modelos suportados pelo Token Plan (Team Edition).

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.6-plus",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.6-plus"
    }
}

Coding Plan

Substitua YOUR_API_KEY pela API Key dedicada do Coding Plan. Para os modelos disponíveis, consulte os modelos suportados pelo Coding Plan.

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

Pagamento conforme o uso

Substitua YOUR_API_KEY pela sua API Key do Alibaba Cloud Model Studio. Para os modelos disponíveis, consulte a API compatível com Anthropic.

Defina ANTHROPIC_BASE_URL de acordo com a região. A API key deve corresponder à região selecionada:

• China North 2 (Beijing): https://dashscope.aliyuncs.com/apps/anthropic

• Singapore: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic. Substitua WorkspaceId pelo seu ID do Workspace real.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.6-plus",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.6-plus"
    }
}

Instale o CC Switch

• macOS: execute brew tap farion1231/ccswitch && brew install --cask cc-switch ou baixe o arquivo .dmg na página de Releases.

• Windows: baixe o instalador .msi ou a versão portátil .zip na página de Releases.

• Linux: no Arch, execute paru -S cc-switch-bin; em outras distribuições, baixe os pacotes .deb / .rpm / .AppImage na página de Releases.

Adicionar um provedor

1. Na interface principal do CC Switch, selecione Claude Code na barra de ícones superior (ícone de estrela laranja) e clique em + no canto superior direito para abrir Add New Provider. Preencha os campos conforme a tabela abaixo e clique em Add.

   Billing plan	Configuration
   Token Plan (Team Edition)	Provider name: Bailian-Token Plan API Key: get from console Endpoint: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
   Coding Plan	Provider name: Bailian-Coding Plan API Key: get from console Endpoint: https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
   Pay-as-you-go	Provider name: Bailian-Pay-as-you-go API Key: Model Studio API Key Endpoint: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

2. Expanda Advanced Options para configurar o mapeamento de modelos. Defina o modelo principal e os modelos padrão Haiku, Sonnet e Opus como modelos suportados pelo seu plano. Exemplo de mapeamento:

   • Modelo principal: qwen3.7-max (não suportado pelo Coding Plan)

   • Modelo padrão Haiku: qwen3.6-flash (não suportado pelo Coding Plan)

   • Modelo padrão Sonnet: qwen3.7-max (não suportado pelo Coding Plan)

   • Modelo padrão Opus: qwen3.7-max (não suportado pelo Coding Plan)

3. Retorne à interface principal, clique em Enable ao lado do provedor e inicie uma nova sessão do Claude Code para aplicar a configuração.

Conectar o Claude Code Desktop

1. Instale o Claude Code Desktop na página de download do Claude.

2. No menu superior, acesse Help > Troubleshooting > Enable Developer Mode. Após reiniciar, o menu Developer aparecerá na parte superior.

3. Acesse Developer > Configure Third-Party Inference, defina Connection como Gateway, preencha os campos conforme a tabela abaixo e clique em Apply locally:

   Field	Value
   Gateway base URL	Endereço de escuta do roteador do CC Switch. O padrão é http://127.0.0.1:15721; se alterado, mantenha a consistência com a próxima etapa.
   Gateway API key	API Key do Model Studio
   Gateway auth scheme	bearer
   Model list	O ID do modelo deve seguir o padrão da Anthropic, como claude-opus-4.7. O modelo real invocado é determinado pelo roteamento do CC Switch, que corresponde ao mapeamento de modelos em Advanced Options. O nome de exibição afeta apenas o rótulo no menu suspenso.

4. No CC Switch, clique no ícone de configurações no canto superior esquerdo, acesse Router e ative Router Master Switch. O endereço de escuta padrão é 127.0.0.1:15721; se alterado, mantenha a consistência com a etapa anterior.

5. Selecione o ID do modelo configurado no menu suspenso de modelos do Claude Code Desktop para começar a usá-lo.

VS Code

1. Pesquise por Claude Code for VS Code no marketplace de extensões e instale-a.

2. Reinicie o VS Code e clique no ícone no canto superior direito para abrir o Claude Code.

3. Digite / na caixa de diálogo, selecione General config e defina o modelo em Selected Model.

JetBrains

1. Pesquise por Claude Code no marketplace de extensões e instale-a.

2. Reinicie a IDE e clique no ícone no canto superior direito para começar a usar.

Códigos de erro

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

• Pagamento conforme o uso: API Compatível com Anthropic - Códigos de Erro

• Coding Plan: FAQ do Coding Plan

• Token Plan (Team Edition): FAQ do Token Plan (Team Edition)

Após iniciar o Claude Code, a interface exibe "Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST"

O Claude Code está tentando se conectar ao serviço oficial da Anthropic em vez do Alibaba Cloud Model Studio. Isso geralmente indica 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. Confirme 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 diferente do Model Studio, revise a configuração no settings.json.

2. Verifique hasCompletedOnboarding. Confirme se hasCompletedOnboarding está definido como true no arquivo ~/.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 aplicar as alterações.

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.

O CC Switch relata "No available model list endpoint found. Check the Base URL or confirm that the provider has opened the port" ao adicionar um provedor

Essa mensagem vem da verificação de conectividade que o CC Switch executa ao salvar um provedor: ele sonda um endpoint de lista de modelos (como /v1/models) na URL de requisição configurada. O endpoint compatível com Anthropic do Model Studio (terminado em /apps/anthropic) fornece apenas o endpoint de mensagens /v1/messages e não oferece um endpoint de lista de modelos, então a sonda retorna 404 e o CC Switch relata "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 através de /v1/messages, e os modelos utilizados são especificados diretamente pelo mapeamento de modelos nas Advanced options do CC Switch, sem depender da descoberta automática via endpoint de lista de modelos. Quando a URL de requisição e a API Key estiverem configuradas corretamente, basta clicar em Enable e iniciar uma nova sessão do Claude Code para conversar normalmente.

Se 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.