Há dois meses que queria escrever um guia para iniciantes sobre CC, e hoje finalmente consegui.
O Claude Code (CC, para encurtar) é o produto de IA que mais recomendo este ano, sem dúvida alguma.
Embora se chame Claude Code, as suas funcionalidades vão muito além de escrever código; é um verdadeiro Agente de uso geral.
Muitas tarefas tediosas no computador podem ser tratadas pelo CC com apenas uma frase.
Uso-o para responder a perguntas, escrever, criar páginas web, desenvolver software, analisar dados e até dividir recibos de vencimento.
Consegue até ajudar-me a sintetizar rapidamente áudio e imagens em vídeos.
Por causa do CC, usei-o até para escrever um launcher open-source chamado Claude Code Now, que já alcançou 400 estrelas no GitHub.
O CC é também o software que fez o famoso investigador da OpenAI, AK, sentir que estava a ficar para trás.
Esta é uma conversa entre o autor do CC e o AK — basta apontar o CC para o alvo e ele dissolve os seus problemas!
Tenho recomendado o CC a colegas e amigos, e sempre que o usam, exclamam como esta IA é inteligente.
No entanto, o CC não é assim tão fácil de recomendar 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 bilião de dólares; o CEO deles parece não se importar muito com os utilizadores na China.
Por isso, esperava pelo momento em que as capacidades de código dos modelos open-source nacionais ultrapassassem o limiar.
Na segunda-feira, o meu amigo Yang Pan disse animadamente num 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.
Um lembrete amigável: este artigo é bastante longo. Seguir os passos levará cerca de uma hora, por isso talvez queira marcá-lo como favorito primeiro.
Se os seus amigos também quiserem experimentar a IA mais inteligente num computador, não se esqueça de lhes reencaminhar este artigo!
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/
- Os utilizadores do Windows também precisam de instalar o Git para Windows: https://git-scm.com/install/windows
II. Iniciar Formalmente a Instalação do CC
- Pesquise por "Terminal" no seu computador e abra-o. Tem este aspeto — não tenha medo, pense nele como uma caixa de chat de IA com um aspeto fixe.
- No terminal, cole o seguinte comando e prima Enter: npm install -g @anthropic-ai/claude-code
Pode encontrar vários erros aqui. Se já tiver instalado outras ferramentas de programação de IA, como o Cursor, recomendo vivamente instalá-lo dentro dessas ferramentas; elas ajudarão a resolver os 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 estiver no macOS, Linux ou WSL, cole este comando e prima Enter:
Se estiver no Windows, cole este comando e prima Enter:
Após a instalação, digite claude --version. Se aparecer um número de versão, a instalação foi bem-sucedida.
A nova versão do Claude Code adicionou um passo de verificação irritante; podemos saltá-lo com este método.
Adicione o item de configuração "hasCompletedOnboarding": true a ~/.claude.json. Se o ficheiro não existir, crie-o manualmente.
Deve ficar assim:
{ // ... outras configurações "hasCompletedOnboarding": true }
III. Adquirir um Plano de Servidor CC
Como mencionado, o CC oficial é implacável com bloqueios, por isso não recomendo a subscrição oficial. Se conseguir gerir o oficial, admiro-o, mas provavelmente não estaria a ler 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. Por ser um site nacional, é mais fácil de usar. Outros modelos têm Planos de Codificação semelhantes.
- Registe uma conta. Visite a Plataforma Aberta Zhipu AI (https://open.bigmodel.cn/), clique em "Registar/Iniciar Sessão" 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 uso posterior.
- Subscreva um Plano de Codificação. Com um plano, pode usá-lo livremente sem se preocupar com problemas inesperados de saldo.
Atualmente, há uma promoção de Ano Novo: recomendo vivamente o plano trimestral Coding Lite. Custa apenas 54 RMB por três meses — praticamente de graça.
Pode comprá-lo aqui: https://www.bigmodel.cn/glm-coding?ic=KSGMCBOXUT
IV. Configurar o Servidor CC
Assim que tiver o Plano de Codificação, 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, introduza o seguinte comando e prima Enter:
npx @z_ai/coding-helper
- Verá uma interface amigável em chinês.
- Siga as instruções da ferramenta, cole a Chave de API que obteve anteriormente e complete os passos um a um.
V. Iniciar o Claude Code!
🎉 Parabéns, instalou a ferramenta de IA mais poderosa disponível. Respire fundo.
Beba um pouco de água e depois inicie-a!
Espere, como é que a inicia?
No terminal, basta escrever claude e premir Enter. Verá a interface abaixo.
Cumprimente-a e apresente-se!
A partir de agora, este é o seu assistente para tudo.
Pode não estar habituado a esta forma de a abrir. Não faz mal; pode instalar o launcher que escrevi, Claude Code Now, em https://claudecodenow.com/
Após a instalação, pode ver o Claude Code em qualquer pasta. Basta clicar para o iniciar — super conveniente.
VI. Dicas de Utilização do Claude Code
Há muito para aprender com o Claude Code.
Mas o básico resume-se a três coisas, centradas em compreender como o CC funciona.
Pode pensar no CC como um agente que pode operar o seu sistema. Ele pode ver o seu computador, ler ficheiros, operar ficheiros, analisar ficheiros e produzir ficheiros.
Comunica com ele através de conversa natural; não precisa de escrever uma única linha de código.
- Pastas
As pastas são o melhor conceito de design do CC; são o parque de diversões do CC.
Quando o CC inicia, precisa de especificar uma pasta, que serve como contexto para a tarefa.
Sugiro vivamente criar uma pasta dedicada ao Claude Code para vários projetos do CC.
Abaixo está a minha pasta do CC. Uso-a para notas, análise de dados, leitura aprofundada e desenvolvimento de software. Cada tarefa tem a sua própria pasta para não interferirem umas com as outras.
Há duas formas de especificar uma pasta: uma é usar o Claude Code Now como mencionado acima. A outra é arrastar a pasta para o CC; ele lê-la-á automaticamente.
Os ficheiros funcionam da mesma forma — pode arrastá-los diretamente para o CC. Esta é a primeira dica muito importante.
- O Ficheiro Claude.md
O ficheiro Claude.md é o ficheiro de configuração principal do CC e a sua memória de longo prazo.
Pode pensar neste ficheiro como a constituição do CC.
Cada vez que o CC inicia, carrega automaticamente este ficheiro, que regista o que quer fazer e as regras que deu ao CC.
Também pode pedir ao CC para criar ele próprio este ficheiro e dizer-lhe que informação considera importante.
- Modo de Perigo
O que é o Modo de Perigo?
Como o nome sugere, uma vez ativado, o CC pode automatizar completamente o seu computador sem qualquer confirmação sua.
Parece perigoso, mas se não o ativar, tem de confirmar cada operação, o que é tedioso e mata a eficiência.
Se usar o Claude Code Now como launcher, já ativei o Modo de Perigo para si.
Se não, pode ativá-lo manualmente com este código:
claude --dangerously-skip-permissions
No entanto, uma vez ativado, o CC pode causar danos irreparáveis, por isso certifique-se de que especifica a pasta correta e mantenha cópias de segurança.
Agora que os três pontos importantes estão cobertos, aqui está uma dica muito prática: Colar Imagens.
Com o CC, pode perguntar-lhe qualquer coisa. Mas algumas perguntas requerem imagens. Precisa de colar a imagem no CC.
Como o CC funciona num terminal, o comando de colar é diferente do padrão do sistema. Não é Cmd+V, mas sim:
Control + V
Após colar, o CC conseguirá ver a imagem.
VII. Um Caso de Uso Real: Dividir Recibos de Vencimento
A seguir, vamos demonstrar um caso real que encontrei no trabalho para ver a magia do CC.
Como dono de empresa e contabilista, preciso de pagar a todos todos os meses.
Após pagar, preciso de enviar recibos de vencimento individuais.
Mas o agente dá-me apenas uma tabela de vencimentos com este aspeto:
Preciso de dividir esta tabela, criar um ficheiro separado para cada linha e enviá-lo a cada pessoa.
Este tipo de trabalho repetitivo é muito irritante.
Mas com o CC, basta dizer-lhe o nosso requisito:
"Esta é uma tabela de vencimentos. Ajuda-me a dividi-la em recibos de vencimento individuais, um ficheiro por pessoa."
Gravei o processo inteiro desde o início até ao comando de entrada e conclusão, sem qualquer edição.
Não é fantástico! Esta tarefa tediosa demorou 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, porque não abrir o CC e conversar com ele?
VIII. Carregar Competências: Fluxos de Trabalho Empacotados
As Competências são uma grande funcionalidade recentemente lançada para o Claude Code.
Pode pensar numa Competência como um fluxo de trabalho que outros já testaram e verificaram; basta pedi-lo emprestado.
Pode copiá-las de sites de Competências existentes ou pedir ao CC para as criar. Aqui está o guia oficial de Competências: https://github.com/anthropics/skills
Usar Competências é muito simples. Por exemplo, acabei de ver uma Competência de design de frontend partilhada pelo Sr. Liu Xiaopai (ele é um deus do CC; pode seguir a sua conta pública para mais dicas).
Primeiro, instale a Competência com uma frase:
npx skills-installer install @anthropics/claude-code/frontend-design --client claude-code
Depois, diga ao CC:
Usa a competência @anthropics/skills/frontend-design para redesenhar a página inicial de https://listenhub.ai
O resultado é muito elegante, evitando completamente o aspeto azul-púrpura padrão das páginas web desenhadas por IA.
Conclusão: Quando uma Baleia Cai, Tudo Floresce
Isto conclui o guia super básico para o Claude Code.
Os passos acima são apenas o início da sua jornada para um trabalho e estudo inteligentes. Há muito mais para aprender.
O primeiro passo é sempre o mais difícil, e este artigo cobre essa parte. Daqui em diante, se encontrar algum problema, basta perguntar ao CC, e ele ajudá-lo-á a resolvê-lo.
Acredito que em breve encontrará o seu próprio "Momento Uau!"
Enquanto termino de escrever, lembro-me de um jantar com o Yang Pan onde discutimos o significado do modelo GLM 4.7.
Anteriormente, o Claude Code era um negócio de mil milhões de dólares comido inteiramente pela baleia gigante que é a Anthropic.
Agora que os modelos open-source nacionais alcançaram o atraso, esta é a igualdade técnica que há muito esperávamos.
Por ser open-source, todos os fornecedores de cloud podem implementá-lo, vendê-lo e obter lucro com ele.
E o que os utilizadores 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,
Tudo está a crescer.
