O Claude Code é um agente de codificação de linha de comando da Anthropic que lê sua base de código, edita arquivos, executa comandos e se conecta a APIs LLM no backend. Este guia cobre a documentação completa do CLI: como configurá-lo, quais flags e slash commands estão disponíveis, como escrever slash commands personalizados e como rotear suas chamadas de API para a Novita AI em vez do endpoint padrão da Anthropic.
O que é o Claude Code?
O Claude Code é uma ferramenta de codificação agêntica disponível como CLI, uma extensão do VS Code, um plugin do JetBrains, um aplicativo desktop e uma interface de navegador. Todas as superfícies compartilham o mesmo motor subjacente: o Claude Code se conecta a um backend de API LLM, lê seu projeto e executa tarefas de várias etapas, como escrever testes, refatorar entre arquivos, criar pull requests e gerenciar git.
O CLI é a superfície mais flexível. Segue as convenções Unix — você pode canalizar logs para ele, executá-lo em CI com a flag -p ou encadeá-lo com outras ferramentas. A configuração reside em arquivos (CLAUDE.md, .claude/settings.json, variáveis de ambiente), então ele se comporta de forma previsível em contextos automatizados.
Internamente, o Claude Code envia cada requisição para um endpoint de API compatível com Anthropic. Por padrão, esse endpoint é api.anthropic.com, mas você pode redirecioná-lo para qualquer provedor compatível com Anthropic — incluindo a Novita AI — com uma única variável de ambiente.
Configuração do Claude Code
Instalação
O método recomendado em macOS, Linux e WSL é o instalador nativo:
curl -fsSL https://claude.ai/install.sh | bash
No Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
As instalações nativas são atualizadas automaticamente em segundo plano.
Se preferir npm, o Node.js 18 ou superior é necessário:
node --version # deve ser 18 ou superior
npm install -g @anthropic-ai/claude-code
Homebrew (macOS) segue o canal de versão estável:
brew install --cask claude-code
O Homebrew não atualiza automaticamente. Execute brew upgrade claude-code quando quiser a versão mais recente.
Primeira execução
Navegue até um diretório de projeto e inicie a sessão interativa:
cd seu-projeto
claude
No primeiro uso, o Claude Code solicita que você faça login. Após a autenticação, ele lê seu projeto e aguarda instruções.
Configuração do projeto
Execute /init em qualquer repositório novo para gerar um arquivo CLAUDE.md inicial. O Claude Code lê CLAUDE.md no início de cada sessão, então é o lugar ideal para padrões de codificação, bibliotecas preferidas, notas de arquitetura e listas de verificação de revisão.
/init
Após /init, use /memory para editar o arquivo ou ativar a memória automática, que salva observações que o Claude faz sobre seu projeto em diferentes sessões.
Referência de Comandos CLI
Os comandos de shell de nível superior do Claude Code iniciam sessões, gerenciam autenticação e lidam com trabalhos em segundo plano. Uma lista parcial dos mais úteis:
| Comando | Descrição |
|---|---|
claude |
Inicia uma sessão interativa no diretório atual |
claude "consulta" |
Inicia uma sessão com um prompt inicial |
claude -p "consulta" |
Executa uma consulta e sai (modo não interativo / SDK) |
cat arquivo | claude -p "consulta" |
Canaliza conteúdo para uma consulta |
claude -c |
Continua a sessão mais recente no diretório atual |
claude -r "nome" "consulta" |
Retoma uma sessão por nome ou ID |
claude update |
Atualiza para a versão mais recente |
claude install stable |
Instala ou reinstala uma versão específica |
claude auth login |
Faz login na sua conta Anthropic |
claude auth login --console |
Faz login com faturamento por chave de API em vez de assinatura |
claude auth status |
Mostra o status de autenticação |
claude agents --json |
Abre a visualização de agentes, imprime sessões ativas como JSON |
claude mcp |
Configura servidores MCP |
claude daemon status |
Verifica o estado do supervisor de sessão em segundo plano |
Se você digitar errado um subcomando, o Claude Code sugere a correspondência mais próxima: claude udpate imprime Did you mean claude update?.
Referência de Flags CLI
As flags modificam como o Claude Code se comporta durante uma sessão. Passe-as após claude em qualquer invocação. Uma seleção das flags mais comumente necessárias:
| Flag | O que faz |
|---|---|
-p, --print |
Modo não interativo; imprime resposta e sai |
-c, --continue |
Carrega a conversa mais recente |
-r, --resume |
Retoma uma sessão por ID ou nome |
--model |
Define o modelo para esta sessão (sonnet, opus, haiku, ou um ID de modelo completo) |
--permission-mode |
Inicia em um modo de permissão: default, plan, auto, acceptEdits, bypassPermissions |
--add-dir |
Concede acesso a arquivos para um diretório adicional |
--system-prompt |
Substitui o prompt de sistema completamente |
--append-system-prompt |
Adiciona ao prompt de sistema padrão |
--max-turns |
Limita turnos agênticos no modo -p |
--max-budget-usd |
Limita o gasto da API no modo -p |
--output-format |
Formato de saída para o modo -p: text, json, stream-json |
--bg |
Inicia como agente em segundo plano, retorna imediatamente |
--worktree, -w |
Inicia em uma worktree git isolada |
--bare |
Pula a descoberta automática de hooks, skills, plugins, MCP para chamadas scriptadas mais rápidas |
--verbose |
Mostra a saída completa turno a turno |
--mcp-config |
Carrega servidores MCP de um arquivo JSON |
--effort |
Define o esforço de raciocínio: low, medium, high, xhigh, max |
A combinação --print + --output-format json é o padrão para scripts. Para pipelines de CI com restrições de orçamento, combine com --max-budget-usd e --max-turns.
Documentação dos Slash Commands
Slash commands são executados dentro de uma sessão ativa. Digite / para ver tudo disponível, ou / seguido de letras para filtrar. Os comandos funcionam apenas no início de uma mensagem.
Gerenciamento de sessão e contexto
| Comando | Propósito |
|---|---|
/clear |
Inicia uma nova conversa; a sessão anterior permanece disponível em /resume |
/compact |
Resume a conversa para liberar espaço na janela de contexto |
/context |
Visualiza o uso do contexto e vê sugestões de otimização |
/resume |
Reabre uma sessão anterior por nome ou a partir de um seletor |
/branch |
Bifurca a conversa para tentar uma direção diferente |
/rewind |
Reverte o código e a conversa para um checkpoint |
Configuração do projeto
| Comando | Propósito |
|---|---|
/init |
Gera um arquivo CLAUDE.md inicial para o projeto |
/memory |
Edita arquivos CLAUDE.md e gerencia a memória automática |
/mcp |
Gerencia conexões de servidor MCP interativamente |
/agents |
Configura as configurações de subagentes |
/permissions |
Define regras de permitir, perguntar e negar para ferramentas |
/hooks |
Visualiza configurações de hooks |
Fluxo de trabalho de desenvolvimento
| Comando | Propósito |
|---|---|
/plan |
Entra no modo de planejamento antes de uma grande alteração |
/model |
Alterna o modelo ativo |
/effort |
Ajusta o nível de esforço de raciocínio |
/diff |
Abre o visualizador de diff interativo |
/code-review [--fix] |
Revisa o diff atual; --fix aplica as descobertas |
/security-review |
Passagem profunda de segurança nas alterações pendentes |
/batch <instrução> |
Decompõe uma grande alteração e executa em worktrees paralelas |
/background |
Desanexa a sessão para executar como agente em segundo plano |
Utilitários
| Comando | Propósito |
|---|---|
/help |
Mostra comandos disponíveis |
/doctor |
Diagnostica problemas de instalação e configuração |
/usage |
Mostra o custo da sessão e o uso do plano |
/export |
Exporta a conversa como texto simples |
/config |
Abre configurações ou define um valor diretamente: /config thinking=false |
/skills |
Lista skills disponíveis |
Slash Commands Personalizados
Slash commands personalizados — agora chamados de skills — permitem que você empacote procedimentos repetíveis que sua equipe pode compartilhar.
Como criar um comando personalizado
Crie um diretório sob .claude/skills/ (nível do projeto) ou ~/.claude/skills/ (pessoal, disponível em todos os projetos):
mkdir -p .claude/skills/review-pr
Crie um arquivo SKILL.md dentro desse diretório:
---
description: Review an open GitHub PR for security issues and test coverage gaps. Use when the user asks to review a PR or check pull request quality.
---
## Instructions
Review the pull request with these priorities:
1. Identify any security vulnerabilities: injection risks, auth gaps, data exposure.
2. Check test coverage for new code paths.
3. Flag any missing error handling at system boundaries.
Summarize findings in three sections: Security, Coverage, Other. Use ✓ for passing checks and ⚠ for issues.
Isso cria um comando /review-pr que você pode invocar diretamente:
/review-pr
O Claude também carrega o skill automaticamente quando você faz algo que corresponda à descrição.
Locais dos skills e prioridade
Os skills seguem uma ordem de prioridade: empresa substitui pessoal, pessoal substitui projeto. Skills do projeto estão em .claude/skills/. Skills pessoais (disponíveis em todos os seus projetos) vão em ~/.claude/skills/.
~/.claude/skills/ → pessoal, todos os projetos
.claude/skills/ → apenas este projeto
Comandos personalizados em .claude/commands/ ainda funcionam. Um arquivo em .claude/commands/deploy.md e um skill em .claude/skills/deploy/SKILL.md ambos criam /deploy e se comportam da mesma forma.
Injeção de contexto dinâmico
Skills podem injetar dados ao vivo antes de o Claude ver o prompt. O prefixo ! executa um comando shell e incorpora sua saída:
---
description: Summarize uncommitted changes and flag risks.
---
## Current diff
!`git diff HEAD`
## Instructions
Summarize the changes in bullet points. Flag any risks: missing error handling, hardcoded values, untested paths.
Quando você executa este skill, o Claude Code executa git diff HEAD e substitui essa linha pela saída real do diff. O Claude vê o estado real da árvore de trabalho em vez de precisar solicitá-lo por meio de chamadas de ferramenta.
Usando a Novita AI como Backend LLM
O Claude Code roteia todo o tráfego da API através da variável de ambiente ANTHROPIC_BASE_URL. Configurá-la para o endpoint compatível com Anthropic da Novita AI oferece acesso a uma ampla gama de modelos — incluindo variantes DeepSeek, Kimi, Qwen e GLM — a um custo por token substancialmente menor do que o endpoint padrão da Anthropic.
Obtenha sua chave de API da Novita AI
Crie uma conta Novita AI para receber créditos de teste gratuitos. Navegue até a página Key Management, clique em Create New Key e copie a chave imediatamente.
Defina variáveis de ambiente
No Mac e Linux:
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Sua Chave de API Novita>"
export ANTHROPIC_MODEL="deepseek/deepseek-v4-flash"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek/deepseek-v4-flash"
No Windows (Command Prompt):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Sua Chave de API Novita>
set ANTHROPIC_MODEL=deepseek/deepseek-v4-flash
set ANTHROPIC_SMALL_FAST_MODEL=deepseek/deepseek-v4-flash
Para persistir essas no Mac/Linux, adicione as linhas export ao ~/.bashrc ou ~/.zshrc.
ANTHROPIC_SMALL_FAST_MODEL controla o modelo leve que o Claude Code usa para tarefas internas rápidas, como consultas de arquivos e resumos rápidos. Definir para o mesmo ID de modelo mantém todo o tráfego em uma única conta de faturamento.
Inicie o Claude Code
Com as variáveis de ambiente definidas, inicie o Claude Code normalmente:
cd seu-projeto
claude
O Claude Code se conecta ao endpoint da Novita AI com o modelo que você especificou. A sessão interativa funciona de forma idêntica — todas as flags CLI, slash commands e skills personalizados se comportam da mesma forma, independentemente de qual backend está em uso.
Para scripts e CI, a mesma abordagem se aplica:
cat logs.txt | claude -p "encontre quaisquer padrões de erro" --output-format json
A API LLM da Novita AI suporta o formato completo de mensagens Anthropic, incluindo uso de ferramentas, saídas estruturadas e streaming, portanto, todos os recursos do Claude Code funcionam sem modificação.
Agent Sandbox para execução isolada
Se você estiver construindo pipelines automatizados com o Claude Code, o Agent Sandbox da Novita AI fornece ambientes de execução isolados e com suporte a firecracker para executar agentes programaticamente. Isso é relevante para fluxos de trabalho de CI, agentes em segundo plano e qualquer configuração multiagente onde você precise de isolamento de execução em vez de executar diretamente em sua máquina de desenvolvimento.
Claude Code como Ferramenta IDE
O Claude Code se integra diretamente com editores, que é o que as pessoas querem dizer quando falam “Claude Code é uma IDE” — não é uma IDE autônoma, mas um agente de codificação que se incorpora ao seu ambiente existente.
VS Code e Cursor
Instale a extensão Claude Code no VS Code Marketplace (pesquise “Claude Code”) ou no Cursor marketplace. Após a instalação, abra a Paleta de Comandos (Cmd+Shift+P / Ctrl+Shift+P), digite “Claude Code” e selecione Open in New Tab.
A integração com VS Code adiciona revisão de diff inline, menções a arquivos com @, revisão de plano antes de edições e histórico de conversas diretamente no painel do editor. Você também pode usar o Claude Code no terminal integrado junto com a extensão.
JetBrains
Instale o plugin Claude Code no JetBrains Marketplace e reinicie sua IDE. O plugin requer o CLI instalado separadamente. Ele fornece visualização de diff interativa e compartilhamento de contexto de seleção no IntelliJ IDEA, PyCharm, WebStorm e outras IDEs JetBrains.
Aplicativo desktop e web
O aplicativo desktop Claude Code (macOS e Windows) permite revisar diffs visualmente, executar várias sessões lado a lado e agendar tarefas recorrentes. A interface web em claude.ai/code executa sessões no navegador sem configuração local, útil para repositórios que você não tem localmente ou para iniciar tarefas de longa duração que você pode monitorar remotamente.
FAQ
O que é ANTHROPIC_BASE_URL e por que isso importa?
ANTHROPIC_BASE_URL informa ao Claude Code para qual endpoint de API enviar as requisições. O padrão é api.anthropic.com. Configurá-lo para https://api.novita.ai/anthropic roteia todo o tráfego para o endpoint compatível com Anthropic da Novita AI, onde você pode usar modelos alternativos a preços diferentes. Nenhuma alteração de código ou plugins são necessários — apenas a variável de ambiente.
Qual é a diferença entre flags CLI e slash commands?
Flags CLI (como --model, --permission-mode, --max-turns) são definidas quando você inicia o binário claude a partir do seu shell. Elas configuram a sessão antes de ela começar. Slash commands (como /model, /plan, /compact) são executados dentro de uma sessão ativa e alteram o comportamento no meio da conversa.
Posso usar o Claude Code sem uma assinatura Claude?
Sim. claude auth login --console faz login com faturamento por chave de API do Anthropic Console, que usa preço por token em vez de uma assinatura. Se você rotear para a Novita AI via ANTHROPIC_BASE_URL, você só precisa de uma conta Novita AI — sua conta Anthropic não é cobrada.
Como os slash commands personalizados diferem do CLAUDE.md?
O conteúdo do CLAUDE.md é carregado no início de cada sessão e permanece no contexto durante toda a sessão. Skills (comandos personalizados) são carregados apenas quando invocados, então material de referência longo não adiciona custo de token até que você realmente precise. Use CLAUDE.md para fatos do projeto que o Claude deve sempre saber — padrões de codificação, comandos de build, notas de arquitetura. Use skills para procedimentos que você executa sob demanda — listas de verificação de revisão de PR, etapas de implantação, fluxos de trabalho de geração de testes.
O Claude Code funciona em CI?
Sim. Use claude -p "consulta" --output-format json para modo não interativo com saída estruturada. Adicione --max-budget-usd para limitar gastos e --max-turns para limitar o tempo de execução. A flag --bare pula a descoberta automática de hooks, skills e plugins para inicialização mais rápida em contextos scriptados. O Claude Code também se integra com GitHub Actions e GitLab CI/CD por meio de modelos de fluxo de trabalho oficiais.
A Novita AI é uma plataforma de nuvem de IA que oferece aos desenvolvedores uma maneira fácil de implantar modelos de IA usando nossa API simples, além de fornecer GPU em nuvem acessível e confiável para construir e escalar.
