🖥️ CLI - Interface de Linha de Comando
A CLI e a porta de entrada do Claude Code. E onde voce digita comandos e ve as respostas. Mas nao e apenas um terminal - e uma interface inteligente que processa seus prompts e os envia para o modelo.
🔧 Componentes da CLI
- • Parser de entrada: Interpreta seus prompts e comandos slash
- • Renderer de saida: Formata as respostas com syntax highlighting
- • Historico de sessao: Mantem o contexto da conversa
- • Interface de confirmacao: Pede permissoes quando necessario
📊 Tecnologias Utilizadas
A CLI e construida com TypeScript e Node.js, usando bibliotecas open source como Ink para renderizacao de terminal. Isso significa que o codigo e auditavel e extensivel.
📋 Session Manager - Gerenciador de Sessoes
O Session Manager e responsavel por controlar o ciclo de vida das conversas. Ele gerencia o inicio, manutencao e encerramento das sessoes, alem de coordenar o contexto entre mensagens.
Responsabilidades
- • Iniciar novas sessoes
- • Manter historico de mensagens
- • Gerenciar snapshots de arquivos
- • Coordenar compaction
- • Salvar sessoes para recuperacao
Onde Armazena
- •
~/.claude/- Pasta principal - •
sessions/- Historico de sessoes - •
settings.json- Configuracoes - •
memory/- Memorias persistentes
💡 Dica Pratica
Voce pode recuperar conversas antigas navegando ate ~/.claude/sessions/ e pedindo para Claude ler os arquivos de sessao.
⚙️ Tool Executor - Executor de Ferramentas
O Tool Executor e o "braco" do Claude Code - e ele que realmente executa as acoes no seu sistema. Quando Claude decide ler um arquivo ou rodar um comando, o Tool Executor faz acontecer.
Ferramentas Disponiveis
Ler arquivos
Criar arquivos
Editar arquivos
Buscar arquivos
Buscar conteudo
Executar comandos
Fluxo de Execucao
🛡️ Permission Layer - Camada de Permissoes
A Permission Layer e o "guardiao" do sistema. Antes de qualquer acao potencialmente perigosa, ela verifica se voce deu permissao. Isso garante que Claude nao faca nada sem seu consentimento.
Allow
Permite automaticamente. Usado para acoes seguras como leitura de arquivos.
Ask
Pergunta antes de executar. Padrao para a maioria das acoes.
Block
Sempre bloqueia. Usado para comandos perigosos como rm -rf.
⚠️ Importante
Nunca desative completamente a camada de permissoes em projetos de producao. Mesmo em YOLO mode, algumas protecoes basicas permanecem ativas.
🧠 Orchestration Layer - Camada de Orquestracao
A Orchestration Layer e onde a magia acontece. E aqui que o modelo Claude (Opus 4.5) processa suas requisicoes, decide quais ferramentas usar e coordena todo o fluxo de trabalho.
🎯 O que Acontece Aqui
- 1. Recebe seu prompt + contexto (CLAUDE.md, historico, arquivos lidos)
- 2. Modelo Claude analisa e decide a melhor abordagem
- 3. Seleciona ferramentas necessarias (Read, Edit, Bash, etc.)
- 4. Executa ferramentas e analisa resultados
- 5. Repete ate completar a tarefa ou precisar de input
📊 Conexao com a API
A comunicacao com o modelo acontece via API da Anthropic. Cada mensagem que voce envia gera uma chamada de API, e o custo e calculado por tokens de entrada e saida.
🔗 Como Tudo se Conecta
Agora que conhecemos cada componente, vamos ver como eles trabalham juntos em um fluxo real.
Exemplo: "Corrija o bug na funcao login"
🚀 Proximo Passo
Agora que voce entende a arquitetura, no proximo modulo vamos explorar o Loop Central: Gather → Act → Verify - o modelo mental que guia todas as acoes do Claude Code.
📋 Resumo do Modulo
Proximo Modulo:
1.3 - O Loop Central: Gather → Act → Verify