O Claude Code é um agente de codificação focado no terminal, desenvolvido pela Anthropic. Ele lê seu código-fonte, edita arquivos, executa comandos e pode se conectar a backends compatíveis com a Anthropic, em vez de usar apenas a API padrão da Anthropic. Este guia aborda a configuração da CLI do Claude Code, comandos slash, habilidades personalizadas e como rotear requisições através da Novita AI.
Se você precisar de bancos de dados, navegadores ou outras ferramentas externas, combine isso com o guia de configuração do MCP do Claude.
Principais Conclusões
- O Claude Code é um agente de linha de comando, não apenas uma caixa de prompt.
/compact,/resume,/permissionse/modelsão comandos de sessão, enquanto-pe--resumesão flags da CLI.- Comandos slash personalizados agora vivem como skills, então tanto
.claude/skills/quanto.claude/commands/são importantes. - A Novita AI pode servir como backend compatível com a Anthropic através de
ANTHROPIC_BASE_URL. - O Claude Code se adequa tanto a fluxos de trabalho no estilo IDE quanto a execuções automatizadas de agentes.
O que é o Claude Code?
O Claude Code é a ferramenta de codificação agente da Anthropic. A CLI é executada no seu terminal, mas o mesmo agente também aparece no aplicativo desktop, na interface do navegador e nas integrações com editores.
A CLI é a superfície mais flexível. Ela segue as convenções Unix, então você pode usar pipes para enviar arquivos, executá-la de forma não interativa com -p e integrá-la a scripts ou CI. A configuração reside em CLAUDE.md, .claude/settings.json e variáveis de ambiente, o que a torna uma excelente opção para fluxos de trabalho de codificação repetíveis.
Internamente, o Claude Code envia requisições para um endpoint de API compatível com a Anthropic. Por padrão, esse endpoint é o serviço da própria Anthropic, mas você pode redirecioná-lo para a API LLM da Novita AI com uma única variável de ambiente.
Configuração do Claude Code
Instalação
Instale a CLI com Node.js 18 ou superior:
npm install -g @anthropic-ai/claude-code
Primeira Execução
Inicie o Claude Code em um diretório de projeto:
cd your-project
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, anotações 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 da CLI
| 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 |
cat arquivo | claude -p "consulta" |
Enviar conteúdo via pipe para uma consulta |
claude -c |
Continuar a sessão mais recente no diretório atual |
claude -r "nome" "consulta" |
Retomar uma sessão pelo nome ou ID |
claude update |
Atualizar para a versão mais recente |
claude install stable |
Instalar ou reinstalar o binário estável |
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 mcp |
Configurar servidores MCP |
claude doctor |
Mostrar diagnósticos de instalação e configurações |
Referência de Flags da CLI
| Flag | O que faz |
|---|---|
-p, --print |
Modo não interativo; imprime a resposta e sai |
-c, --continue |
Carregar a conversa mais recente |
-r, --resume |
Retomar uma sessão por ID ou nome |
--model |
Definir o modelo para esta sessão |
--permission-mode |
Iniciar em um modo de permissão |
--add-dir |
Conceder acesso a arquivos em um diretório adicional |
--system-prompt |
Substituir o prompt de sistema completamente |
--append-system-prompt |
Anexar ao prompt de sistema padrão |
--max-turns |
Limitar turnos de agente no modo -p |
--max-budget-usd |
Limitar gasto da API no modo -p |
--output-format |
Formato de saída para o modo -p: text, json, stream-json |
--bg |
Iniciar como agente em segundo plano, retornar imediatamente |
--worktree, -w |
Iniciar em uma git worktree isolada |
--bare |
Pular a descoberta automática de hooks, skills, plugins e MCP para chamadas de script mais rápidas |
--verbose |
Mostrar saída completa turno a turno |
--mcp-config |
Carregar servidores MCP a partir de um arquivo JSON |
--effort |
Definir esforço de raciocínio |
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
Os comandos slash 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 |
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 de 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 uma direção diferente |
/rewind |
Reverter o código e a conversa para um ponto de verificação |
Configuração do Projeto
| Comando | Propósito |
|---|---|
/init |
Gerar um CLAUDE.md inicial para o projeto |
/memory |
Editar arquivos CLAUDE.md e gerenciar a memória automática |
/mcp |
Gerenciar conexões de servidores MCP interativamente |
/agents |
Configurar definiçõ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 interativo de diffs |
/code-review [--fix] |
Revisar o diff atual; --fix aplica as descobertas |
/security-review |
Passagem de segurança profunda 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 |
/skills |
Listar skills disponíveis |
Comandos Slash Personalizados
Comandos slash personalizados agora vivem como skills. Arquivos .claude/commands/ existentes ainda funcionam, mas .claude/skills/ é o formato preferido.
Como Criar um Comando Personalizado
Crie um diretório em .claude/skills/ (nível do projeto) ou ~/.claude/skills/ (pessoal):
mkdir -p .claude/skills/review-pr
Crie um arquivo SKILL.md dentro desse diretório:
---
description: Revisar um PR aberto no GitHub em busca de problemas de segurança e lacunas de cobertura de testes.
---
## Instruções
Revise o pull request com estas prioridades:
1. Identifique vulnerabilidades de segurança.
2. Verifique a cobertura de testes para novos caminhos de código.
3. Sinalize a falta de tratamento de erros nos limites do sistema.
Isso cria um comando /review-pr que você pode invocar diretamente:
/review-pr
O Claude também carrega a skill automaticamente quando você pergunta algo que corresponda à descrição.
Locais das Skills e Prioridade
~/.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 ambos criam /deploy.
Usando a Novita AI como Backend LLM
O Claude Code roteia o tráfego da API através de ANTHROPIC_BASE_URL. Definir isso para o endpoint compatível com a Anthropic da Novita AI permite que você use modelos Novita sem alterar o fluxo de trabalho do Claude Code.
Obtenha sua Chave de API da Novita AI
Crie uma conta na Novita AI para receber créditos de teste gratuitos. Em seguida, abra a página de 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="moonshotai/kimi-k2-instruct"
export ANTHROPIC_SMALL_FAST_MODEL="moonshotai/kimi-k2-instruct"
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=moonshotai/kimi-k2-instruct
set ANTHROPIC_SMALL_FAST_MODEL=moonshotai/kimi-k2-instruct
ANTHROPIC_SMALL_FAST_MODEL controla o modelo leve que o Claude Code usa para tarefas internas rápidas, como buscas em arquivos e resumos rápidos.
Inicie o Claude Code
cd your-project
claude
Para scripts e CI, a mesma abordagem se aplica:
cat logs.txt | claude -p "encontre padrões de erro" --output-format json
A API LLM da Novita AI suporta o formato de mensagens da Anthropic, incluindo uso de ferramentas, saídas estruturadas e streaming, então o Claude Code funciona sem modificações.
Agent Sandbox para Execução Isolada
Se você está construindo pipelines automatizados sobre o Claude Code, o Agent Sandbox da Novita AI oferece execução isolada para execuções de agentes, o que é útil para fluxos de trabalho de CI e trabalhos de codificação em várias etapas.
Claude Code como Ferramenta de IDE
O Claude Code é frequentemente descrito como “um IDE” porque se insere no seu fluxo de trabalho existente em vez de substituí-lo. Mais precisamente, é uma camada de agente que funciona com seu terminal, editor e contexto do projeto.
VS Code e Cursor
Instale a extensão Claude Code no Marketplace do VS Code ou no marketplace do Cursor. Após instalar, abra a Paleta de Comandos, digite “Claude Code” e selecione Open in New Tab.
A integração com VS Code adiciona revisão inline de diffs, menções a arquivos, revisão de planos 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. Ele fornece visualização interativa de diffs e compartilhamento de contexto de seleção no IntelliJ IDEA, PyCharm, WebStorm e outras IDEs JetBrains.
Aplicativo Desktop e Web
O aplicativo desktop do Claude Code permite visualizar diffs graficamente e executar várias sessões lado a lado. A interface web em claude.ai/code executa sessões no navegador sem necessidade de configuração local.
FAQ
O que é ANTHROPIC_BASE_URL e por que isso importa?
ANTHROPIC_BASE_URL informa ao Claude Code qual endpoint de API deve receber as requisições. O padrão é a API da Anthropic. Definir como https://api.novita.ai/anthropic redireciona o tráfego para o endpoint compatível com a Anthropic da Novita AI.
Qual é a diferença entre flags da CLI e comandos slash?
As flags da CLI são definidas quando você inicia o claude a partir do seu shell. Os comandos slash 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 do Claude?
Sim. claude auth login --console faz login com faturamento por chave de API do Console da Anthropic. Se você rotear para a Novita AI via ANTHROPIC_BASE_URL, precisará apenas de uma conta na Novita AI.
Como os comandos slash personalizados diferem do CLAUDE.md?
O CLAUDE.md é carregado no início de cada sessão e permanece no contexto. As skills são carregadas apenas quando invocadas. Portanto, use CLAUDE.md para fatos de projeto sempre ativos e skills para procedimentos repetíveis.
O Claude Code funciona em CI?
Sim. Use claude -p "consulta" --output-format json para modo não interativo. Adicione --max-budget-usd para limitar gastos e --max-turns para limitar o tempo de execução.
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.
