Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

Guia de implantação do Claude Code

Abrange instalação, inicialização, integração de proxy, erros comuns e o fluxo completo de implantação.

Consulte primeiro a documentação oficial: docs.claude.com

📋 Pré-requisitos
Primeiro, conclua a instalação do ambiente Node.js e confirme que o Node.js 18+ está instalado corretamente.

⚡ Leitura obrigatória na primeira instalação: como evitar o erro de inicialização

Ao usar um serviço intermediário, a primeira inicialização do Claude Code apresenta o seguinte erro:

A imagem mostra a mensagem de erro exibida na primeira inicialização do Claude Code. Sobre um fundo preto, textos em vermelho e branco mostram “Welcome to Claude Code”, seguido por “Unable to connect to Anthropic services” e “Failed to connect to api.anthropic.com: ERR_BAD_REQUEST”. A tela recomenda verificar a conexão com a internet e as configurações de rede, informa que o Claude Code talvez não esteja disponível em seu país e apresenta o link do site oficial. A imagem está relacionada ao erro da primeira instalação descrito no documento e mostra visualmente seu conteúdo.A imagem mostra a mensagem de erro exibida na primeira inicialização do…

Welcome to Claude Code
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

Isso acontece porque, na primeira inicialização, o Claude Code tenta se conectar à API oficial para confirmar a configuração inicial, e o serviço intermediário não consegue concluir essa etapa. Depois da instalação e antes da primeira inicialização, use um dos métodos abaixo para ignorá-la:

Método um: usar o CC-Switch para ignorar a etapa (recomendado)

Baixe o instalador mais recente para macOS ou Windows na página de download do CC-Switch. Abra a ferramenta de configuração CC-Switch, acesse Configurações → Geral e ative a opção “Ignorar a confirmação da primeira instalação do Claude Code”.

A imagem mostra a aba “Geral” nas configurações do CC-Switch. Há várias opções na página; “Ignorar a confirmação da primeira instalação do Claude Code” está destacada por uma moldura vermelha e seu interruptor está ativado. A imagem está relacionada ao “Método um: usar o CC-Switch para ignorar a etapa (recomendado)” e mostra que, depois da instalação e antes da primeira inicialização, você deve abrir o CC-Switch, acessar Configurações → Geral e ativar essa opção.A imagem mostra a aba “Geral” nas configurações do CC-Switch. Há várias…

Método dois: alterar manualmente o arquivo de configuração

Localize o arquivo ~/.claude.json no diretório inicial do usuário e adicione o campo "hasCompletedOnboarding": true ao final:

⚠️ Atenção ao formato JSON
Antes de adicionar o campo, insira uma vírgula ao final do campo anterior; caso contrário, o JSON inválido impedirá o Claude Code de iniciar.
{
"installMethod": "unknown",
"autoUpdates": true,
"firstStartTime": "2025-07-14T06:11:03.877Z",
"userID": "xxxx",
"projects": {
"/home/your-user": {
"allowedTools": [],
"history": [],
"mcpContextUris": [],
"mcpServers": {},
"enabledMcpjsonServers": [],
"disabledMcpjsonServers": [],
"hasTrustDialogAccepted": false,
"projectOnboardingSeenCount": 0,
"hasClaudeMdExternalIncludesApproved": false,
"hasClaudeMdExternalIncludesWarningShown": false
}
},
"hasCompletedOnboarding": true
}

Depois de salvar a alteração, execute claude novamente para usar o programa normalmente.

Fonte de referência: Como ignorar a confirmação de inicialização do Claude Code

🚀 Configuração rápida com o CC-Switch (recomendado)

Se você já instalou a ferramenta de configuração rápida CC-Switch, pode gerenciar facilmente as configurações do Claude Code por uma interface gráfica, sem editar manualmente arquivos de configuração ou variáveis de ambiente.

Vantagens do CC-Switch

  • Interface gráfica simples e intuitiva
  • Alternância entre configurações de diferentes providers com um clique
  • Gerenciamento automático de variáveis de ambiente e arquivos de configuração
  • Backup e restauração de configurações
  • Alternância de configuração sem reiniciar o terminal

Etapas de configuração

  1. Inicie o CC-Switch e adicione uma configuração do Claude Code

A imagem mostra a tela para adicionar uma nova configuração no aplicativo CC-Switch. Na parte superior há as abas “Provider do Claude” e “Provider unificado”, com “Provider do Claude” selecionada. Abaixo aparecem as áreas “Providers predefinidos” e “Configuração personalizada”; esta última está destacada por uma moldura vermelha. A imagem corresponde à etapa “Inicie o CC-Switch e adicione uma configuração do Claude Code” e mostra onde selecionar a configuração personalizada.A imagem mostra a tela para adicionar uma nova configuração no aplicativ…

  • Abra o aplicativo CC-Switch
  • Clique na aba “Claude” na parte superior
  • Clique no botão laranja “+” no canto superior direito para adicionar uma nova configuração

