Por dois meses, quis escrever um guia para iniciantes sobre o CC, e hoje finalmente consigo.
O Claude Code (CC, para abreviar) é o meu produto de IA mais recomendado do ano, sem dúvida.
Embora se chame Claude Code, suas funcionalidades vão muito além de escrever código; é um verdadeiro Agente de uso geral.
Muitas tarefas tediosas no computador podem ser resolvidas pelo CC com apenas uma frase.
Eu o uso para perguntas e respostas, escrever, criar páginas web, desenvolver software, analisar dados e até dividir recibos de pagamento.
Ele ainda me ajuda a sintetizar rapidamente áudio e imagens em vídeos.
Pensando no CC, eu até escrevi um lançador de código aberto chamado Claude Code Now, que já alcançou 400 estrelas no GitHub.
O CC também é o software que fez o famoso pesquisador da OpenAI, AK, sentir que estava ficando para trás.
Esta é uma conversa entre o autor do CC e o AK — basta apontar o CC para o alvo e ele derrete seus problemas!
Tenho recomendado o CC para colegas e amigos, e toda vez que o usam, exclamam como essa IA é inteligente.
No entanto, não é tão fácil recomendar o CC porque o CEO da Anthropic é um pouco implacável...
Os bloqueios de conta são tão frequentes — às vezes três vezes por mês — que é difícil de suportar.
Afinal, a receita anual do Claude Code é de 1 bilhão de dólares; o CEO parece não se importar muito com os usuários na China.
Então, esperei por um momento: quando as capacidades de codificação dos modelos open-source nacionais ultrapassassem o limite.
Na segunda-feira, meu amigo Yang Pan disse animadamente em um grupo que o momento chegou!
Agora, finalmente existe um modelo open-source que pode ser verdadeiramente usado dentro do Claude Code.
Finalmente posso escrever um guia para iniciantes do Claude Code para novatos.
Um lembrete amigável: este artigo é bastante longo. Seguir os passos levará cerca de uma hora, então talvez você queira favoritá-lo primeiro.
Se seus amigos também quiserem experimentar a IA mais inteligente em um computador, não deixe de encaminhar este artigo para eles!
Guia de Instalação do Claude Code
I. Preparação Básica
- Prepare um ambiente de rede estável.
- Instale a versão mais recente do Node.js aqui: https://nodejs.org/en/download/
- Usuários do Windows também precisam instalar o Git for Windows: https://git-scm.com/install/windows
II. Iniciando Formalmente a Instalação do CC
- Pesquise por "Terminal" no seu computador e abra-o. Parece com isto — não tenha medo, apenas pense nele como uma caixa de chat de IA com visual legal.
- No terminal, cole o seguinte comando e pressione Enter: npm install -g @anthropic-ai/claude-code
Você pode encontrar vários erros aqui. Se já tiver instalado outras ferramentas de programação de IA, como o Cursor, recomendo fortemente instalá-lo dentro dessas ferramentas; elas ajudarão a resolver problemas.
Se não tiver outras ferramentas, pode pedir a qualquer IA para ajudar a resolver os erros.
- Se o método 2 falhar, tente o seguinte:
Se você estiver no macOS, Linux ou WSL, cole este comando e pressione Enter:
Se você estiver no Windows, cole este comando e pressione Enter:
Após a instalação, digite claude --version. Se um número de versão aparecer, a instalação foi bem-sucedida.
A nova versão do Claude Code adicionou uma etapa de verificação irritante; podemos pulá-la com este método.
Adicione o item de configuração "hasCompletedOnboarding": true ao ~/.claude.json. Se o arquivo não existir, crie-o manualmente.
Deve ficar assim:
{ // ... outras configurações "hasCompletedOnboarding": true }
III. Adquirindo um Plano de Servidor CC
Como mencionado, o CC oficial é implacável com bloqueios, então não recomendo a assinatura oficial. Se você consegue lidar com o oficial, admiro você, mas provavelmente não estaria lendo isto.
Existem três modelos nacionais com bom suporte para CC: GLM 4.7, MiniMax M2.1 e Kimi K2.
Aqui, usaremos a configuração do GLM 4.7 como exemplo. Como é um site nacional, é mais fácil de usar. Outros modelos têm Planos de Codificação semelhantes.
- Registre uma conta. Visite a Plataforma Aberta Zhipu AI (https://open.bigmodel.cn/), clique em "Registrar/Entrar" no canto superior direito e siga as instruções.
- Obtenha uma Chave de API. No centro pessoal, clique em Chaves de API para criar uma nova e copie-a para usar depois.
- Assine um Plano de Codificação. Com um plano, você pode usá-lo livremente sem se preocupar com problemas inesperados de saldo.
Atualmente, há uma promoção de Ano Novo: recomendo fortemente o plano trimestral Coding Lite. Custa apenas 54 RMB por três meses — praticamente de graça.
Você pode comprá-lo aqui: https://www.bigmodel.cn/glm-coding?ic=KSGMCBOXUT
IV. Configurando o Servidor CC
Depois de ter o Plano de Codificação, você pode configurá-lo.
Usaremos uma nova ferramenta chamada Coding Tool Helper.
Esta ferramenta facilita a importação de configurações do servidor GLM para o CC.
- Volte ao terminal, digite o seguinte comando e pressione Enter:
npx @z_ai/coding-helper
- Você verá uma interface amigável em chinês.
- Siga as instruções da ferramenta, cole a Chave de API que você obteve antes e complete os passos um por um.
V. Iniciando o Claude Code!
🎉 Parabéns, você instalou a ferramenta de IA mais poderosa disponível. Respire fundo.
Beba um pouco de água e inicie-a!
Espera, como você inicia?
No terminal, basta digitar claude e pressionar Enter. Você verá a interface abaixo.
Diga olá e apresente-se!
A partir de agora, este é seu assistente multifuncional.
Você pode não estar acostumado a essa forma de abrir. Tudo bem; você pode instalar o lançador que escrevi, Claude Code Now, em https://claudecodenow.com/
Após a instalação, você pode ver o Claude Code em qualquer pasta. Basta clicar para iniciar — super conveniente.
VI. Dicas de Uso do Claude Code
Há muito o que aprender com o Claude Code.
Mas o básico se resume a três coisas, centradas em entender como o CC funciona.
Você pode pensar no CC como um agente que pode operar seu sistema. Ele pode ver seu computador, ler arquivos, operar arquivos, analisar arquivos e gerar arquivos.
Você se comunica com ele por conversa natural; não precisa escrever uma única linha de código.
- Pastas
Pastas são o melhor conceito de design do CC; são o playground do CC.
Quando o CC inicia, você precisa especificar uma pasta, que serve como contexto para a tarefa.
Sugiro fortemente criar uma pasta dedicada ao Claude Code para vários projetos do CC.
Abaixo está minha pasta do CC. Eu a uso para anotações, análise de dados, leitura aprofundada e desenvolvimento de software. Cada tarefa tem sua própria pasta para não interferirem umas nas outras.
Há duas maneiras de especificar uma pasta: uma é usando o Claude Code Now como mencionado acima. A outra é arrastar a pasta para o CC; ele a lerá automaticamente.
Os arquivos funcionam da mesma forma — você pode arrastá-los diretamente para o CC. Esta é a primeira dica muito importante.
- O Arquivo Claude.md
O arquivo Claude.md é o arquivo de configuração principal do CC e sua memória de longo prazo.
Você pode pensar neste arquivo como a constituição do CC.
Toda vez que o CC inicia, ele carrega automaticamente este arquivo, que registra o que você quer fazer e as regras que você deu ao CC.
Você também pode fazer o CC criar este arquivo ele mesmo e dizer a ele quais informações você considera importantes.
- Modo Perigoso
O que é Modo Perigoso?
Como o nome sugere, uma vez ativado, o CC pode automatizar completamente seu computador sem nenhuma confirmação sua.
Parece perigoso, mas se você não ativá-lo, terá que confirmar cada operação, o que é tedioso e mata a eficiência.
Se você usa o Claude Code Now como lançador, já ativei o Modo Perigoso para você.
Se não, você pode ativá-lo manualmente com este código:
claude --dangerously-skip-permissions
No entanto, uma vez ativado, o CC pode causar danos irreparáveis, então certifique-se de especificar a pasta correta e manter backups.
Agora que os três pontos importantes foram abordados, aqui vai uma dica muito prática: Colar Imagens.
Com o CC, você pode perguntar qualquer coisa. Mas algumas perguntas exigem imagens. Você precisa colar a imagem no CC.
Como o CC funciona em um terminal, o comando de colar é diferente do padrão do sistema. Não é Cmd+V, mas:
Control + V
Após colar, o CC conseguirá ver a imagem.
VII. Um Caso de Uso Real: Dividindo Recibos de Pagamento
A seguir, vamos demonstrar um caso real que encontrei no trabalho para ver a mágica do CC.
Como proprietário de empresa e contador, preciso pagar todos os meses.
Após pagar, preciso enviar os recibos de pagamento individuais.
Mas o agente só me dá uma tabela de pagamento que se parece com isto:
Preciso dividir esta tabela, fazer um arquivo separado para cada linha e enviá-lo para cada pessoa.
Esse tipo de trabalho repetitivo é muito chato.
Mas com o CC, basta dizer nossa necessidade:
"Esta é uma tabela de pagamento. Ajude-me a dividi-la em recibos de pagamento individuais, um arquivo por pessoa."
Gravei todo o processo, desde a inicialização até o comando de entrada e conclusão, sem nenhuma edição.
Não é incrível! Esta tarefa tediosa levou apenas 29 segundos no total!
Este é apenas um pequeno caso; na realidade, há dezenas de milhares de coisas que o CC pode fazer.
Da próxima vez que encontrar trabalho repetitivo, por que não abrir o CC e conversar com ele?
VIII. Carregando Habilidades: Fluxos de Trabalho Empacotados
Habilidades são um recurso importante lançado recentemente para o Claude Code.
Você pode pensar em uma Habilidade como um fluxo de trabalho que outros já testaram e verificaram; você só precisa pegá-lo emprestado.
Você pode copiá-los de sites de Habilidades existentes ou fazer o CC criá-los. Aqui está o guia oficial de Habilidades: https://github.com/anthropics/skills
Usar Habilidades é muito simples. Por exemplo, acabei de ver uma Habilidade de design frontend compartilhada pelo Sr. Liu Xiaopai (ele é um deus do CC; você pode seguir sua conta pública para mais dicas).
Primeiro, instale a Habilidade com uma frase:
npx skills-installer install @anthropics/claude-code/frontend-design --client claude-code
Depois, diga ao CC:
Use a habilidade @anthropics/skills/frontend-design para redesenhar a página inicial de https://listenhub.ai
O resultado é muito sofisticado, evitando completamente a aparência azul-púrpura padrão de páginas web projetadas por IA.
Conclusão: Quando uma Baleia Cai, Todas as Coisas Florescem
Isso conclui o guia super básico para o Claude Code.
Os passos acima são apenas o início da sua jornada para o trabalho e estudo inteligentes. Há muito mais para aprender.
O primeiro passo é sempre o mais difícil, e este artigo cobre essa parte. A partir daqui, se encontrar algum problema, basta perguntar ao CC, e ele ajudará a resolvê-lo.
Acredito que você logo encontrará seu próprio "Momento Uau!"
Enquanto escrevo, lembro-me de um jantar com Yang Pan onde discutimos o significado do modelo GLM 4.7.
Anteriormente, o Claude Code era um negócio de bilhões de dólares comido inteiramente pela baleia gigante que é a Anthropic.
Agora que os modelos open-source nacionais alcançaram, esta é a igualdade técnica que esperávamos há muito tempo.
Por ser open-source, todo provedor de nuvem pode implantar, vender e lucrar com ele.
E o que os usuários obtêm é a conveniência da inteligência a um por cento do preço.
O que estamos prestes a ver é a prosperidade de todo o ecossistema open-source e a transformação do Vibe Coding de um brinquedo para uma ferramenta de produção.
A baleia gigante permanece,
Mas nas profundezas do mar,
Todas as coisas estão crescendo.
