Recentemente, muitos amigos têm me perguntado se eu poderia lançar um tutorial para iniciantes sobre o Claude Code.
Eles também querem usar o produto de Agente mais poderoso do mundo.
Na verdade, muitas pessoas não percebem que os produtos de Agente são geralmente compostos por um framework de Agente e um modelo. Os modelos da Claude são frequentemente bloqueados na China e são muito difíceis de gerenciar; não tenho como ensinar todo mundo a resolver isso.
Mas o Claude Code não será bloqueado ou se tornará inutilizável porque, na verdade, é um framework de Agente que pode ser usado com qualquer modelo.
Embora a Anthropic possa ser bastante irritante com banimentos constantes de contas e autenticação por nome real, ainda tenho que admitir que o melhor framework de Agente do mundo atualmente é o Claude Code.
É por isso que sempre digo: se você pode acertar de primeira, faça isso. Eu sei que coisas como OpenClaw e Hermes Agent são muito populares agora, mas ainda recomendo usar o Claude Code. Mesmo que você não possa usar os modelos nativos da Claude, combiná-lo com um modelo nacional ainda produz excelentes resultados.
Além disso, você não precisa se preocupar com banimentos de conta, números de telefone estrangeiros, cartões Visa ou até mesmo usar uma VPN.
Então, hoje, aqui está um tutorial completo para iniciantes sobre o Claude Code do zero. Preparei instruções para Windows e Mac, com e sem VPN, para que todos possam seguir a parte de que precisam.
O processo de instalação a seguir foi testado em cinco ou seis computadores durante um fim de semana inteiro por mim e minha equipe, por meio de instalações e desinstalações repetidas.
Por exemplo, em cenários sem VPN, existem outros métodos de instalação, como npm ou o uso de fontes de espelho domésticas via curl. Esses métodos funcionam, mas não eram estáveis o suficiente em diferentes computadores nos meus testes.
Então, finalmente, escolhi o método que acredito ser o mais simples e com menor probabilidade de falhar, mesmo em um computador muito "limpo".
Só espero que todos consigam usar com sucesso o framework de Agente mais poderoso do mundo seguindo este artigo.
Vou explicar cada passo da forma mais clara e detalhada possível. Pode ser um pouco prolixo, então peço sua paciência.
Ok, vamos começar.
I. Instalação do Claude Code
1. Mac
Vamos olhar para o Mac primeiro. Usuários de Windows podem pular esta parte e encontrar o tutorial para Windows abaixo.
Primeiro, encontre o Terminal em seus Aplicativos e abra-o.
Vamos instalar o protagonista de hoje, o Claude Code.
Criei uma nova conta no macOS para o meu computador, que é basicamente equivalente a um computador limpo, para esta demonstração.
Primeiro, vamos falar sobre o caso com VPN.
O comando é apenas uma linha:
Cole este comando no terminal e pressione Enter.
Aguarde um momento e você verá uma instalação bem-sucedida.
Embora esteja instalado, pode ser que ele lhe dê um aviso aqui.
Isso significa que o Claude Code está instalado, mas o local de instalação ~/.local/bin não foi adicionado à sua variável de ambiente PATH, então digitar claude diretamente pode não encontrar o comando.
Diz que para resolver isso, execute o comando fornecido abaixo.
Se você não entender, tudo bem. Apenas siga as instruções: copie aquele comando echo longo que ele lhe deu no terminal e execute-o.
Em seguida, digite claude --version. Se um número de versão for exibido, a instalação foi bem-sucedida.
A situação com VPN é muito simples, mas sei que muitos alunos não têm uma.
Então, se você não tem VPN, podemos instalar via Homebrew.
Homebrew é o gerenciador de pacotes de linha de comando mais popular no macOS. Ele permite instalar, atualizar e desinstalar vários softwares e ferramentas de desenvolvimento com um único comando.
Peguei um computador novo emprestado de um colega; ele não tem VPN e um ambiente muito limpo.
Vamos instalar o brew primeiro. Pode parecer complicado, mas na verdade é muito simples se você seguir em frente.
Cole o seguinte comando na linha de comando e pressione Enter:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.shhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))"
Após o aviso, apenas pressione Enter.
Então, ele será executado por um tempo.
Aguarde pacientemente alguns minutos. Quando terminar e disser que a instalação foi bem-sucedida, está pronto.
Em seguida, precisamos adicionar o Homebrew às variáveis de caminho para que o terminal possa encontrar o comando quando o usarmos.
Cole estas poucas linhas de comandos no terminal e execute-as uma vez.
Agora podemos usar o Homebrew para gerenciar pacotes do Mac.
Em seguida, use o seguinte comando para instalar o Claude Code. Como o editor pode formatar automaticamente algum texto, copiar e colar diretamente pode causar erros. Por favor, digite manualmente ou peça ao Claude para corrigir o formato antes de colar no terminal:
brew install --cask claude-code@latest
A velocidade de instalação aqui é um pouco lenta; você pode fazer uma pausa e voltar quando terminar.
Assim que a mensagem de sucesso aparecer, digite claude no terminal e você verá o pequeno caranguejo.
No entanto, ele mostrará que está inutilizável por enquanto. Você pode ignorar isso; vou te ensinar como conectar um modelo daqui a pouco.
Agora que cobrimos o Mac, vamos falar sobre o Windows separadamente. É um pouco diferente. Usuários de Mac que terminaram podem pular esta parte.
2. Windows
Agora para o Windows.
Usei uma máquina Windows recém-formatada para instalar.
Como o Claude Code executa comandos internamente usando o Git Bash no Windows, você deve instalar o Git primeiro para usar o Claude Code no Windows.
Então, passo um: instalar o Git.
Amigos que já o têm instalado podem pular isso.
Use o WinGet para instalá-lo. Este é o gerenciador de pacotes oficial do Windows, que pode ser considerado a versão Windows do Homebrew.
Pesquise por "Terminal" na barra de tarefas e abra-o.
Cole o seguinte comando no terminal. A instalação será muito mais rápida se você não usar uma VPN aqui.
winget install Git.Git
Quando terminar, ele mostrará uma instalação bem-sucedida.
Assim que o Git estiver instalado, como de costume, vamos falar sobre o caso com VPN.
Para amigos com VPN, ainda usamos o comando de instalação nativo oficial.
Cole o comando no terminal:
Aguarde um momento e ele será instalado.
Muito conveniente.
Se você não tem VPN, devemos usar o WinGet para instalá-lo.
Execute este comando no terminal:
winget install Anthropic.ClaudeCode
Após a instalação bem-sucedida, você também pode digitar claude para ver que foi instalado.
Neste ponto, teoricamente, digitar claude no terminal deve levá-lo à página do Claude Code.
Mas.
Nós apenas instalamos o framework; ainda não demos a ele um "cérebro", então não está utilizável.
Em seguida, precisamos conectar seu cérebro.
II. Conectando o Modelo
Se você tem uma conta Claude, basta fazer login diretamente. Não vou entrar em detalhes aqui.
Porque, teoricamente, se você já tem uma conta Claude, não estaria lendo este tutorial para iniciantes...
Então, para garantir que todos os amigos domésticos possam usar, vou usar o modelo doméstico GLM-5.1 como exemplo.
O GLM-5.1 é atualmente o modelo doméstico que usei e que mais se aproxima da experiência do Claude Opus 4.6.
Claro, se você não pegou o plano de codificação deles, o MiniMax M2.7 e o K2.5 também são bons. O código K2.6 deve sair em breve, e sinto que o Kimi terá um salto também; recomendo ficar de olho.
Em relação ao GLM-5.1, a Zhipu oficial fornece um comando de uma linha para instalá-lo, o que é muito simples:
No entanto, para facilitar a conexão de outros modelos e a troca livre, vou ensinar um método mais universal: usar o CC Switch.
Novamente, dividido em Mac e Windows.
1. Mac
No Mac, a instalação é de apenas dois comandos. O segundo comando também pode dar erro se copiado e colado diretamente devido à formatação. Por favor, digite manualmente ou peça ao Claude para corrigir o formato antes de colar:
brew tap farion1231/ccswitch
brew install --cask cc-switch
Cole no terminal e pressione Enter.
Assim que estiver instalado, está pronto.
2. Windows
Para Windows, recomendo baixar o pacote de instalação diretamente do link abaixo:
https://github.com/farion1231/cc-switch/releases
Se você não consegue acessar o GitHub, também preparei um pacote de instalação local. Responda com "cc" no fundo da conta oficial, e ele enviará automaticamente o link de download para você.
Após o download, clique duas vezes para executar e você pode clicar em "Avançar" até o final para concluir a instalação.
As operações subsequentes são as mesmas para Mac e Windows, então não vou separá-las.
Após a instalação, abra-o.
Você pode ver que esta ferramenta não é apenas para o Claude Code; Codex e Xiaolongxia também podem usá-la.
Como ainda não configuramos, atualmente existem apenas configurações oficiais do modelo Claude.
Na coluna Claude, clique no sinal de mais no canto superior direito para adicionar uma nova configuração de modelo.
Em seguida, selecione o modelo que deseja usar. Aqui, escolhi a versão doméstica do GLM.
Em seguida, você só precisa preencher duas partes: a chave da API (se você não sabe o que é uma chave de API, pode perguntar a qualquer IA que você tenha acesso, e ela o ajudará) e a configuração do modelo. Todo o resto será preenchido automaticamente.
Depois de preenchido, clique em "Adicionar" no canto inferior direito.
Ele mudará para o modelo que configuramos.
Neste ponto, a instalação do Claude Code e a conexão do GLM-5.1 estão completas.
III. Iniciando o Claude Code
Volte ao terminal, digite claude e pressione Enter.
Agora você pode iniciar o Claude Code normalmente.
Para o primeiro uso, haverá algumas configurações de inicialização.
Por exemplo, o modo de cor. Há uma prévia do código abaixo dos modos; escolha de acordo com sua preferência e pressione Enter.
Se quiser mudar depois, execute /theme dentro do Claude Code.
Em seguida, o aviso de segurança.
Dois pontos principais:
Um é que o Claude pode cometer erros. Você deve revisar o código que ele gera e os comandos que ele quer executar antes de permiti-los.
Um é usar o Claude Code apenas em bases de código confiáveis para evitar ataques de injeção de prompt.
Pressione Enter para ir para a próxima etapa.
Ele pergunta se queremos usar as configurações de terminal do Claude Code.
Aqui, use as configurações de terminal recomendadas.
Na verdade, ele quer ajudá-lo a ativar duas coisas:
Teclas de atalho para conseguir quebras de linha no terminal.
A outra é o Visual Bell, um aviso visual.
Ou seja, quando o Claude termina uma tarefa ou precisa de sua confirmação, a janela do terminal piscará e o ícone do Dock saltará para lembrá-lo.
A etapa final é confirmar se o diretório atual pode ser confiável.
Selecione "Sim" e pressione Enter.
Finalmente chegamos à interface de diálogo do Claude Code conectado ao GLM-5.1.
Se quiser trocar de modelo depois, configure-os no CC Switch e use /model no Claude Code para trocar.
Neste ponto, todas as operações de instalação e conexão estão completas.
Para uso futuro, basta digitar claude no terminal.
Recomendo usar o seguinte comando, especialmente durante o desenvolvimento, caso contrário, clicar em "Permitir" repetidamente fará você questionar suas escolhas de vida:
claude --dangerously-skip-permissions
Quando o iniciamos, devido ao design do contexto, precisamos iniciá-lo em uma pasta para mantê-lo contido e focado, em vez de iniciar o Claude Code diretamente no diretório raiz.
Eu dividi meus diretórios; "Documentos" é onde faço criação de conhecimento.
Há também uma pasta "code", que contém vários produtos que desenvolvi eu mesmo.
Iniciar o Claude Code para uma pasta específica na linha de comando também é muito simples.
É o comando cd, que é o mesmo para Mac e Windows.
Por exemplo, se eu quiser entrar na pasta "Base de Conhecimento" para criar conteúdo:
Abra o terminal, digite cd, lembre-se de pressionar a barra de espaço uma vez e, em seguida, arraste sua pasta diretamente para ele.
Pressione Enter e você entrou naquela pasta.
Em seguida, use o comando para iniciar o Claude Code.
Você entrará naquela pasta, e ele trabalhará apenas dentro dessa pasta por padrão, lendo todos os arquivos dentro dela.
Isso, na verdade, resulta em menos poluição de contexto e mais foco — em outras palavras, é mais inteligente.
IV. Escrevendo o CLAUDE.md
Depois de aprender como iniciá-lo, você pode começar oficialmente o diálogo e deixá-lo trabalhar.
Mas há um padrão e um hábito muito importante que você precisa definir antes do uso profundo. Não caia nas mesmas armadilhas antigas que eu: defina seu arquivo CLAUDE.md primeiro.
Na minha opinião, esta é até a primeira coisa que você deve fazer depois de aprender a iniciar o Claude Code.
Antes de entrar no estilo de escrita específico, deixe-me falar sobre o que é CLAUDE.md.
Esta coisa não é apenas um arquivo; é um sistema de restrição hierárquico de cima para baixo.
Como esta imagem que usei antes.
Após a instalação, as duas camadas que devemos gerenciar são o CLAUDE.md global e o CLAUDE.md do projeto.
O CLAUDE.md global é colocado no diretório raiz do Claude Code no diretório inicial do usuário: ~/.claude/CLAUDE.md.
Contanto que você abra o Claude Code, não importa em qual projeto você entre, ele será carregado automaticamente e seguido.
Esta é sua especificação de nível superior.
Ela resolve problemas como quem você é, seus princípios de fazer as coisas e como você quer que ele colabore com você.
O CLAUDE.md de nível de projeto é colocado no diretório raiz de cada projeto: project_directory/CLAUDE.md.
Ele é carregado apenas quando você abre aquele projeto.
Ele resolve o problema de como este projeto específico deve ser feito e quais acordos especiais existem neste nível.
Vamos falar primeiro sobre o CLAUDE.md global, que é a primeira coisa que precisa ser resolvida. Mas muitas pessoas não têm clareza sobre o que escrever, como escrever, quanto tempo deve ter ou onde colocá-lo. Para não desenvolvedores, vou compartilhar minha experiência.
Em relação ao comprimento, CLAUDE.md não é melhor se for mais longo; em vez disso, deve ser o mais conciso possível.
Se o seu CLAUDE.md for muito longo, ele simplesmente ignorará o conteúdo na segunda metade.
A linha vermelha específica é esta: além de 80 linhas, o Claude começa a perder algum conteúdo. No máximo, nunca exceda 200 linhas.
Em um artigo anterior, mostrei a vocês o que está no meu arquivo CLAUDE.md global.
Com base no meu conteúdo, iterei e preparei um modelo para você.
Ele contém coisas que acho que um bom CLAUDE.md global deve ter.
Você só precisa escrever seu próprio conteúdo na seção "Sobre Mim"; o resto pode ser basicamente reutilizado diretamente.
Sobre Mim [Seu nome / identidade / formação profissional, se você não é programador, deve declarar]. Eu uso o Claude Code para [Uso Específico 1] e [Uso Específico 2].
Princípios de Pensamento: Todas as decisões partem da essência do problema, não copie apenas porque "esta é a convenção." Volte ao problema em si: O que precisa ser resolvido? Qual é o caminho mais direto? Como seria projetado do zero? Não bajule. Não elogie minhas ideias, não diga "esta é uma pergunta muito boa", não adicione "claro" no início. Dê-me julgamentos reais; se houver um problema com o plano, aponte-o diretamente. Se você encontrar uma maneira melhor, diga-a diretamente sem esperar que eu pergunte.
Restrições Primeiro: Seja um projeto de desenvolvimento ou um projeto de gerenciamento de conhecimento, o primeiro passo é sempre estabelecer regras: escreva o CLAUDE.md para novos projetos primeiro e defina convenções estruturais para novos diretórios (o que vai onde, como nomear, quando limpar). Não trabalhe em um espaço de trabalho sem especificações. Para projetos com especificações existentes, cumpra rigorosamente os acordos em seu CLAUDE.md. Ao ajustar especificações, mude o documento primeiro, depois a prática, não o contrário.
Estilo de Comunicação - Padrão em Chinês, use inglês para código, comandos e nomes de variáveis - Conclusão primeiro, depois razões, não prepare o terreno com antecedência - Ao encontrar requisitos vagos, dê o plano mais razoável primeiro, depois pergunte se ajustes são necessários - Não pergunte "tem certeza de que quer fazer isso" a menos que atinja as linhas vermelhas abaixo
Limites Autônomos (Linhas vermelhas, deve me perguntar primeiro) As seguintes operações devem parar e me perguntar, mesmo no modo de aceitação automática: - Excluir arquivos, diretórios ou histórico do git - Modificar .env, chaves, tokens, configurações de CI/CD - Alterações de esquema de banco de dados ou migrações de dados - git push, git rebase, git reset --hard, force push - Instalar novas dependências globais ou modificar configurações do sistema - Lançamento público (npm publish, implantar em produção, publicar artigos, etc.)
Disciplina Geral de Engenharia - Execute ativamente a verificação após as alterações (veja o CLAUDE.md de cada projeto para comandos específicos), não apenas altere sem verificar - Não comente erros ou adicione marcadores de desvio apenas para fazer o código funcionar; encontre a causa raiz - Chaves, tokens e senhas não entram em código, commits ou logs - Antes de grandes alterações, forneça um plano no Modo de Planejamento; só prossa após minha confirmação
Cerca de 30 linhas no total, divididas em seis partes.
Esses seis blocos têm uma característica comum: são universais entre projetos.
Assim que o CLAUDE.md global estiver definido, temos nossas especificações de nível superior.
Quanto à próxima camada, o CLAUDE.md do projeto.
Tome eu mesmo como exemplo.
Eu uso principalmente o Claude Code para desenvolvimento e gerenciamento de conhecimento.
Por exemplo, há um CLAUDE.md no meu diretório code/my. Seu papel é principalmente porque as coisas que costumo codificar na pasta my são frequentemente coisas bagunçadas, experimentais ou únicas, que são na verdade muito pequenas, então estou realmente com preguiça de criar uma nova pasta dentro de my toda vez.
Então, minha prática comum atual é usar cd diretamente para a pasta my para iniciar e, em seguida, começar feliz a declarar meus requisitos para me ajudar a codificar. Com este arquivo CLAUDE.md, ele julgará por si mesmo se este é um novo produto. Se for, ele me ajudará diretamente a criar uma nova pasta para começar, então todo o gerenciamento de arquivos se torna organizado.
E você nem precisa escrever este arquivo sozinho. Basta abrir essa pasta e conversar com o Claude Code. Discuta diretamente seus requisitos e as coisas que você se importa com ele e peça para ele escrever um para você.
Também tenho trabalhado duro com meu Claude Code nos últimos dias para estabelecer várias especificações e organizar as várias "montanhas de merda" de código que deixei para trás antes.
Se você não tem nada no seu computador agora, é ainda mais conveniente.
Esta é uma das razões pelas quais sempre enfatizei restrições primeiro e especificações primeiro.
Assim que as restrições são definidas, você pode realmente começar a brincar.
Quanto a habilidades, plugins, comandos comuns e funções.
Não vou me alongar aqui. Já escrevi muitos artigos relacionados; amigos interessados podem pesquisar as palavras-chave correspondentes.
Palavras Finais
Finalmente terminei este tutorial para iniciantes sobre o Claude Code, que há muito tempo estava pendente.
O Claude Code é a "ferramenta de graduação" da era atual da IA que recomendo a você.
Você não precisa usar todos aqueles Agentes bagunçados. Use bem o Claude Code e você realmente sentirá o que é o Agente mais poderoso.
Espero que todos possam criar felizes.
E fazer obras que pertencem a você nesta era.
Suas próprias obras.