A imagem mostra a tela para adicionar uma nova configuração no aplicativo CC-Switch. O campo “API Key” exibe um valor mascarado e orienta a inserir a key fornecida pelo atendimento ao cliente, iniciada por “sk”. O campo “Endereço da solicitação” mostra “https://gpt-agent.cc”, acompanhado por um aviso amarelo para inserir um endpoint de serviço compatível com a API do Claude, sem uma barra no final. A imagem está relacionada à etapa “Preencha as informações de configuração do provider” e mostra um exemplo de preenchimento de API Key e endereço da solicitação.A imagem mostra a tela para adicionar uma nova configuração no aplicativ…

  1. Preencha as informações de configuração do provider
  • Nome do provider: um nome personalizado (como "guizhou")
  • API Base URL: insira https://api.llm-token.cn
  • API Key: cole a key do token exclusivo do Claude obtida na plataforma
  • Seleção do modelo: escolha um modelo Claude disponível conforme suas necessidades
  • Clique no botão “Salvar”
💡 Dica
  • Você pode adicionar configurações de vários providers diferentes (como o oficial, Guizhou Cloud etc.)
  • O CC-Switch altera automaticamente o arquivo de configuração ~/.claude/settings.json
  • Depois de trocar a configuração, feche e reinicie o Claude Code para aplicar a mudança
  1. Ative e use a configuração
  • Localize na lista a configuração “gptagent” que você acabou de criar
  • Clique no botão “Em uso” à direita da configuração (ou clique diretamente no cartão da configuração)
  • A configuração será marcada como “Em uso” (etiqueta verde)
  • Reinicie o Claude Code para aplicar a nova configuração
  1. Alternância rápida pela bandeja do sistema

O CC-Switch permite alternar rapidamente entre configurações pela bandeja do sistema:

  • Clique com o botão direito no ícone do CC-Switch na bandeja do sistema
  • Selecione a categoria Claude no menu
  • Selecione diretamente a configuração desejada
  • A configuração entra em vigor imediatamente, sem abrir a interface principal
⚠️ Observações
  • Depois de trocar a configuração, você precisa reiniciar o Claude Code para aplicar a mudança
  • Você pode testar a velocidade do endpoint da API no CC-Switch e escolher a melhor configuração

Não consegue conversar depois da configuração?

Tente fazer isto; se ainda não funcionar, entre em contato com o atendimento ao cliente

A imagem mostra a interface do CC Switch, com o título “CC Switch” e vários ícones na parte superior. Uma seta vermelha aponta para a opção “Guizhou Cloud Computing” à esquerda; à direita aparece o endereço “https://gpt-agent.cc/” e a indicação “Falha na consulta”. A imagem está relacionada à seção “Não consegue conversar depois da configuração? Tente fazer isto; se ainda não funcionar, entre em contato com o atendimento ao cliente” e possivelmente orienta você a clicar nessa opção para verificar o problema ou buscar atendimento.A imagem mostra a interface do CC Switch, com o título “CC Switch” e vár…

A imagem mostra as configurações do CC Switch na aba “Proxy”. O status do “Proxy local” aparece como “Em execução”, com uma seta azul apontando para ele. Também há opções como “Failover automático”, “Retificador” e “Proxy de saída global”. A imagem está relacionada à solução de problemas de conversa após a configuração e orienta você a verificar o status do serviço de proxy do CC Switch.A imagem mostra as configurações do CC Switch na aba “Proxy”. O status d…

A imagem mostra o conteúdo da aba “Código” na página de configurações do guia de implantação do Claude Code. Na parte superior há opções como “Voltar à página inicial” e “Sobre”. Entre as informações principais, é possível selecionar modelos de versões de linguagens populares para desenvolvimento com implantação local por proxy; o interruptor do proxy está ativado. Na seção de código, o modelo Claude está ativado, enquanto Codex e Gemini estão desativados. Também aparecem endereço da API, chave da API e registro de logs do aplicativo, com o registro de logs ativado. A imagem está relacionada à solução para problemas de conversa após a configuração e mostra visualmente essas opções.A imagem mostra o conteúdo da aba “Código” na página de configurações do…

⌨️ Configuração manual pela linha de comando

Se você não usa o CC-Switch, também pode configurar o Claude Code manualmente pela linha de comando.

🖥️ Windows

Requisitos do sistema

Windows 10, 11

Etapas de instalação

