Claude Code

#Claude Code

Assistente de codificação de IA do terminal da Anthropic

Claude Code é um assistente de codificação de IA de linha de comando desenvolvido pela Anthropic. Conecte-o a QwenCloud via Token Plan (Personal Edition), Token Plan (Team Edition) ou faturamento pré-pago.

Instale o código Claude

macOS

1. Instale ou atualize [Node.js](https://nodejs.org/en/download/) (v18.0 ou posterior).

2. Execute o seguinte comando no terminal para instalar o Claude Code.

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

3. Execute o seguinte comando para verificar a instalação. Se um número de versão for exibido, a instalação foi bem-sucedida.

```bash
claude --version
```

Windows

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

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



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

Ignorar verificação de login

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

{
  "hasCompletedOnboarding": true
}

Configurar credenciais de acesso

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

Plano de token (edição pessoal)

Substitua YOUR_API_KEY pelo Token Plan (Personal Edition) dedicado API Key. 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 obter detalhes, consulte modelos suportados para Token Plan (Edição Pessoal).

{
  "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 **:

• pensando: Suporta habilitado e desabilitado (modo de pensamento híbrido).
• temperatura: O padrão é 0,6 no modo de pensamento. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
• raciocínio_esforço: Controla a profundidade do raciocínio. Opções: xalto, médio, baixo. Padrão: xalto.

Plano de Token (Edição de Equipe)

Substitua YOUR_API_KEY pelo Token Plan (Team Edition) dedicado API Key. Para modelos disponíveis, consulte modelos suportados para Token Plan (Team Edition).

{
  "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 **:

• pensando: Suporta habilitado e desabilitado (modo de pensamento híbrido).
• temperatura: O padrão é 0,6 no modo de pensamento. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
• raciocínio_esforço: Controla a profundidade do raciocínio. Opções: xalto, médio, baixo. Padrão: xalto.

Pague conforme o uso

Substitua YOUR_API_KEY pelo seu QwenCloud Chave API. Para modelos disponíveis, consulte Compatível com API Antrópica.

{
  "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 longas conversas, você pode expandir a janela de contexto para 1 milhão (1.000.000 de tokens), desde que o modelo suporte esse comprimento de contexto. Dois métodos de configuração estão disponíveis:

Método 1: definido por meio de variável de ambiente

Adicionar CLAUDE_CODE_MAX_CONTEXT_TOKENS para o env campo em ~/.claude/settings.json:

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

Método 2: use um sufixo de nome de modelo

Anexar [1m] ao nome do modelo. Isso funciona com QwenCloud modelos que suportam uma janela de contexto de 1M:

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

Após modificar a configuração, abra uma nova janela de terminal para reiniciar o Claude Code para que as alterações tenham efeito. Para obter mais detalhes sobre variáveis de ambiente, consulte a documentação oficial de variáveis de ambiente do Claude Code.

Verifique a configuração

Após salvar a configuração, abra uma nova janela de terminal e execute o seguinte comando para verificar se a conexão foi bem-sucedida:

claude "Hello"

Se o modelo retornar uma resposta normal, a configuração foi bem-sucedida.

Corre claude para entrar no modo interativo, que suporta conversas múltiplas, edição de arquivos e execução de comandos. Para obter detalhes, consulte a documentação oficial do Claude Code.

Modos de permissão

O Claude Code fornece seis modos de permissão que controlam se um prompt de confirmação aparece antes que uma ferramenta execute uma operação. A tabela a seguir descreve o comportamento de cada modo.

Sinalizador de linha de comando

Usar --permission-mode para definir o modo de permissão padrão para uma sessão:

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

Comando interativo

Entrar /permissions em uma sessão para gerenciar dinamicamente regras de pré-aprovação e pré-negação para ferramentas. Você pode configurar regras de aprovação automática para as ferramentas bash, edit e MCP.

configuração settings.json

Configurar o permissions campo em ~/.claude/settings.json (Caminho do Windows: C:\Users\<username>\.claude\settings.json), o mesmo arquivo de configuração que contém suas credenciais de acesso:

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

O allow campo aprova chamadas de ferramenta correspondentes automaticamente e o deny campo rejeita chamadas de ferramenta correspondentes 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.

Interruptor CC é uma GUI de desktop comunitária de código aberto para gerenciar diversas chaves de API ou planos de faturamento. Alterne entre provedores com um clique, sem edição settings.json manualmente.

Instale o interruptor CC

• macOS: brew tap farion1231/ccswitch && brew install --cask cc-switchou baixe o .dmg de Lançamentos.
• Windows: baixe o .msi instalador ou portátil .zip de Lançamentos.
• Linux: no Arch, execute paru -S cc-switch-bin; em outras distribuições, baixe .deb/.rpm/.AppImage de Lançamentos.

Adicionar 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 com base na tabela abaixo e clique em Adicionar.

2. 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 modelos suportados para o seu plano. Exemplo de mapeamento:

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

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

Conecte o Claude Code Desktop

Claude Code Desktop (Claude Desktop) e 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 atinge QwenCloud através do gateway local do CC Switch: o CC Switch grava automaticamente o endereço do gateway e o token de autenticação na configuração da área de trabalho, para que você não insira seu QwenCloud Chave de API no aplicativo de desktop. O QwenCloud A chave API é inserida apenas na configuração do provedor do CC Switch e é injetada automaticamente quando o roteador local encaminha a solicitação.

Não insira manualmente seu QwenCloud Chave de API na configuração de inferência de terceiros do aplicativo de desktop. O token que o aplicativo de desktop usa para autenticar no gateway local do CC Switch (endereço http://127.0.0.1:15721/claude-desktop) é gerado e gravado automaticamente pelo CC Switch; entrando no QwenCloud A chave de API aqui falha na autenticação porque o token não corresponde. Atualmente, a gravação da configuração de desktop de terceiros é suportada apenas no macOS e no Windows.

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

2. No CC Switch, mude para o painel Claude Desktop no alternador de aplicativos à esquerda. Se a entrada não for exibida, vá para Configurações > Geral e certifique-se de que o Claude Desktop não esteja oculto na 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 + no canto superior direito para adicionar um. Porque QwenCloud IDs de modelo (como qwen3.7-max) não são os três IDs de função que Claude Desktop reconhece (claude-sonnet-* / claude-opus-* / claude-haiku-*), ative Mapeamento de modelo necessário e mapeie as funções Sonnet, Opus e Haiku para o real QwenCloud modelos a serem solicitados (por exemplo, Sonnet > qwen3.7-max).

4. Habilite o roteamento local: vá em Configurações > Roteamento > Roteamento local e ative Mostrar alternância de roteamento na página principal; retorne ao painel do Claude Desktop e ative a chave Roteamento local do Claude Desktop. O endereço de escuta padrão é 127.0.0.1:15721.

5. Clique em Ativar no cartão do provedor. O CC Switch grava automaticamente a configuração de inferência de terceiros no Claude Code Desktop.

6. Mantenha o CC Switch em execução e encerre e reinicie totalmente Claude Code Desktop para que as alterações tenham efeito. Selecione o modelo configurado no menu de modelos para começar a usá-lo.

Plug-ins IDE do Claude Code

Após concluir a configuração da 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. Pesquise Claude Code for VS Code no mercado de extensões e instale-o.
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 Configuração geral e defina o modelo em Modelo selecionado.

JetBrains

1. Pesquise Claude Code no mercado de extensões e instale-o.
2. Reinicie o IDE e clique no ícone no canto superior direito para começar a usá-lo.

Perguntas frequentes

Códigos de erro

Se você encontrar erros durante a configuração, consulte a documentação de perguntas frequentes do plano de cobrança correspondente:

• Pagamento conforme o uso: compatível com API Antrópica - Códigos de erro
• Plano de token (edição pessoal): Perguntas frequentes sobre o plano de token
• Plano de Token (Edição de Equipe): Perguntas frequentes sobre o Plano de Token (Edição de Equipe)

Solicitações retornam 401 inválido_api_key

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

Etapas de solução de problemas:

1. Verifique o URL da solicitação. Verifique ANTHROPIC_BASE_URL em ~/.claude/settings.json.
2. Confirme o tipo de chave de API. Usando a tabela acima, confirme se o tipo de chave de API corresponde ao URL base.
3. Corrija a configuração. Ao usar um QwenCloud Chave de API pré-paga, definida ANTHROPIC_BASE_URL para https://maas.qwencloudapi.com/apps/anthropic.

Após iniciar o Claude Code, a interface exibe "Não foi possível conectar aos serviços da Antrópico"

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

1. Verifique a configuração: Após iniciar o Claude Code, execute o /status comando e verifique se os valores de ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN apontar corretamente para o QwenCloud endereço. Se a saída estiver vazia ou apontar para um nãoQwenCloud endereço, verifique se o settings.json configuração está correta.

2. Verifique hasCompletedOnboarding: verifique se hasCompletedOnboarding está definido para true no ~/.claude.json arquivo. Caso contrário, Claude Code tentará se conectar ao serviço oficial da Anthropic para verificação de login na inicialização.

3. Reabra o terminal: Após modificar o arquivo de configuração, abra uma nova janela do terminal e execute o claude comando para que a configuração entre em vigor.

4. Atualizar o Claude Code: Se o problema persistir após todas as etapas acima, a versão do Claude Code pode estar desatualizada. Corre npm install -g @anthropic-ai/claude-code@latest para atualizar para a versão mais recente e tente novamente.

CC Switch relata "Nenhum endpoint de lista de modelos disponível encontrado" ao adicionar um provedor

Esta mensagem vem da verificação de conectividade que o CC Switch executa ao salvar um provedor: ele testa um endpoint da lista de modelos (como /v1/models) em relação ao URL de solicitação configurado. QwenCloudO endpoint compatível com Antrópico (terminando em /apps/anthropic) fornece apenas o endpoint de mensagens /v1/messages e não fornece um endpoint de lista de modelos, portanto, o probe retorna 404 e o CC Switch informa "Nenhum endpoint de lista de modelos disponível encontrado".

Esta mensagem não afeta o uso normal do Claude Code e pode ser ignorada. Claude Code envia conversas através /v1/messages, e os modelos que ele usa são especificados diretamente pelo mapeamento do modelo nas Opções avançadas do CC Switch, sem depender da descoberta automática de um endpoint da lista de modelos. Quando o URL de solicitação e a chave de API estiverem configurados corretamente, basta clicar em Ativar e iniciar uma nova sessão do Claude Code para conversar normalmente.

Se você ainda não conseguir conversar, verifique se o URL da solicitação termina em /apps/anthropic sem acréscimo /v1e que você preencheu os modelos suportados pelo seu plano no mapeamento do modelo em Opções avançadas.

Mapeamento de modelo no CC Switch retorna AccessDenied

Se as chamadas de modelo 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 descontinuação futura na guia QwenCloud Mercado Modelo. Os modelos marcados para suspensã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. Na página QwenCloud Mercado Modelo, procure o modelo que você está usando e verifique sua etiqueta de status.
2. Mude para o modelo mais recente disponível. Substitua o modelo legado (como qwen-coder-turbo-0919) no mapeamento do modelo com o modelo disponível mais recente (como qwen3.7-plus).
3. Reconfigure o mapeamento do modelo e teste. Atualize o mapeamento do modelo em Opções avançadas no CC Switch, clique em Ativar 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 QwenCloud A Galeria de Modelos pode ficar indisponível a qualquer momento. Você pode verificar o status de disponibilidade de um modelo lá.