Claude Code

Fonte: https://docs.qwencloud.com/coding-plan/tools/claude-code - extraído do HTML público arquivado.

Assistente de codificação de IA terminal do Anthropic Claude Code é um assistente de código de IA desenvolvido pela Anthropic. Conectar a QwenCloud via Token Plan (Edição Pessoal), Token Plan (Edição da Equipe), ou faturamento pago como você vai.

​ Instale o Claude Code.

MacOS

Janelas

1. Instale ou atualize [Node.js] (https://nodejs.org/en/download/) (v18.0 ou mais tarde).
2. Execute o seguinte comando no terminal para instalar o Claude Code. Entendido.

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

1. Execute o seguinte comando para verificar a instalação. Se uma versão é exibida, a instalação é bem sucedida. Entendido.

claude --version

Para usar o Claude Code no Windows, instale o WSL ou [Git for Windows] (https://git-scm.com/install/windows), então execute o seguinte comando em WSL ou Git Bash. Entendido.

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

Para mais detalhes, veja o [Guia de configuração do Windows] (https://docs.anthropic.com/en/docs/claude-code/setup#windows-setup) na documentação oficial do Claude Code.

​ Pular verificação de login

Editar ou criar ~/.claude.json (Caminho do Windows: C:\Users\<username>\.claude.json), e set hasCompletedOnboarding para true para pular a verificação oficial de login Antrópico. Entendido.

{
  "hasCompletedOnboarding": true
}

​ Configure credenciais de acesso.

Criar ~/.claude/settings.json (Caminho do Windows: C:\Users\<username>\.claude\settings.json), e adicione a configuração correspondente com base em seu plano selecionado.

​ Token Plan (Edição Pessoal)

Substitua o seu APIKY pelo plano Token (Edição Pessoal) dedicado [API Key] (https://home.qwencloud.com/api-keys). Modelos disponíveis: qwen3.8-max, qwen3.8-flash, qwen3.7-max, qwen3.7-plus, qwen3.6-flash, glm-5.2, deepseek-v4-pro, deepseek-v4-flash-0731. Para detalhes, veja [modelos suportados] (https://www.qwencloud.com/token-plan/personal/token-plan-personal-overview#supported-models) para o Token Plan (Edição Pessoal). Entendido.

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://token-plan.maas.qwencloudapi.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"
  }
}

qwen3.8-max Modo de pensamento:

• Suporta tanto habilitado quanto desativado (modo de pensamento híbrido).
• A temperatura é de 0,6 no modo de pensar. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
• Controla a profundidade do raciocínio. Opções: Xhigh, médio, baixo. Padrão: Xhigh.

​ Token Plan (Edição da Equipe)

Substitua seu plano de reconhecimento pelo plano de treinamento dedicado à chave de identificação.https://home.qwencloud.com/api-keys). Para os modelos disponíveis, veja [modelos suportados] (https://www.qwencloud.com/token-plan/team/token-plan-team-overview#supported-models) para o Token Plan (Edição da Equipe). Entendido.

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://token-plan.maas.qwencloudapi.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"
  }
}

qwen3.8-max Modo de pensamento:

• Suporta tanto habilitado quanto desativado (modo de pensamento híbrido).
• A temperatura é de 0,6 no modo de pensar. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
• Controla a profundidade do raciocínio. Opções: Xhigh, médio, baixo. Padrão: Xhigh.

​ Pagar como você vai

Substitua o seu rei por seu rei.QwenCloud API Key] (https://home.qwencloud.com/api-keys). Para modelos disponíveis, veja [A API antrópica compatível] (https://www.qwencloud.com/api-reference/chat/anthropic). Entendido.

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://maas.qwencloudapi.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"
  }
}

​ Configurar o tamanho da janela de contexto

Claude Code usa uma janela de contexto de 200K por padrão. Para lidar com grandes bases de código ou conversas longas, você pode expandir a janela de contexto para 1M (1.000.000 de fichas), desde que o modelo suporte esse comprimento de contexto. Dois métodos de configuração estão disponíveis: Método 1: definido via variável de ambiente Adicionar CLAUDE_CODE_MAX_CONTEXT_TOKENS - Para o... env - Não, não, não. ~/.claude/settings.json: Entendido.

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://maas.qwencloudapi.com/apps/anthropic",
    "ANTHROPIC_MODEL": "qwen3.7-plus",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
  }
}