Método um: Native Install (recomendado)

No PowerShell:

irm https://claude.ai/install.ps1 | iex

No CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Método dois: instalação via NPM (não recomendado)

⚠️ A instalação via npm não é recomendada
As atualizações pelo canal npm chegam com atraso e a versão instalada geralmente é mais antiga. Dê preferência ao método Native acima.
npm install -g @anthropic-ai/claude-code

Verifique a instalação:

claude --version

Configure as variáveis de ambiente

No PowerShell:

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.llm-token.cn", "User")

No CMD:

setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
setx ANTHROPIC_BASE_URL "https://api.llm-token.cn"
💡 Dica
Substitua sk-xxx pela sua própria key exclusiva! Depois da configuração, reinicie o terminal para aplicar as variáveis de ambiente.
  • Inicie o Claude

No terminal, entre no diretório do projeto (com cd) ou permaneça em qualquer diretório e digite o comando claude para iniciar.

🍏 macOS

Requisitos do sistema

MacOS 10.15 (Catalina) ou posterior

Etapas de instalação

Método um: Homebrew (recomendado)

brew install --cask claude-code

Método dois: Curl Script

curl -fsSL https://claude.ai/install.sh | bash

Método três: instalação via NPM (não recomendado)

⚠️ A instalação via npm não é recomendada
As atualizações pelo canal npm chegam com atraso e a versão instalada geralmente é mais antiga. Dê preferência ao método Native acima.
npm install -g @anthropic-ai/claude-code

Verifique a instalação

claude -v

Em condições normais, a saída será semelhante a: 1.0.108 (Claude Code)

Configure as variáveis de ambiente

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.llm-token.cn"' >> ~/.zshrc
source ~/.zshrc
💡 Dica
Substitua sk-xxx pela sua própria key exclusiva!

Reinicie o terminal e inicie o Claude

Depois de reiniciar o terminal, entre no diretório do projeto (com cd) ou permaneça em qualquer diretório e digite o comando claude para iniciar.

🐧 Linux

Requisitos do sistema

Distribuição Linux (Ubuntu 18.04+, CentOS 7+, Debian 9+ etc.)

Etapas de instalação

Método um: Curl Script (recomendado)

curl -fsSL https://claude.ai/install.sh | bash

Método dois: instalação via NPM (não recomendado)

⚠️ A instalação via npm não é recomendada
As atualizações pelo canal npm chegam com atraso e a versão instalada geralmente é mais antiga. Dê preferência ao método Native acima.
npm install -g @anthropic-ai/claude-code

Verifique a instalação

claude -v

Configure as variáveis de ambiente

Ubuntu/Debian (Bash)

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.llm-token.cn"' >> ~/.bashrc
source ~/.bashrc

Fedora/CentOS (Zsh)

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.llm-token.cn"' >> ~/.zshrc
source ~/.zshrc
💡 Dica
Substitua sk-xxx pela sua própria key exclusiva!

Reinicie o terminal e inicie o Claude

Depois de reiniciar o terminal, entre no diretório do projeto (com cd) ou permaneça em qualquer diretório e digite o comando claude para iniciar.

Perguntas frequentes

O comando não foi encontrado?

  • Confirme que o Claude Code foi instalado corretamente
  • Verifique a variável de ambiente PATH
  • Reinicie a janela do terminal

Falha na conexão?

  • Verifique a conexão de rede
  • Confirme que a API Key está correta
  • Verifique se há saldo suficiente

Tutorial de configuração do Cherry Studio

Capturas de tela mostram onde preencher o provedor personalizado, a Base URL e a API Key.

Guia de implantação do Codex

Explica a instalação da ferramenta CLI, a integração da API e a configuração do ambiente de desenvolvimento.

Seções desta página

⚡ Leitura obrigatória na primeira instalação: como evitar o erro de inicializaçãoMétodo um: usar o CC-Switch para ignorar a etapa (recomendado)Método dois: alterar manualmente o arquivo de configuração🚀 Configuração rápida com o CC-Switch (recomendado)Vantagens do CC-SwitchEtapas de configuraçãoNão consegue conversar depois da configuração?⌨️ Configuração manual pela linha de comando🖥️ WindowsRequisitos do sistemaEtapas de instalaçãoConfigure as variáveis de ambiente🍏 macOSRequisitos do sistemaEtapas de instalaçãoVerifique a instalaçãoConfigure as variáveis de ambienteReinicie o terminal e inicie o Claude🐧 LinuxRequisitos do sistemaEtapas de instalaçãoVerifique a instalaçãoConfigure as variáveis de ambienteReinicie o terminal e inicie o ClaudePerguntas frequentesO comando não foi encontrado?Falha na conexão?