Referência de CLI
Referência completa para a interface de linha de comando Claude Code, incluindo comandos e sinalizadores.
Comandos CLI
Você pode iniciar sessões, canalizar conteúdo, retomar conversas e gerenciar atualizações com estes comandos:
| Comando | Descrição | Exemplo |
|---|---|---|
claude |
Iniciar sessão interativa | claude |
claude "query" |
Iniciar sessão interativa 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 a conversa mais recente no diretório atual | claude -c |
claude -c -p "query" |
Continuar via SDK | claude -c -p "Check for type errors" |
claude -r "<session>" "query" |
Retomar sessão por ID ou nome | claude -r "auth-refactor" "Finish this PR" |
claude update |
Atualizar para a versão mais recente | claude update |
claude install [version] |
Instalar ou reinstalar o binário nativo. Aceita uma versão como 2.1.118, ou stable ou latest. Veja Instalar uma versão específica |
claude install stable |
claude auth login |
Faça login em sua conta Anthropic. Use --email para preencher previamente seu endereço de email, --sso para forçar autenticação SSO e --console para fazer login com Anthropic Console para faturamento de uso de API em vez de uma assinatura Claude |
claude auth login --console |
claude auth logout |
Fazer logout de sua conta Anthropic | claude auth logout |
claude auth status |
Mostrar status de autenticação como JSON. Use --text para saída legível por humanos. Sai com código 0 se conectado, 1 se não |
claude auth status |
claude agents |
Abrir visualização de agente para monitorar e despachar sessões de fundo paralelas. Use --cwd <path> para mostrar apenas sessões iniciadas nesse diretório |
claude agents |
claude attach <id> |
Anexar a uma sessão de fundo neste terminal | claude attach 7c5dcf5d |
claude auto-mode defaults |
Imprimir as regras do classificador auto mode integradas como JSON. Use claude auto-mode config para ver sua configuração efetiva com as configurações aplicadas |
claude auto-mode defaults > rules.json |
claude logs <id> |
Imprimir saída recente de uma sessão de fundo | claude logs 7c5dcf5d |
claude mcp |
Configurar servidores Model Context Protocol (MCP) | Veja a documentação Claude Code MCP. |
claude plugin |
Gerenciar Claude Code plugins. Alias: claude plugins. Veja referência de plugin para subcomandos |
claude plugin install code-review@claude-plugins-official |
claude project purge [path] |
Excluir todo o estado local do Claude Code para um projeto: transcrições, listas de tarefas, logs de depuração, histórico de edição de arquivo, linhas de histórico de prompt e a entrada do projeto em ~/.claude.json. Omita [path] para escolher em uma lista interativa. Sinalizadores: --dry-run para visualizar, -y/--yes para pular confirmação, -i/--interactive para confirmar cada item, --all para cada projeto. Veja Limpar dados locais |
claude project purge ~/work/repo --dry-run |
claude remote-control |
Iniciar um servidor Remote Control para controlar Claude Code a partir de Claude.ai ou do aplicativo Claude. Executa em modo servidor (sem sessão interativa local). Veja Sinalizadores de modo servidor | claude remote-control --name "My Project" |
claude respawn <id> |
Reiniciar uma sessão de fundo parada com sua conversa intacta. Use --all para reiniciar cada sessão parada |
claude respawn 7c5dcf5d |
claude rm <id> |
Remover uma sessão de fundo da lista | claude rm 7c5dcf5d |
claude setup-token |
Gerar um token OAuth de longa duração para CI e scripts. Imprime o token no terminal sem salvá-lo. Requer uma assinatura Claude. Veja Gerar um token de longa duração | claude setup-token |
claude stop <id> |
Parar uma sessão de fundo. Também aceita claude kill |
claude stop 7c5dcf5d |
claude ultrareview [target] |
Executar ultrareview de forma não interativa. Imprime descobertas para stdout e sai com 0 em caso de sucesso ou 1 em caso de falha. Use --json para o payload bruto e --timeout <minutes> para substituir o padrão de 30 minutos |
claude ultrareview 1234 --json |
Se você digitar incorretamente um subcomando, Claude Code sugere a correspondência mais próxima e sai sem iniciar uma sessão. Por exemplo, claude udpate imprime Did you mean claude update?.
Sinalizadores CLI
Personalize o comportamento do Claude Code com estes sinalizadores de linha de comando. claude --help não lista todos os sinalizadores, portanto a ausência de um sinalizador em --help não significa que ele não está disponível.
| Sinalizador | Descrição | Exemplo |
|---|---|---|
--add-dir |
Adicionar diretórios de trabalho adicionais para Claude ler e editar arquivos. Concede acesso a arquivos; a maioria da configuração .claude/ não é descoberta desses diretórios. Valida se cada caminho existe como um diretório. Para persistir esses diretórios entre sessões, defina permissions.additionalDirectories nas configurações |
claude --add-dir ../apps ../lib |
--agent |
Especificar um agente para a sessão atual (substitui a configuração agent) |
claude --agent my-custom-agent |
--agents |
Definir subagents personalizados dinamicamente via JSON. Usa os mesmos nomes de campo que o frontmatter de subagent, mais um campo prompt para as instruções do agente |
claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}' |
--allow-dangerously-skip-permissions |
Adicionar bypassPermissions ao ciclo de modo Shift+Tab sem iniciar nele. Permite começar em um modo diferente como plan e mudar para bypassPermissions depois. Veja modos de permissão |
claude --permission-mode plan --allow-dangerously-skip-permissions |
--allowedTools |
Ferramentas que executam sem solicitar permissão. Veja sintaxe de regra de permissão para correspondência de padrões. Para restringir quais ferramentas estão disponíveis, use --tools em vez disso |
"Bash(git log *)" "Bash(git diff *)" "Read" |
--append-system-prompt |
Anexar texto personalizado ao final do prompt do sistema padrão | claude --append-system-prompt "Always use TypeScript" |
--append-system-prompt-file |
Carregar texto de prompt do sistema adicional de um arquivo e anexar ao prompt padrão | claude --append-system-prompt-file ./extra-rules.txt |
--bare |
Modo mínimo: pular auto-descoberta de hooks, skills, plugins, servidores MCP, memória automática e CLAUDE.md para que chamadas com script iniciem mais rapidamente. Claude tem acesso a ferramentas Bash, leitura de arquivo e edição de arquivo. Define CLAUDE_CODE_SIMPLE. Veja modo bare |
claude --bare -p "query" |
--betas |
Cabeçalhos beta para incluir em solicitações de API (apenas usuários de chave de API) | claude --betas interleaved-thinking |
--bg |
Iniciar a sessão como um agente de fundo e retornar imediatamente. Imprime o ID da sessão e comandos de gerenciamento. Combine com --agent para executar um subagent específico |
claude --bg "investigate the flaky test" |
--channels |
(Visualização de pesquisa) Servidores MCP cujas notificações de channel Claude deve ouvir nesta sessão. Lista separada por espaço de entradas plugin:<name>@<marketplace>. Requer autenticação Claude.ai |
claude --channels plugin:my-notifier@my-marketplace |
--chrome |
Ativar integração do navegador Chrome para automação web e testes | claude --chrome |
--continue, -c |
Carregar a conversa mais recente no diretório atual. Inclui sessões que adicionaram este diretório com /add-dir |
claude --continue |
--dangerously-load-development-channels |
Ativar channels que não estão na lista de permissões aprovada, para desenvolvimento local. Aceita entradas plugin:<name>@<marketplace> e server:<name>. Solicita confirmação |
claude --dangerously-load-development-channels server:webhook |
--dangerously-skip-permissions |
Pular prompts de permissão. Equivalente a --permission-mode bypassPermissions. Veja modos de permissão para o que isso faz e não faz |
claude --dangerously-skip-permissions |
--debug |
Ativar modo de depuração com filtragem de categoria opcional (por exemplo, "api,hooks" ou "!statsig,!file") |
claude --debug "api,mcp" |
--debug-file <path> |
Escrever logs de depuração em um caminho de arquivo específico. Ativa implicitamente o modo de depuração. Tem precedência sobre CLAUDE_CODE_DEBUG_LOGS_DIR |
claude --debug-file /tmp/claude-debug.log |
--disable-slash-commands |
Desativar todas as skills e comandos para esta sessão | claude --disable-slash-commands |
--disallowedTools |
Ferramentas que são removidas do contexto do modelo e não podem ser usadas | "Bash(git log *)" "Bash(git diff *)" "Edit" |
--effort |
Definir o nível de esforço para a sessão atual. Opções: low, medium, high, xhigh, max; os níveis disponíveis dependem do modelo. Substitui a configuração effortLevel para esta sessão e não persiste |
claude --effort high |
--enable-auto-mode |
{/* max-version: 2.1.110 */}Removido em v2.1.111. Auto mode agora está no ciclo Shift+Tab por padrão; use --permission-mode auto para iniciar nele |
claude --permission-mode auto |
--exclude-dynamic-system-prompt-sections |
Mover seções por máquina do prompt do sistema (diretório de trabalho, informações de ambiente, caminhos de memória, status do git) para a primeira mensagem do usuário. Melhora a reutilização de prompt-cache em diferentes usuários e máquinas executando a mesma tarefa. Aplica-se apenas com o prompt do sistema padrão; ignorado quando --system-prompt ou --system-prompt-file está definido. Use com -p para cargas de trabalho com script e multi-usuário |
claude -p --exclude-dynamic-system-prompt-sections "query" |
--fallback-model |
Ativar fallback automático para modelo especificado quando o modelo padrão está sobrecarregado (apenas modo print) | claude -p --fallback-model sonnet "query" |
--fork-session |
Ao retomar, criar um novo ID de sessão em vez de reutilizar o original (use com --resume ou --continue) |
claude --resume abc123 --fork-session |
--from-pr |
Retomar sessões vinculadas a um pull request específico. Aceita um número de PR, uma URL de PR do GitHub ou GitHub Enterprise, uma URL de merge request do GitLab ou uma URL de pull request do Bitbucket. As sessões são vinculadas automaticamente quando Claude cria o pull request | claude --from-pr 123 |
--ide |
Conectar automaticamente ao IDE na inicialização se exatamente um IDE válido estiver disponível | claude --ide |
--init |
Executar hooks de Setup com o matcher init antes da sessão (apenas modo print) |
claude -p --init "query" |
--init-only |
Executar hooks de Setup e SessionStart, depois sair sem iniciar uma conversa |
claude --init-only |
--include-hook-events |
Incluir todos os eventos do ciclo de vida do hook no fluxo de saída. Requer --output-format stream-json |
claude -p --output-format stream-json --include-hook-events "query" |
--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" |
--input-format |
Especificar formato de entrada para modo print (opções: text, stream-json) |
claude -p --output-format json --input-format stream-json |
--json-schema |
Obter saída JSON validada correspondendo a um JSON Schema após o agente completar seu fluxo de trabalho (apenas modo print, veja saídas estruturadas) | claude -p --json-schema '{"type":"object","properties":{...}}' "query" |
--maintenance |
Executar hooks de Setup com o matcher maintenance antes da sessão (apenas modo print) |
claude -p --maintenance "query" |
--max-budget-usd |
Valor máximo em dólares a gastar em chamadas de API antes de parar (apenas modo print) | claude -p --max-budget-usd 5.00 "query" |
--max-turns |
Limitar o número de turnos de agente (apenas modo print). Sai com um erro quando o limite é atingido. Sem limite por padrão | claude -p --max-turns 3 "query" |
--mcp-config |
Carregar servidores MCP de arquivos JSON ou strings (separados por espaço) | claude --mcp-config ./mcp.json |
--model |
Define o modelo para a sessão atual com um alias para o modelo mais recente (sonnet ou opus) ou o nome completo de um modelo. Substitui a configuração model e ANTHROPIC_MODEL |
claude --model claude-sonnet-4-6 |
--name, -n |
Definir um nome de exibição para a sessão, mostrado em /resume e no título do terminal. Você pode retomar uma sessão nomeada com claude --resume <name>. /rename altera o nome durante a sessão e também o mostra na barra de prompt |
claude -n "my-feature-work" |
--no-chrome |
Desativar integração do navegador Chrome para esta sessão | claude --no-chrome |
--no-session-persistence |
Desativar persistência de sessão para que as sessões não sejam salvas em disco e não possam ser retomadas. Apenas modo print. A variável de ambiente CLAUDE_CODE_SKIP_PROMPT_HISTORY faz o mesmo em qualquer modo |
claude -p --no-session-persistence "query" |
--output-format |
Especificar formato de saída para modo print (opções: text, json, stream-json) |
claude -p "query" --output-format json |
--permission-mode |
Começar em um modo de permissão especificado. Aceita default, acceptEdits, plan, auto, dontAsk ou bypassPermissions. Substitui defaultMode dos arquivos de configuração |
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" |
--plugin-dir |
Carregar um plugin de um diretório ou arquivo .zip apenas para esta sessão. Cada sinalizador leva um caminho. Repita o sinalizador para vários plugins: --plugin-dir A --plugin-dir B.zip |
claude --plugin-dir ./my-plugin |
--plugin-url |
Buscar um arquivo .zip de plugin de uma URL apenas para esta sessão. Repita o sinalizador para vários plugins, ou passe URLs separadas por espaço em um único valor entre aspas |
claude --plugin-url https://example.com/plugin.zip |
--print, -p |
Imprimir resposta sem modo interativo (veja documentação do Agent SDK para detalhes de uso programático) | claude -p "query" |
--remote |
Criar uma nova sessão web em claude.ai com a descrição de tarefa fornecida | claude --remote "Fix the login bug" |
--remote-control, --rc |
Iniciar uma sessão interativa com Remote Control ativado para que você também possa controlá-la a partir de claude.ai ou do aplicativo Claude. Opcionalmente, passe um nome para a sessão | claude --remote-control "My Project" |
--remote-control-session-name-prefix <prefix> |
Prefixo para nomes de sessão Remote Control gerados automaticamente quando nenhum nome explícito está definido. Padrão é o nome do host da sua máquina, produzindo nomes como myhost-graceful-unicorn. Defina CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX para o mesmo efeito |
claude remote-control --remote-control-session-name-prefix dev-box |
--replay-user-messages |
Re-emitir mensagens do usuário de stdin de volta em stdout para confirmação. Requer --input-format stream-json e --output-format stream-json |
claude -p --input-format stream-json --output-format stream-json --replay-user-messages |
--resume, -r |
Retomar uma sessão específica por ID ou nome, ou mostrar um seletor interativo para escolher uma sessão. Inclui sessões que adicionaram este diretório com /add-dir |
claude --resume auth-refactor |
--session-id |
Usar um ID de sessão específico para a conversa (deve ser um UUID válido) | claude --session-id "550e8400-e29b-41d4-a716-446655440000" |
--setting-sources |
Lista separada por vírgula de fontes de configuração a carregar (user, project, local) |
claude --setting-sources user,project |
--settings |
Caminho para um arquivo JSON de configurações ou uma string JSON para carregar configurações adicionais. Os valores que você define aqui substituem as mesmas chaves em seus arquivos settings.json para esta sessão. As chaves que você omite mantêm seus valores baseados em arquivo. Veja precedência de configurações |
claude --settings ./settings.json |
--strict-mcp-config |
Usar apenas servidores MCP de --mcp-config, ignorando todas as outras configurações de MCP |
claude --strict-mcp-config --mcp-config ./mcp.json |
--system-prompt |
Substituir todo o prompt do sistema por texto personalizado | claude --system-prompt "You are a Python expert" |
--system-prompt-file |
Carregar prompt do sistema de um arquivo, substituindo o prompt padrão | claude --system-prompt-file ./custom-prompt.txt |
--teleport |
Retomar uma sessão web em seu terminal local | claude --teleport |
--teammate-mode |
Definir como equipe de agentes colegas de equipe são exibidos: auto (padrão), in-process ou tmux. Substitui a configuração teammateMode para esta sessão. Veja Escolher um modo de exibição |
claude --teammate-mode in-process |
--tmux |
Criar uma sessão tmux para o worktree. Requer --worktree. Usa painéis nativos do iTerm2 quando disponível; passe --tmux=classic para tmux tradicional |
claude -w feature-auth --tmux |
--tools |
Restringir quais ferramentas integradas Claude pode usar. Use "" para desativar todas, "default" para todas, ou nomes de ferramentas como "Bash,Edit,Read" |
claude --tools "Bash,Edit,Read" |
--verbose |
Ativar logging detalhado, mostra saída completa turno por turno. Substitui a configuração viewMode para esta sessão |
claude --verbose |
--version, -v |
Exibir o número da versão | claude -v |
--worktree, -w |
Iniciar Claude em um git worktree isolado em <repo>/.claude/worktrees/<name>. Se nenhum nome for fornecido, um será gerado automaticamente. Passe #<number> ou uma URL de pull request do GitHub para buscar esse PR de origin e ramificar o worktree a partir dele |
claude -w feature-auth |
Sinalizadores de prompt do sistema
Claude Code fornece quatro sinalizadores para personalizar o prompt do sistema. Todos os quatro funcionam em modos interativo e não interativo.
| Sinalizador | Comportamento | Exemplo |
|---|---|---|
--system-prompt |
Substitui todo o prompt padrão | claude --system-prompt "You are a Python expert" |
--system-prompt-file |
Substitui pelo conteúdo do arquivo | claude --system-prompt-file ./prompts/review.txt |
--append-system-prompt |
Anexa ao prompt padrão | claude --append-system-prompt "Always use TypeScript" |
--append-system-prompt-file |
Anexa conteúdo do arquivo ao prompt padrão | claude --append-system-prompt-file ./style-rules.txt |
--system-prompt e --system-prompt-file são mutuamente exclusivos. Os sinalizadores de anexação podem ser combinados com qualquer sinalizador de substituição.
Escolha com base em se a identidade padrão do Claude Code ainda se adequa à sua tarefa. Use um sinalizador de anexação quando Claude deve permanecer um assistente de codificação que também segue suas regras extras: instruções por invocação, formatação de saída ou contexto de domínio para um script -p. Anexar preserva a orientação de ferramentas padrão, instruções de segurança e convenções de codificação, portanto você fornece apenas o que difere. Use um sinalizador de substituição quando a superfície, identidade ou modelo de permissão diferir do Claude Code, como um agente não codificador em um pipeline que nenhum humano observa. Substituir descarta todo o prompt padrão, incluindo orientação de ferramentas e instruções de segurança, portanto você assume a responsabilidade por tudo o que sua tarefa ainda precisa.
Esses sinalizadores se aplicam apenas à invocação atual. Para personas persistentes que você pode alternar e compartilhar em um projeto, use estilos de saída. Para convenções de projeto que Claude deve sempre seguir, use CLAUDE.md. O guia do Agent SDK sobre prompts do sistema cobre a mesma decisão com mais profundidade.
Veja também
- Extensão Chrome - Automação de navegador e testes web
- Modo interativo - Atalhos de teclado, modos de entrada e recursos interativos
- Guia de início rápido - Começar com Claude Code
- Fluxos de trabalho comuns - Fluxos de trabalho e padrões avançados
- Configurações - Opções de configuração
- Documentação do Agent SDK - Uso programático e integrações