Título: Referência da CLI do Claude Code para desenvolvedores (guia 2025)

Stevia Putri
Written by

Stevia Putri

Reviewed by

Stanley Nicholas

Last edited 3 outubro 2025

Expert Verified

Título: Referência da CLI do Claude Code para desenvolvedores (guia 2025)

Sejamos realistas, a forma como programamos está a mudar. A imagem antiga de um programador a trabalhar em total isolamento está a desaparecer, substituída por um fluxo de trabalho muito mais colaborativo. E uma grande parte dessa nova equipa inclui frequentemente IA. Para aqueles de nós que praticamente vivem na linha de comando, isto costumava significar alternar desajeitadamente para um chat no navegador sempre que precisávamos de ajuda. Mas isso acabou.

O Claude Code da Anthropic é um poderoso assistente de programação que se integra diretamente no seu terminal. Não é apenas um chatbot que responde a perguntas; foi concebido para ser um parceiro ativo no seu processo de programação, ajudando-o a pensar melhor e a automatizar as tarefas tediosas que consomem o seu dia.

Este guia é a sua referência completa da CLI do Claude Code para fazer as coisas em 2025. Abordaremos tudo, desde a configuração inicial e comandos básicos até fluxos de trabalho mais avançados e preços. Quando terminar de ler, saberá exatamente como tirar o máximo proveito desta ferramenta.

O que é o Claude Code?

Simplificando, o Claude Code é uma interface de linha de comando (CLI) que lhe dá acesso conversacional direto aos modelos de IA da Anthropic a partir do seu terminal. Pense nisso como ter um programador de par com quem pode falar sem nunca tirar as mãos do teclado.

O seu principal trabalho é ajudá-lo a escrever, entender e corrigir código mais rapidamente. Com base no que vimos na documentação oficial e no que as pessoas que o usam dizem, eis o que ele pode fazer:

  • Desenvolver funcionalidades com base em descrições em linguagem natural.

  • Depurar problemas analisando o seu código e interpretando mensagens de erro.

  • Analisar e responder a perguntas sobre qualquer base de código, mesmo que nunca a tenha visto antes.

  • Automatizar tarefas repetitivas como corrigir erros de linting, resolver conflitos de merge ou até mesmo redigir notas de lançamento.

Foi criado para programadores que adoram a velocidade e o poder do terminal e preferem não ter mais um IDE ou janela de chat aberta.

"ou--resume ""| Retoma uma conversa específica usando o seu ID de sessão. |claude -r "abc123"| |--model| Diz ao Claude qual modelo usar para a sessão (ex:sonnetouopus). | claude --model opus| |--add-dir| Adiciona diretórios extra para o Claude analisar. |claude --add-dir ../backend| |--output-format | Define o formato de saída para o modo de impressão (text, json, stream-json). | claude -p "pergunta" --output-format json` |

Dominar as sessões interativas: Comandos com barra

Assim que estiver numa sessão, os comandos com barra são os seus melhores amigos para gerir a conversa e o seu fluxo de trabalho.

  • /help: Mostra todos os comandos que pode usar, incluindo quaisquer comandos personalizados que tenha configurado.

  • /init: Analisa o seu projeto atual e cria um ficheiro CLAUDE.md inicial. É uma forma fantástica de começar a criar a memória do projeto.

  • /clear: Limpa o histórico da conversa. Isto é muito útil quando está a mudar para uma tarefa totalmente diferente no mesmo projeto e não quer confundir a IA com o contexto antigo.

  • /compact: Resume a conversa atual, mantendo as partes importantes enquanto liberta espaço na janela de contexto para tarefas maiores e mais complexas.

  • /config: Abre um menu onde pode ajustar configurações como a escolha do modelo e as permissões de ferramentas para o seu projeto.