Use um sufixo de nome modelo [1m] ao nome do modelo. Isso funciona com QwenCloud Modelos que suportam uma janela de contexto 1M: Entendido.

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://maas.qwencloudapi.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 de terminal para reiniciar o Claude Code para que as mudanças façam efeito. Para mais detalhes de variáveis de ambiente, veja a documentação de variáveis de ambiente oficiais do Claude Code (https://code.claude.com/docs/en/env-vars).

​ Modos de permissão

Claude Code fornece seis modos de permissão que controlam se uma confirmação aparece antes de uma ferramenta executar uma operação. A tabela seguinte descreve o comportamento de cada modo.

• Modo, comportamento. |---|---| | default Pede confirmação antes de cada operação. | acceptEdits , Aprova as edições de arquivos automaticamente. Outras operações ainda pedem confirmação. | plan - Modo de planejamento somente leitura. Nenhuma mudança é executada. | dontAsk Não é um aviso. Uma operação que exigiria uma ordem é rejeitada diretamente. | bypassPermissions Passa por todos os controles de permissão. | delegate - Modo Delegado.

​ Bandeira da linha de comando.

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

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

​ Comando interativo.

Entre /permissions em uma sessão para gerenciar regras pré-aprovação e pré-negação para ferramentas dinamicamente. Você pode configurar regras de auto-aprovação para as ferramentas de bash, edição e MCP.

​ Settings. Json, configuração.

