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
Configure the model
- Token Plan
- Pay-as-you-go
- Coding Plan
SubstituaYOUR_API_KEYpela sua chave de API do Token Plan:- Token Plan Personal Edition: Criar ou visualizar API Key
- Token Plan Team Edition: Atribuir assento e obter API Key
Ao usar qwen4-max-preview, definaCLAUDE_CODE_MAX_OUTPUT_TOKENS=64000se a saída longa for truncada.Para usar qwen4-max, definaANTHROPIC_DEFAULT_OPUS_MODELcomoqwen4-maxe mantenhaCLAUDE_CODE_MAX_CONTEXT_TOKENSem983616. Se a saída longa for truncada, definaCLAUDE_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
Verify
Execute o seguinte comando para verificar:
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
Abra ou crie o arquivo de configuração
- macOS / Linux:
~/.claude/settings.json - Windows:
C:\Users\<username>\.claude\settings.json
- macOS / Linux:
- 2
Add the configuration
- Token Plan
- Pay-as-you-go
- Coding Plan
SubstituaYOUR_API_KEYpela sua Token Plan API Key:- Token Plan Personal Edition: Criar ou visualizar API Key
- Token Plan Team Edition: Atribuir assento e obter API Key
- 3
Verify
Após salvar, execute o seguinte comando para verificar:
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:
[1m] ao nome do modelo. Isso funciona com modelos do Model Studio que suportam uma janela de contexto de 1M:
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.
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.--permission-mode para definir o modo de permissão padrão de uma sessão:
/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:
Integrar o Bailian CLI
- 1
Instale o Bailian CLI
- 2
- 3
Primeiros passos
Descreva sua tarefa em linguagem natural, por exemplo:
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
Como usar um plano de economia com pagamento conforme o uso?
Como usar um plano de economia com pagamento conforme o uso?
Como ignoro a verificação de login oficial da Anthropic?
Como ignoro a verificação de login oficial da Anthropic?
~/.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.Requisições retornam 401 invalid_api_key
Requisições retornam 401 invalid_api_key
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 |
| Chave de API do Token Plan |
Pay-as-you-go | Chave de API do Model Studio (começa com | |
Coding Plan | Chave de API dedicada do Coding Plan |
- Verifique a URL da requisição. Verifique
ANTHROPIC_BASE_URLem~/.claude/settings.json. - Confirme o tipo da chave de API. Usando a tabela acima, confirme se o tipo da sua chave de API corresponde à URL base.
- Corrija a configuração. Quando você usar uma chave de API Pay-as-you-go do Model Studio, defina
ANTHROPIC_BASE_URLcomohttps://dashscope-intl.aliyuncs.com/apps/anthropic.
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"
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"
- Verifique a configuração. Execute o comando
/statusapós iniciar o Claude Code. Verifique seANTHROPIC_BASE_URLeANTHROPIC_AUTH_TOKENapontam 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 dosettings.json. - Verifique hasCompletedOnboarding. Confirme se
hasCompletedOnboardingestá definido comotrueem~/.claude.json. Sem isso, o Claude Code tenta se conectar ao serviço oficial da Anthropic para verificação de login na inicialização. - Abra um novo terminal. Após editar o arquivo de configuração, abra uma nova janela de terminal e execute
claudepara que as alterações entrem em vigor. - 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@latestpara atualizar para a versão mais recente e tente novamente.
A troca de modelo não entra em vigor ao usar a interface legada
A troca de modelo não entra em vigor ao usar a interface 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.O CC Switch reporta "No available model list endpoint found. Check the Base URL or confirm that the provider has opened the port" ao adicionar um provedor
O CC Switch reporta "No available model list endpoint found. Check the Base URL or confirm that the provider has opened the port" ao adicionar um provedor
/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.O mapeamento de modelos no CC Switch retorna AccessDenied
O mapeamento de modelos no CC Switch retorna AccessDenied
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:- 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.
- 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 (comoqwen3.8-max). - 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.