O Claude Code é um agente de codificação de linha de comando da Anthropic que lê seu código-fonte, edita arquivos, executa comandos e se conecta a APIs LLM no backend. Este guia aborda a configuração, flags, comandos slash, comandos personalizados e o roteamento de chamadas de API para a Novita AI. Para conectar bancos de dados, navegadores ou executores de código, use o guia de configuração do Claude MCP separado para configuração CLI e JSON.
O que é o Claude Code?
O Claude Code é uma ferramenta de codificação agêntica disponível como CLI, extensão para VS Code, plugin para JetBrains, aplicativo desktop e interface web. 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. Ele segue as convenções Unix — você pode redirecionar 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 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 no 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
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 certo 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 entre 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 |
Iniciar uma sessão interativa no diretório atual |
claude "consulta" |
Iniciar uma sessão com um prompt inicial |
claude -p "consulta" |
Executar uma consulta e sair (modo não interativo / SDK) |
cat arquivo | claude -p "consulta" |
Redirecionar conteúdo para uma consulta |
claude -c |
Continuar a sessão mais recente no diretório atual |
claude -r "nome" "consulta" |
Retomar uma sessão por nome ou ID |
claude update |
Atualizar para a versão mais recente |
claude install stable |
Instalar ou reinstalar uma versão específica |
claude auth login |
Fazer login na sua conta Anthropic |
claude auth login --console |
Fazer login com faturamento por chave de API em vez de assinatura |
claude auth status |
Mostrar status de autenticação |
claude agents --json |
Abrir visualização de agentes, imprimir sessões ativas como JSON |
claude mcp |
Configurar servidores MCP |
claude daemon status |
Verificar o estado do supervisor de sessão em segundo plano |
Se você digitar um subcomando errado, o Claude Code sugere a correspondência mais próxima: claude udpate imprime Você quis dizer claude update?.
Referência de Flags CLI
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 a 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 a um diretório adicional |
--system-prompt |
Substitui o prompt do sistema completamente |
--append-system-prompt |
Anexa ao prompt do sistema padrão |
--max-turns |
Limita as rodadas agênticas 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 um 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 de script mais rápidas |
--verbose |
Mostra a saída completa rodada por rodada |
--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 de Comandos Slash
Comandos slash são executados dentro de uma sessão ativa. Digite / para ver tudo disponível, ou / seguido de letras para filtrar. Comandos só funcionam no início de uma mensagem.
Gerenciamento de sessão e contexto
| Comando | Propósito |
|---|---|
/clear |
Iniciar uma nova conversa; a sessão anterior permanece em /resume |
/compact |
Resumir a conversa para liberar espaço na janela de contexto |
/context |
Visualizar o uso do contexto e ver sugestões de otimização |
/resume |
Reabrir uma sessão anterior por nome ou a partir de um seletor |
/branch |
Bifurcar a conversa para tentar um direção diferente |
/rewind |
Reverter o código e a conversa para um checkpoint |
Configuração do projeto
| Comando | Propósito |
|---|---|
/init |
Gerar um CLAUDE.md inicial para o projeto |
/memory |
Editar arquivos CLAUDE.md e gerenciar memória automática |
/mcp |
Gerenciar conexões de servidor MCP interativamente |
/agents |
Configurar configurações de subagentes |
/permissions |
Definir regras de permitir, perguntar e negar para ferramentas |
/hooks |
Visualizar configurações de hooks |
Fluxo de trabalho de desenvolvimento
| Comando | Propósito |
|---|---|
/plan |
Entrar no modo de planejamento antes de uma grande alteração |
/model |
Alternar o modelo ativo |
/effort |
Ajustar o nível de esforço de raciocínio |
/diff |
Abrir o visualizador de diff interativo |
/code-review [--fix] |
Revisar o diff atual; --fix aplica as descobertas |
/security-review |
Verificação de segurança aprofundada nas alterações pendentes |
/batch <instrução> |
Decompor uma grande alteração e executá-la em worktrees paralelas |
/background |
Desanexar a sessão para executar como agente em segundo plano |
Utilitários
| Comando | Propósito |
|---|---|
/help |
Mostrar comandos disponíveis |
/doctor |
Diagnosticar problemas de instalação e configurações |
/usage |
Mostrar custo da sessão e uso do plano |
/export |
Exportar a conversa como texto simples |
/config |
Abrir configurações ou definir um valor diretamente: /config thinking=false |
/skills |
Listar skills disponíveis |
Comandos Slash Personalizados
Comandos slash personalizados — agora chamados de skills — permitem empacotar procedimentos repetíveis que sua equipe pode compartilhar.
Como criar um comando personalizado
Crie um diretório em .claude/skills/ (nível do projeto) ou ~/.claude/skills/ (pessoal, disponível em todos os projetos):
mkdir -p .claude/skills/revisar-pr
Crie um arquivo SKILL.md dentro desse diretório:
---
description: Revisar um PR aberto do GitHub para problemas de segurança e lacunas de cobertura de teste. Use quando o usuário pedir para revisar um PR ou verificar a qualidade do pull request.
---
## Instruções
Revise o pull request com estas prioridades:
1. Identifique quaisquer vulnerabilidades de segurança: riscos de injeção, lacunas de autenticação, exposição de dados.
2. Verifique a cobertura de teste para novos caminhos de código.
3. Sinalize qualquer tratamento de erro ausente nos limites do sistema.
Resuma as descobertas em três seções: Segurança, Cobertura, Outros. Use ✓ para verificações aprovadas e ⚠ para problemas.
Isso cria um comando /revisar-pr que você pode invocar diretamente:
/revisar-pr
Claude também carrega a skill automaticamente quando você pede algo que corresponda à descrição.
Locais das skills e prioridade
As skills seguem uma ordem de prioridade: enterprise substitui pessoal, pessoal substitui projeto. As skills do projeto estão em .claude/skills/. As skills pessoais (disponíveis em todos os seus projetos) vão para ~/.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 uma skill em .claude/skills/deploy/SKILL.md criam ambos /deploy e se comportam da mesma forma.
Injeção de contexto dinâmico
As skills podem injetar dados ao vivo antes que o Claude veja o prompt. O prefixo ! executa um comando shell e insere sua saída:
---
description: Resumir alterações não confirmadas e sinalizar riscos.
---
## Diff atual
!`git diff HEAD`
## Instruções
Resuma as alterações em tópicos. Sinalize quaisquer riscos: tratamento de erro ausente, valores codificados, caminhos não testados.
Quando você executa esta 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 de API através da variável de ambiente ANTHROPIC_BASE_URL. Definí-la para o endpoint compatível com Anthropic da Novita AI dá acesso a uma ampla gama de modelos — incluindo DeepSeek, Kimi, Qwen e variantes GLM — a um custo por token substancialmente menor do que o endpoint Anthropic padrão.
Obtenha sua chave de API da Novita AI
Crie uma conta na Novita AI para receber créditos de teste gratuitos. Navegue até a página Gerenciamento de Chaves, clique em Criar Nova Chave e copie a chave imediatamente.
Defina as 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 (Prompt de Comando):
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 estas 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 pesquisas de arquivos e resumos rápidos. Definí-lo 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 configuradas, 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, comandos slash e skills personalizadas 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 da Anthropic, incluindo uso de ferramentas, saídas estruturadas e streaming, para que todos os recursos do Claude Code funcionem sem modificação.
Agent Sandbox para execução isolada
Se você estiver construindo pipelines automatizados sobre o Claude Code, o Agent Sandbox da Novita AI fornece ambientes de execução isolados e baseados em firecracker para executar agentes programaticamente. Isso é relevante para fluxos de trabalho de CI, agentes em segundo plano e qualquer configuração multiagente onde você precisa de isolamento de execução em vez de executar diretamente em sua máquina de desenvolvimento.
Claude Code como Ferramenta IDE
O Claude Code integra-se diretamente com editores, que é o que as pessoas querem dizer quando dizem “claude code é um ide” — não é um IDE independente, mas um agente de codificação que se insere no seu ambiente existente.
VS Code e Cursor
Instale a extensão Claude Code no Marketplace do VS Code (pesquise “Claude Code”) ou no marketplace do Cursor. Após a instalação, abra a Paleta de Comandos (Cmd+Shift+P / Ctrl+Shift+P), digite “Claude Code” e selecione Abrir em Nova Aba.
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 seu IDE. O plugin requer o CLI instalado separadamente. Ele fornece visualização de diff interativa e compartilhamento de contexto de seleção em IntelliJ IDEA, PyCharm, WebStorm e outros 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 é importante?
ANTHROPIC_BASE_URL informa ao Claude Code para qual endpoint de API enviar as requisições. O padrão é api.anthropic.com. Definí-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 diferentes faixas de preço. 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 comandos slash?
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. Comandos slash (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 Console Anthropic, 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 é faturada.
Como os comandos slash 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. As skills (comandos personalizados) são carregadas apenas quando invocadas, então o material de referência longo não adiciona custo de token até que você realmente precise dele. 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 teste.
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 de script. O Claude Code também se integra com GitHub Actions e GitLab CI/CD através de modelos de fluxo de trabalho oficiais.
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.
