Comandos da CLI
| Comando | Descrição | Exemplo |
|---|
claude | Iniciar REPL interativo | claude |
claude "query" | Iniciar REPL com prompt inicial | claude "explain this project" |
claude -p "query" | Consultar via SDK e sair | claude -p "explain this function" |
cat file | claude -p "query" | Processar conteúdo canalizado | cat logs.txt | claude -p "explain" |
claude -c | Continuar conversa mais recente | claude -c |
claude -c -p "query" | Continuar via SDK | claude -c -p "Check for type errors" |
claude -r "<session-id>" "query" | Retomar sessão por ID | claude -r "abc123" "Finish this PR" |
claude update | Atualizar para a versão mais recente | claude update |
claude mcp | Configurar servidores Model Context Protocol (MCP) | Veja a documentação Claude Code MCP. |
Sinalizadores da CLI
Personalize o comportamento do Claude Code com estes sinalizadores de linha de comando:
| Sinalizador | Descrição | Exemplo |
|---|
--add-dir | Adicionar diretórios de trabalho adicionais para Claude acessar (valida se cada caminho existe como um diretório) | claude --add-dir ../apps ../lib |
--agents | Definir subagentes personalizados dinamicamente via JSON (veja abaixo o formato) | claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}' |
--allowedTools | Uma lista de ferramentas que devem ser permitidas sem solicitar permissão do usuário, além de arquivos settings.json | "Bash(git log:*)" "Bash(git diff:*)" "Read" |
--disallowedTools | Uma lista de ferramentas que devem ser desabilitadas sem solicitar permissão do usuário, além de arquivos settings.json | "Bash(git log:*)" "Bash(git diff:*)" "Edit" |
--print, -p | Imprimir resposta sem modo interativo (veja a documentação do SDK para detalhes de uso programático) | claude -p "query" |
--system-prompt | Substituir todo o prompt do sistema por texto personalizado (funciona em modos interativo e de impressão; adicionado em v2.0.14) | claude --system-prompt "You are a Python expert" |
--system-prompt-file | Carregar prompt do sistema de um arquivo, substituindo o prompt padrão (modo de impressão apenas; adicionado em v1.0.54) | claude -p --system-prompt-file ./custom-prompt.txt "query" |
--append-system-prompt | Anexar texto personalizado ao final do prompt do sistema padrão (funciona em modos interativo e de impressão; adicionado em v1.0.55) | claude --append-system-prompt "Always use TypeScript" |
--output-format | Especificar formato de saída para modo de impressão (opções: text, json, stream-json) | claude -p "query" --output-format json |
--input-format | Especificar formato de entrada para modo de impressão (opções: text, stream-json) | claude -p --output-format json --input-format stream-json |
--include-partial-messages | Incluir eventos de streaming parcial na saída (requer --print e --output-format=stream-json) | claude -p --output-format stream-json --include-partial-messages "query" |
--verbose | Ativar registro detalhado, mostra saída completa turno por turno (útil para depuração em modos de impressão e interativo) | claude --verbose |
--max-turns | Limitar o número de turnos de agente em modo não interativo | claude -p --max-turns 3 "query" |
--model | Define o modelo para a sessão atual com um alias para o modelo mais recente (sonnet ou opus) ou nome completo do modelo | claude --model claude-sonnet-4-5-20250929 |
--permission-mode | Começar em um modo de permissão especificado | claude --permission-mode plan |
--permission-prompt-tool | Especificar uma ferramenta MCP para lidar com prompts de permissão em modo não interativo | claude -p --permission-prompt-tool mcp_auth_tool "query" |
--resume | Retomar uma sessão específica por ID, ou escolhendo em modo interativo | claude --resume abc123 "query" |
--continue | Carregar a conversa mais recente no diretório atual | claude --continue |
--dangerously-skip-permissions | Pular prompts de permissão (use com cuidado) | claude --dangerously-skip-permissions |
O sinalizador --output-format json é particularmente útil para scripts e
automação, permitindo que você analise as respostas do Claude programaticamente.
--agents aceita um objeto JSON que define um ou mais subagentes personalizados. Cada subagente requer um nome único (como a chave) e um objeto de definição com os seguintes campos:
| Campo | Obrigatório | Descrição |
|---|
description | Sim | Descrição em linguagem natural de quando o subagente deve ser invocado |
prompt | Sim | O prompt do sistema que orienta o comportamento do subagente |
tools | Não | Array de ferramentas específicas que o subagente pode usar (por exemplo, ["Read", "Edit", "Bash"]). Se omitido, herda todas as ferramentas |
model | Não | Alias do modelo a usar: sonnet, opus ou haiku. Se omitido, usa o modelo de subagente padrão |
claude --agents '{
"code-reviewer": {
"description": "Expert code reviewer. Use proactively after code changes.",
"prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",
"tools": ["Read", "Grep", "Glob", "Bash"],
"model": "sonnet"
},
"debugger": {
"description": "Debugging specialist for errors and test failures.",
"prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."
}
}'
Sinalizadores de prompt do sistema
Claude Code fornece três sinalizadores para personalizar o prompt do sistema, cada um servindo a um propósito diferente:
| Sinalizador | Comportamento | Modos | Caso de Uso |
|---|
--system-prompt | Substitui todo o prompt padrão | Interativo + Impressão | Controle completo sobre o comportamento e instruções do Claude |
--system-prompt-file | Substitui com conteúdo do arquivo | Apenas impressão | Carregar prompts de arquivos para reprodutibilidade e controle de versão |
--append-system-prompt | Anexa ao prompt padrão | Interativo + Impressão | Adicionar instruções específicas mantendo o comportamento padrão do Claude Code |
-
--system-prompt: Use quando você precisa de controle completo sobre o prompt do sistema do Claude. Isso remove todas as instruções padrão do Claude Code, oferecendo uma folha em branco.
claude --system-prompt "You are a Python expert who only writes type-annotated code"
-
--system-prompt-file: Use quando você deseja carregar um prompt personalizado de um arquivo, útil para consistência de equipe ou modelos de prompt controlados por versão.
claude -p --system-prompt-file ./prompts/code-review.txt "Review this PR"
-
--append-system-prompt: Use quando você deseja adicionar instruções específicas mantendo as capacidades padrão do Claude Code intactas. Esta é a opção mais segura para a maioria dos casos de uso.
claude --append-system-prompt "Always use TypeScript and include JSDoc comments"
--system-prompt e --system-prompt-file são mutuamente exclusivos. Você não pode usar ambos os sinalizadores simultaneamente.
Para a maioria dos casos de uso, --append-system-prompt é recomendado, pois preserva as capacidades integradas do Claude Code enquanto adiciona seus requisitos personalizados. Use --system-prompt ou --system-prompt-file apenas quando você precisar de controle completo sobre o prompt do sistema.
-p), incluindo formatos de saída,
streaming, registro detalhado e uso programático, veja a
documentação do SDK.
Veja também