Configurar o permissions - Não, não, não. ~/.claude/settings.json (Caminho do Windows: C:\Users\<username>\.claude\settings.jsonO mesmo arquivo de configuração que tem suas credenciais de acesso: Entendido.

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

O allow O campo aprova chamadas de ferramentas correspondentes automaticamente, e o deny campo rejeita correspondência de chamadas de ferramentas automaticamente. Ambos os campos suportam curingas. Por exemplo, Bash(npm:*) corresponde a todos os comandos que começam com npm. O defaultMode O campo define o modo de permissão padrão para a sessão, e aceita qualquer um dos modos listados na tabela anterior.

​ Use o interruptor CC

[C Switch] (https://github.com/farion1231/cc-switch) é uma interface de desktop de código aberto para gerenciar várias chaves de API ou planos de faturamento. Troque entre fornecedores com um clique, sem edição. settings.json manualmente.

​ Instalar interruptor CC

• • Não. brew tap farion1231/ccswitch && brew install --cask cc-switch, ou baixar o .dmg De [Lançamentos] (https://github.com/farion1231/cc-switch/releases).
• Windows: baixar o .msi instalador ou portátil .zip De [Lançamentos] (https://github.com/farion1231/cc-switch/releases).
• Em Arch, corra paru -S cc-switch-bin; em outras distribuições, baixar .deb/.rpm/.AppImage De [Lançamentos] (https://github.com/farion1231/cc-switch/releases).

​ Adicione um provedor.

1. Na interface principal do CC Switch, selecione Claude Code na barra de ícones superior (o ícone de estrela laranja), e clique em + no canto superior direito para abrir Adicionar novo provedor. Preencha os campos baseados na tabela abaixo, e clique em Adicionar**.

Ver a tabela estruturada nos quadros de referência desta página ↓

1. Expanda ** Opções avançadas** para configurar o mapeamento do modelo. Defina o modelo principal e os modelos padrão Haiku, Sonnet e Opus para os modelos suportados (https://www.qwencloud.com/token-plan/overview) para o seu plano. Exemplo de mapeamento:

• Modelo principal: qwen3.7-max
• Modelo padrão Haiku: qwen3.6-flash
• Modelo padrão Sonnet: qwen3.7-max
• Modelo padrão Opus: qwen3.7-max

2. Volte para a interface principal, clique em ** Enable** ao lado do provedor, e comece uma nova sessão de Claude Code para que a configuração faça efeito.

​ Conecte Claude Code Desktop

Claude Code Desktop (Claude Desktop) e o Claude Code CLI são dois pontos de entrada separados, mostrados no CC Switch como os painéis Claude Code e Claude Desktop respectivamente. O aplicativo de desktop chega QwenCloud através do CC Switch gateway local: CC Switch escreve automaticamente tanto o endereço do gateway quanto o token de autenticação na configuração do desktop, então você não ** QwenCloud API Key no aplicativo de desktop**. O QwenCloud API Key é inserida apenas na configuração do provedor de switch CC e é injetada automaticamente quando o roteador local encaminha o pedido. Não entre manualmente no seu QwenCloud API Key na configuração de inferência de terceiros do aplicativo. O símbolo que o aplicativo de desktop usa para autenticar para o portal local do CC Switch (endereço) http://127.0.0.1:15721/claude-desktop) é gerado e escrito automaticamente pelo CC Switch; entrando no QwenCloud API Key falha na autenticação porque o token não bate. Escrever a configuração de terceiros é atualmente suportado apenas no macOS e Windows.

1. Instale Claude Code Desktop da [página de download do Claude] (https://claude.ai/download).
2. No CC Switch, mude para o painel Claude Desktop do interruptor de aplicativo à esquerda. Se a entrada não for mostrada, vá para o conjunto geral e certifique-se de que Claude Desktop não esteja escondido sob visibilidade do aplicativo.
3. Adicione o QwenCloud provedor: se você já configurou um QwenCloud provedor no painel Claude Code, clique em Importar provedores existentes do Claude Code para reutilizá-lo; caso contrário clique em + na parte superior direita para adicionar um. Porque... QwenCloud IDs de modelos (como qwen3.7-max Não são as três identidades que Claude Desktop reconhece.claude-sonnet-* / claude-opus-* / claude-haiku-*), ligue Needs mapeamento modelo e mapeie os papéis Sonnet, Opus, e Haiku para o real QwenCloud Modelos para solicitar (por exemplo, Sonnet > qwen3.7-max).
4. Activar rota local: vá para Configurações > Roteamento > Roteamento local e ligue Exibir rotação na página principal; voltar para o painel Claude Desktop e ligar o interruptor Claude Desktop local roteamento. O endereço padrão é 127.0.0.1:15721.
5. Clique em ** Activar** no cartão do provedor. CC Switch escreve automaticamente a configuração de inferência de terceiros no Claude Code Desktop.
6. Mantenha o CC Switch em execução, então ** completamente desisto e reinicie** Claude Code Desktop para que as mudanças façam efeito. Selecione o modelo configurado no menu do modelo para começar a usá-lo.

​ Plugins do Claude Code IDE

Depois de completar a configuração CLI acima, você pode instalar o plugin Claude Code em seu IDE, que reutiliza diretamente a configuração em settings.json.

​ Código VS

1. Procurem por Claude Code for VS Code no mercado de extensão e instalá-lo.
2. Reinicie o código VS e clique no ícone no canto superior direito para abrir o código Claude.
3. Tipo / Na caixa de diálogo, selecione configuração geral, e defina o modelo em Modelo Selecionado.

​ JetBrains.

1. Procurem por Claude Code no mercado de extensão e instalá-lo.
2. Reinicie o IDE e clique no ícone no canto superior direito para começar a usá-lo.

​ FAQ

​ Códigos de erro.

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

• [A API antrópica compatível com códigos de erro] (https://www.qwencloud.com/api-reference/preparation/error-messages)
• (Plano de Token (Edição Pessoal):https://www.qwencloud.com/token-plan/personal/token-plan-personal-faq)
• (Edição de Equipe): (Plano de Equipe)https://www.qwencloud.com/token-plan/team/token-plan-team-faq)

​ Pedidos retornam 401 inválidos

O tipo de chave API não corresponde. ANTHROPIC_BASE_URL. QwenCloud fornece vários métodos de acesso, e cada método de acesso usa uma URL base diferente e uma chave dedicada à API.

Ver a tabela estruturada nos quadros de referência desta página ↓

Passos de solução de problemas:

1. Verifique o URL do pedido. ANTHROPIC_BASE_URL Em ~/.claude/settings.json.
2. ** Confirme o tipo de chave API.** Usando a tabela acima, confirme que o tipo de chave API corresponde à URL base.
3. • Correta a configuração. QwenCloud Pague como quiser, chave de API, definir ANTHROPIC_BASE_URL para https://maas.qwencloudapi.com/apps/anthropic.

​ Depois de iniciar o Claude Code, a interface mostra "Incapaz de se conectar aos serviços antrópicos"

Este erro indica que Claude Code está tentando se conectar ao serviço oficial Antrópico em vez do QwenCloud servidor, geralmente porque as variáveis de ambiente não estão configuradas corretamente ou não fizeram efeito. Siga estes passos para solucionar problemas:

1. Depois de iniciar o Claude Code, execute o código de segurança. /status Comandar e verificar que os valores de ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN Aponte corretamente para o QwenCloud Endereço. Se a saída estiver vazia ou apontar para um não--QwenCloud endereço, verifique se o settings.json A configuração está correta.
2. Verifique se está tudo pronto para embarcar. hasCompletedOnboarding Está pronto para true na ~/.claude.json Arquivo. Caso contrário, Claude Code tentará se conectar ao serviço oficial Antrópico para verificação de login na inicialização.
3. Após modificar o arquivo de configuração, abra uma nova janela de terminal e execute o claude Comando para a configuração fazer efeito.
4. Se o problema persistir após todos os passos acima, a versão do Claude Code pode estar ultrapassada. Corra. npm install -g @anthropic-ai/claude-code@latest Para atualizar para a última versão, então tente novamente.

​ CC Switch relata "Nenhum ponto final disponível da lista de modelos encontrado" ao adicionar um provedor

Esta mensagem vem da verificação de conectividade que o CC Switch executa ao salvar um provedor: sonda um ponto final da lista de modelos (como /v1/models) contra a URL de solicitação configurada. QwenCloudO ponto final compatível com antrópicos (terminando em /apps/anthropic) só fornece o ponto final das mensagens /v1/messages E não fornece um ponto final da lista de modelos, então a sonda retorna 404 e CC Switch relata "Nenhum ponto final da lista de modelos disponível encontrado". /v1/messages, e os modelos que ele usa são especificados diretamente pelo mapeamento do modelo em CC Switch's ** Opções avançadas**, sem depender de auto-descoberta de um ponto final da lista de modelos. Quando a URL da solicitação e a API Key estiverem configuradas corretamente, basta clicar em ** Enable** e iniciar uma nova sessão de Claude Code para conversar normalmente. Se ainda não conseguir conversar, verifique se o URL da solicitação termina em /apps/anthropic Sem um extra /v1E que preencheu os modelos apoiados pelo seu plano no mapeamento do modelo sob opções avançadas.

​ O mapeamento do modelo no CC Switch retorna o AccessDenied.

Se as chamadas de modelos falharem no Claude Code com um AccessDenied Erro (HTTP 403, código: access_denied Depois de configurar o mapeamento do modelo, verifique se o modelo está marcado para a próxima depreciação no QwenCloud [Modelo Marketplace] (https://www.qwencloud.com/models). Modelos marcados para a próxima depreciação ainda aparecem na lista, mas as chamadas da API retornam 403 AccessDenied. Siga estes passos:

1. Verifique se o modelo está marcado para deprecação. QwenCloud [Modelo Marketplace] (https://www.qwencloud.com/models Procure pelo modelo que está usando e verifique o status do rótulo.
2. ** Trocar para o mais recente modelo disponível.** Substituir o modelo legado (como qwen-coder-turbo-0919) no mapeamento do modelo com o mais recente modelo disponível (como qwen3.7-plus).
3. Reconfigurar o mapeamento e teste do modelo. Atualizar o mapeamento do modelo sob Opções avançadas no CC Switch, clique em Ativar, e iniciar uma nova sessão de Claude Code para verificar. Preste atenção no ciclo de vida do modelo. Modelos marcados para a próxima depreciação no QwenCloud A Galeria de Modelos pode ficar indisponível a qualquer momento. Pode verificar a disponibilidade de um modelo lá. [Anterior] (https://www.qwencloud.com/developer-guides/clients-and-developer-tools/hermes-agent[OpenCode Terminal AI coding assistant Próximo] (https://www.qwencloud.com/developer-guides/clients-and-developer-tools/opencode)