Reveja @./src/components/Button.tsx para problemas de acessibilidade.`

  • Executar comandos de shell com !: Colocar um ! à frente de um comando permite executá-lo na sua shell diretamente a partir do prompt do Claude. É perfeito para executar um teste rápido ou listar ficheiros para verificar um caminho. Por exemplo: > !npm test

Fluxos de trabalho avançados e limitações

Assim que dominar o básico, pode começar a integrar o Claude Code em partes mais complexas do seu processo de desenvolvimento. Mas também é bom conhecer os seus limites e quando outra ferramenta pode ser mais adequada.

Fluxos de trabalho de desenvolvimento comuns

Eis algumas formas como os programadores estão a usar a CLI para trabalhar mais rapidamente:

  1. Desenvolvimento Orientado a Testes (TDD): O ciclo de TDD ganha um grande impulso de velocidade. Pode pedir ao Claude para escrever um teste que falhe para uma nova funcionalidade, executá-lo para ver a falha e, de seguida, pedir-lhe imediatamente para escrever o código que faz o teste passar.

  2. Depuração Rápida: Em vez de passar uma hora a rastrear um erro, basta copiar e colar a mensagem de erro na CLI. Peça ao Claude para verificar a base de código, descobrir o que correu mal e sugerir uma correção.

  3. Integração em Bases de Código: Quando entra num novo projeto, o Claude pode ser o seu guia especializado. Pode fazer perguntas de alto nível como "explique a estrutura de pastas" ou "como funciona a autenticação de utilizadores aqui?" e ficar a par em minutos, não em dias.

B{Executar teste com !npm test}; B --> C{Ver o teste falhar}; C --> D[Pedir ao Claude para escrever código para passar no teste]; D --> E{Executar teste novamente}; E --> F[Ver o teste passar]; F --> A; Título alt: Um fluxo de trabalho de TDD usando a CLI do Claude Code.

Texto alt: Um diagrama de fluxo de trabalho mostrando como a CLI do Claude Code pode ser usada para acelerar o ciclo de Desenvolvimento Orientado a Testes.

Este guia definitivo para 2025 mostra como dominar o Claude Code, desde a configuração até aos fluxos de trabalho avançados.

Escolher o agente de IA certo

O Claude Code é uma ferramenta fantástica que pode aumentar seriamente a produtividade de um programador ao lidar com tarefas de programação exatamente onde eles trabalham: o terminal. É um agente poderoso e bem concebido para quem quer programar de forma mais rápida e eficaz.

Mas, no final de contas, trata-se de usar a ferramenta certa para o trabalho. Para escrever, depurar e entender código, um agente de programação dedicado como o Claude Code é a escolha perfeita. Para gerir o conhecimento partilhado da sua equipa e pôr fim às interrupções constantes, precisa de uma plataforma de conhecimento especializada.

Enquanto o Claude Code está a otimizar o seu terminal, a sua equipa pode ainda estar à procura de respostas em dezenas de aplicações diferentes. Pode acabar com as interrupções e dar a toda a sua empresa acesso instantâneo à informação de que precisam. Experimente o eesel AI gratuitamente e crie um bot interno de Perguntas e Respostas em minutos.

Perguntas frequentes

É uma interface de linha de comando que fornece acesso conversacional direto aos modelos de IA da Anthropic a partir do seu terminal. Os programadores podem usá-la para escrever, depurar, entender código e automatizar tarefas de programação repetitivas mais rapidamente.

Pode instalá-la globalmente via npm usando npm install -g @anthropic-ai/claude-code. Após a instalação, precisará de uma subscrição ativa do Claude Pro ou Max para autenticação.

Os comandos chave incluem claude "pergunta" para iniciar uma sessão, claude -c para retomar a sua última conversa, e comandos com barra como /init para gerar um CLAUDE.md ou /clear para redefinir o contexto. Também pode referenciar ficheiros com @ e executar comandos de shell com !.

Usa ficheiros CLAUDE.md em todo o diretório do seu projeto para armazenar padrões de codificação, notas de arquitetura e outro contexto importante. Adicionalmente, o settings.json gere as permissões de ferramentas e as escolhas de modelo.

Embora excelente para código, ele apenas compreende a sua base de código e não tem acesso ao conhecimento armazenado noutras ferramentas da empresa como Google Docs, Jira ou Slack. Não consegue responder a perguntas não técnicas de outros departamentos.

Para usar a CLI, precisa de uma subscrição ativa do Claude Pro (20 $/mês) ou Claude Max (a partir de 100 $/mês). O plano gratuito do Claude.ai não inclui acesso à CLI.

Compartilhe esta postagem

Stevia undefined

Article by

Stevia Putri

Stevia Putri is a marketing generalist at eesel AI, where she helps turn powerful AI tools into stories that resonate. She’s driven by curiosity, clarity, and the human side of technology.