Configurações de privacidade

Aviso de privacidade e LGPD

A Nfero usa armazenamento essencial para preferências de idioma e controles de acesso às demonstrações. Com seu consentimento, o Google Analytics e eventos leves de uso ajudam a melhorar as demonstrações de modelos e os caminhos de assinatura externos. Prompts de demonstrações ao vivo podem ser enviados a endpoints de modelos configurados e hospedados pela Alibaba.

Atribuição de ferramenta + modelo

Claude Code com Plano de Codificação e Plano de Créditos da Alibaba (Token Plan)

Assistente de programação de terminal comumente usado para programação em linguagem natural, edições de código, depuração e navegação em repositórios.

Claude Code pode usar modelos hospedados pela Alibaba por meio do endpoint compatível com Anthropic da Alibaba. O detalhe essencial é que o token de autenticação, a URL base e todos os aliases padrão de modelo devem apontar para o mesmo plano da Alibaba.

Escolha a rota de acesso adequada

Escolha a rota de acesso adequada

Esta é uma solução adequada se sua equipe já trabalha com Claude Code. Configure o endpoint compatível com Anthropic, conclua a flag de onboarding local e, em seguida, verifique `/status` antes de iniciar o trabalho no repositório.

RecomendadoCoding Plan para um indivíduo; Token Plan para equipes atribuídas ou uso contínuo por agentes

Token Plan (Edição para Equipes)

Ideal para uso baseado em Credits, assentos atribuídos e equipes que desejam modelos hospedados pela Alibaba dentro de um fluxo de trabalho estabelecido do Claude Code.

Coding Plan

Ideal para um desenvolvedor individual que usa Claude Code interativamente com uma cota mensal fixa de solicitações.

Model Studio Pay-as-you-go API

Obrigatório quando Claude Code é apenas a interface de desenvolvimento para um backend, automação ou serviço que chamará diretamente o Model Studio.

Padrão seguro de configuração

Aponte Claude Code para o endpoint compatível com Anthropic da Alibaba

O exemplo foi deliberadamente omitido. Substitua os espaços reservados apenas em seu dispositivo e nunca cole uma chave real de API no Nfero.

Antes de começar

  1. Instale uma versão atual do Node.js compatível com Claude Code e verifique `claude --version`.
  2. No Windows, use WSL ou Git Bash conforme descrito no guia de configuração da Alibaba.
  3. Defina `hasCompletedOnboarding` como `true` em `~/.claude.json`, para que o Claude Code não tente verificar o login na Anthropic.
  4. Obtenha a chave dedicada do plano e mantenha-a fora do histórico do shell, repositórios, capturas de tela e arquivos compartilhados de configuração.

Padrão seguro de configuração

Protocolo
Anthropic-compatible
Caminho da configuração
~/.claude/settings.json
  1. Utilize o endpoint Token Plan abaixo ou substitua-o por `https://coding-intl.dashscope.aliyuncs.com/apps/anthropic` para o Coding Plan.
  2. Use um modelo compatível com o plano selecionado para os aliases principais e padrão.
  3. Substitua o espaço reservado mascarado apenas no arquivo local, abra um novo terminal e teste um prompt mínimo.
  4. Execute `/status` e verifique se a URL base é Alibaba Model Studio, e não `api.anthropic.com`.
json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_TOKEN_PLAN_API_KEY",
    "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_MODEL": "qwen3.7-plus",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
    "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus"
  }
}

Verifique a conexão

  • Abra um novo terminal e execute `claude "hello"`.
  • Execute `/status` e verifique `ANTHROPIC_BASE_URL`, o modelo e a rota de autenticação.
  • Solicite um resumo do repositório apenas para leitura antes de permitir ações em arquivos ou no terminal.
  • Verifique o uso do plano após a primeira sessão para confirmar que as solicitações são descontadas da assinatura desejada.

Atribuições de modelos

Modelos recomendados para começar

Use esta ferramenta para executar tarefas interativas de programação, raciocínio, revisão e documentação com cada modelo. Confirme a disponibilidade final do modelo e o suporte exato ao plano na Alibaba Cloud antes do uso em produção.

Geração de textoRaciocínioCompreensão visual
Melhor ângulo de emparelhamento

Exemplo atual da Alibaba para Coding Plan e um excelente padrão geral para codificação e raciocínio.

Geração de textoRaciocínio
Melhor ângulo de emparelhamento

Escolha principal da Token Plan para raciocínio complexo e bases de código maiores.

Geração de textoRaciocínioCompreensão visual
Melhor ângulo de emparelhamento

Útil como padrão de menor custo para subtarefas leves sob a Token Plan.

Problemas comuns

Problemas comuns

O que você vê

Não foi possível conectar aos serviços da Anthropic ou a api.anthropic.com

Causa provável

As variáveis de ambiente da Alibaba Cloud estão ausentes, o terminal não as recarregou ou a configuração inicial está incompleta.

O que fazer

Defina `hasCompletedOnboarding` como `true`, confirme o `settings.json`, abra um novo terminal e verifique o URL da Alibaba Cloud com `/status`.

O que você vê

Erro 401 ou token de acesso inválido

Causa provável

A chave do plano e o URL base compatível com Anthropic não pertencem à mesma assinatura.

O que fazer

Associe a chave dedicada ao endpoint Anthropic Token Plan ou Coding Plan — nunca os misture.

O que você vê

Modelo não encontrado

Causa provável

Um dos apelidos (aliases) principal, Haiku, Sonnet, Opus ou de subagente do Claude Code aponta para um modelo fora da lista permitida do plano selecionado.

O que fazer

Defina cada alias para um ID suportado exato e reinicie o Claude Code.

O que você vê

Erro de limite de contexto ou consumo inesperadamente alto

Causa provável

O Claude Code pode analisar arquivos e realizar múltiplas chamadas ao modelo durante uma única tarefa.

O que fazer

Abra-o no menor diretório de projeto relevante possível, exclua arquivos desnecessários, divida a tarefa e inicie uma nova sessão quando necessário.

Restrições importantes

  • Use a chave dedicada de API e a URL base provenientes do mesmo plano de cobrança da Alibaba. As credenciais da Coding Plan, da Token Plan e do Model Studio em geral não são intercambiáveis.
  • As chaves de plano são destinadas ao usuário atribuído em ferramentas interativas de codificação ou agentes. Não as compartilhe, não as envie para repositórios nem as exponha em capturas de tela.
  • Não utilize uma chave Coding Plan ou Token Plan para scripts automatizados, trabalhos em lote, backends de aplicações, serviços públicos ou outras cargas de trabalho API não interativas. Utilize o acesso API do pay-as-you-go Model Studio para essas cargas de trabalho.
  • A disponibilidade de modelos segue uma lista de permissões por correspondência exata de strings e pode mudar. Confirme a ID do modelo na documentação atual do plano da Alibaba antes de editar uma configuração funcional.