Documentação da CLI do Claude Code — Comandos, opções, modo sem interface interativa (2026)

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

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 Ver planos ilimitados

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.

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

TLDR