Source: https://aiprimetech.io/pt/claude-code/cli/

[Início](/pt/) › [Claude Code](/pt/claude-code/) › Referência da CLI

[Visão geral](/pt/claude-code/)[Instalação](/pt/claude-code/install/)[referência da CLI](/pt/claude-code/cli/)[Preços e limites](/pt/claude-code/pricing/)[Agent SDK](/pt/claude-code/sdk/)[Skills e plugins](/pt/claude-code/skills/)[GitHub](/pt/claude-code/github/)[Web, desktop e IDE](/pt/claude-code/web-and-desktop/)[Modelos](/pt/claude-code/models/)[Erros](/pt/claude-code/errors/)[Código aberto?](/pt/claude-code/open-source/)[Tutorial](/pt/claude-code/tutorial/)[Para estudantes](/pt/claude-code/for-students/)[Automação de QA](/pt/claude-code/qa-automation/)[vs Cursor](/pt/claude-code/vs-cursor/)[vs Codex e OpenCode](/pt/claude-code/vs-codex/)[Subagentes](/pt/claude-code/subagents/)[Hooks](/pt/claude-code/hooks/)[MCP](/pt/claude-code/mcp/)[Ecossistema](/pt/claude-code/ecosystem/)[VS Code](/pt/claude-code/vscode/)[OpenRouter](/pt/claude-code/openrouter/)[Limites de requisições](/pt/claude-code/rate-limits/)[Guia em chinês](/claude-code/zh/)

Última atualização: 11 de outubro de 2026

# Documentação da CLI do Claude Code: comandos e flags

O Claude Code oferece duas formas de uso: a sessão interativa que você inicia com claude, e um modo de impressão não interativo para scripts e CI. Esta é a referência prática para ambos.

## TLDR
- claude inicia uma sessão interativa no diretório atual; claude -p "..." executa um prompt e encerra.
- Os comandos de barra gerenciam a sessão: /init, /compact, /clear, /model, /cost, /status, /permissions, /mcp, /agents.
- --output-format json e --allowedTools permitem o uso em scripts; -c / -r retomam sessões.

## Inicialização 

```
claude                          # interactive session
claude "fix the failing test"   # start with a prompt
claude -p "summarise this repo"  # print mode: answer, then exit
claude -c                       # continue the most recent session
claude -r                       # pick a session to resume
claude --model claude-opus-5    # choose the model for this session
```

## Opções que vale a pena conhecer 
- -p, --print — não interativo; recebe a entrada por pipe e fornece a saída. A base de qualquer uso em scripts e CI.
- --output-format text|json|stream-json — saída estruturada para o modo de impressão.
- --model <id> — qualquer modelo disponibilizado pelo endpoint (/v1/models neste gateway lista os modelos).
- --allowedTools "Read,Edit,Bash(git *)" — aprove ferramentas antecipadamente para que o modo de impressão nunca fique bloqueado à espera de uma confirmação.
- --dangerously-skip-permissions — nenhuma solicitação de confirmação. Use apenas dentro de um contêiner ou ambiente isolado que você possa descartar.
- --max-turns N — limite o ciclo do agente em execuções sem interface interativa.
- --add-dir <path> — permita que a sessão trabalhe em mais de um diretório. 

## Comandos de barra dentro de uma sessão 
- /init — escreva um CLAUDE.md para o projeto (convenções, comandos de compilação, o que evitar).
- /compact [focus] — resuma a conversa para liberar contexto; a medida mais eficaz para controlar custos.
- /clear — recomece com um contexto vazio.
- /model — troque de modelo durante a sessão; /cost — tokens e gastos até o momento; /status — endpoint, chave, modelo, versão.
- /permissions — o que o agente pode fazer sem pedir autorização; /config — configurações; /memory — edite arquivos de memória.
- /mcp — servidores MCP conectados; /agents — defina e gerencie subagentes; /hooks — hooks de shell em eventos de ferramentas.
- /review — revise um pull request; /doctor — diagnostique a instalação; /help — todo o restante. 

## claude setup-token: autenticação de longa duração para CI com uma assinatura 

claude setup-token autentica uma vez no navegador e imprime um token OAuth de longa duração para uma assinatura Claude Pro/Max, destinado a ambientes sem interface interativa nos quais /login é impossível. Exporte-o como CLAUDE_CODE_OAUTH_TOKEN no CI, e o modo de impressão usará a cota da assinatura. Ele é exclusivo para assinaturas; com uma chave de API (Anthropic ou gateway), essa etapa é desnecessária — defina ANTHROPIC_API_KEY em vez disso. 

## Modo de impressão para scripts e CI 

```
cat error.log | claude -p "explain the root cause in three lines"

claude -p "write a changelog entry for the staged diff" \
  --allowedTools "Read,Bash(git diff *)" \
  --output-format json
```

O modo de impressão é a forma como a GitHub Action, as integrações com editores e o Agent SDK usam o Claude Code. Com ANTHROPIC_BASE_URL definido para o gateway, essas execuções são cobradas do seu saldo no gateway ou do plano ilimitado, em vez de uma conta Anthropic. 

## Onde ficam as configurações 
- CLAUDE.md na raiz do repositório (e CLAUDE.local.md para anotações pessoais) — memória do projeto, lida em todas as sessões.
- .claude/settings.json — permissões, hooks e variáveis de ambiente por projeto; ~/.claude/settings.json — global.
- ~/.claude/skills/ e .claude/skills/ — skills; .claude/agents/ — definições de subagentes.
- Ambiente: ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY / ANTHROPIC_AUTH_TOKEN e as substituições de modelo por nível abordadas no guia de modelos.

## Experimente gratuitamente primeiro

Novas contas recebem $5 em crédito gratuito para a API com o código CLAUDECODE — suficiente para uma noite de Claude Code com Sonnet — e depois créditos com 7.69231× o valor nominal.

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[Crie uma conta com o código CLAUDECODE](/register?promo=CLAUDECODE)

## Perguntas frequentes

Como executar o Claude Code sem o prompt interativo?

Use o modo de impressão: claude -p "seu prompt". Combine-o com --allowedTools e --output-format json para scripts e envie arquivos por pipe para stdin.O que /compact faz?

Ele pede ao modelo que resuma a conversa até o momento e substitui o histórico por esse resumo. O contexto diminui, o custo por turno cai e a sessão pode continuar. Execute-o sempre que uma tarefa mudar de direção.Posso usar o Claude Code com uma URL base de API diferente?

Sim — defina ANTHROPIC_BASE_URL. /status confirma qual endpoint a sessão está usando.

## Execute o Claude Code no gateway

Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código CLAUDECODE.[Obter uma chave de API](/register?promo=CLAUDECODE) [Ver planos ilimitados](/pt/plans/)

A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.

## Mais guias do Claude Code

[Claude Code: o guia completo](/pt/claude-code/)[Como instalar o Claude Code](/pt/claude-code/install/)[Preços e limites do Claude Code, explicados](/pt/claude-code/pricing/)[O SDK do Claude Code, agora Claude Agent SDK](/pt/claude-code/sdk/)[Skills e plugins do Claude Code](/pt/claude-code/skills/)[Claude Code no GitHub: o App, a Action e @claude](/pt/claude-code/github/)[O Claude Code tem uma interface web? Entenda as versões web, desktop e para IDE](/pt/claude-code/web-and-desktop/)[Qual modelo o Claude Code usa e como alterá-lo](/pt/claude-code/models/)[Erros do Claude Code e como corrigi-los](/pt/claude-code/errors/)[O Claude Code é de código aberto?](/pt/claude-code/open-source/)[Tutorial do Claude Code: sua primeira sessão real](/pt/claude-code/tutorial/)[Claude para estudantes: Claude Code, a API e o que você realmente ganha na área de educação](/pt/claude-code/for-students/)[Como usar o Claude Code para automação de QA](/pt/claude-code/qa-automation/)[Claude Code vs Cursor: qual usar, quando — e como usar ambos](/pt/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: comparação dos agentes de terminal](/pt/claude-code/vs-codex/)[Subagentes do Claude Code: como funcionam, como defini-los e equipes de agentes](/pt/claude-code/subagents/)[Hooks do Claude Code: controle determinístico sobre o que o agente faz](/pt/claude-code/hooks/)[MCP no Claude Code: conexão de servidores, escopos, MCP remoto e exemplos reais](/pt/claude-code/mcp/)[O ecossistema do Claude Code: roteadores, frameworks, plugins e as listas que os acompanham](/pt/claude-code/ecosystem/)[Claude Code no VS Code: a extensão, o uso pelo terminal e os erros](/pt/claude-code/vscode/)[Como usar o OpenRouter no Claude Code (e quando não usar)](/pt/claude-code/openrouter/)[Erro de limite de taxa do Claude: o que significa "Erro de API: limite de taxa atingido" e como corrigir](/pt/claude-code/rate-limits/)[Como usar o Claude Code: da instalação ao uso diário](/claude-code/zh/)