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 Anthropic, em vez de usar apenas a API padrão da Anthropic. Este guia aborda a configuração do Claude Code CLI, comandos de barra, skills personalizados 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 Claude MCP.
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 de barra personalizados agora são tratados como skills, então tanto
.claude/skills/quanto.claude/commands/são relevantes. - A Novita AI pode atuar como backend compatível com Anthropic através de
ANTHROPIC_BASE_URL. - O Claude Code se adapta 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 agêntica da Anthropic. A CLI roda no seu terminal, mas o mesmo agente também aparece no aplicativo desktop, interface do navegador e integrações com editores.
A CLI é a superfície mais flexível. Ela segue as convenções Unix, então você pode enviar arquivos via pipe, executá-la de forma não interativa com -p e integrá-la em scripts ou CI. A configuração fica em CLAUDE.md, .claude/settings.json e variáveis de ambiente, o que a torna uma ótima opção para fluxos de codificação repetíveis. Para um aprofundamento sobre regras de projeto, veja como escrever CLAUDE.md.
Nos bastidores, o Claude Code envia requisições para um endpoint de API compatível com 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. Para contexto de preços, veja preço da API Claude vs planos de assinatura.
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
Na primeira utilização, 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 local ideal para padrões de codificação, bibliotecas preferidas, notas de arquitetura e checklists de revisão.
```text
/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 |
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 |
cat arquivo | claude -p "consulta" |
Envia conteúdo via pipe para uma consulta |
claude -c |
Continua a sessão mais recente no diretório atual |
claude -r "nome" "consulta" |
Retoma uma sessão pelo nome ou ID |
claude update |
Atualiza para a versão mais recente |
claude install stable |
Instala ou reinstala o binário estável |
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 da autenticação |
claude mcp |
Configura servidores MCP |
claude doctor |
Mostra diagnóstico da instalação e configurações |
Referência de Flags da CLI
| 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 pelo ID ou nome |
--model |
Define o modelo para esta sessão |
--permission-mode |
Inicia em um modo de permissão |
--add-dir |
Concede acesso a arquivos em um diretório adicional |
--system-prompt |
Substitui o prompt do sistema completamente |
--append-system-prompt |
Adiciona ao final do prompt do sistema padrão |
--max-turns |
Limita as rodadas agênticas no modo -p |
--max-budget-usd |
Define um teto de 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 e MCP para chamadas de script mais rápidas |
--verbose |
Mostra a saída completa turno a turno |
--mcp-config |
Carrega servidores MCP a partir de um arquivo JSON |
--effort |
Define o 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 dos Comandos de Barra
Os comandos de barra são executados dentro de uma sessão ativa. Digite / para ver tudo o que está disponível, ou / seguido de letras para filtrar. Os comandos só funcionam no início de uma mensagem.
Gerenciamento de Sessão e Contexto
| Comando | Finalidade |
|---|---|
/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 pelo 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 ponto de verificação |
Configuração do Projeto
| Comando | Finalidade |
|---|---|
/init |
Gera um CLAUDE.md inicial para o projeto |
/memory |
Edita arquivos CLAUDE.md e gerencia a memória automática |
/mcp |
Gerencia conexões de servidores MCP interativamente |
/agents |
Configura configurações de subagentes |
/permissions |
Define regras de permitir, perguntar e negar para ferramentas |
/hooks |
Visualiza configurações de hooks |
Fluxo de Desenvolvimento
| Comando | Finalidade |
|---|---|
/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 | Finalidade |
|---|---|
/help |
Mostra os comandos disponíveis |
/doctor |
Diagnostica problemas de instalação e configurações |
/usage |
Mostra o custo da sessão e o uso do plano |
/export |
Exporta a conversa como texto simples |
/config |
Abre as configurações ou define um valor diretamente |
/skills |
Lista os skills disponíveis |
Comandos de Barra Personalizados
Os comandos de barra personalizados agora são tratados como skills. Arquivos existentes em .claude/commands/ 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 do 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 o skill automaticamente quando você pergunta algo que corresponda à descrição.
Locais e Prioridade dos 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.
Usando a Novita AI como Backend LLM
O Claude Code roteia o tráfego da API através de ANTHROPIC_BASE_URL. Definir esse valor para o endpoint compatível com Anthropic da Novita AI oferece acesso aos 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 de 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 quaisquer padrões de erro" --output-format json
A API LLM da Novita AI suporta o formato de mensagens 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ê estiver 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 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 trabalha com seu terminal, editor e contexto do projeto.
VS Code e Cursor
Instale a extensão Claude Code do Marketplace do VS Code ou do marketplace do Cursor. Após instalar, abra a Paleta de Comandos, digite “Claude Code” e selecione Abrir em Nova Guia.
A integração com VS Code adiciona revisão de diff inline, 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 do JetBrains Marketplace e reinicie seu IDE. Ele fornece visualização de diff interativa e compartilhamento de contexto de seleção no IntelliJ IDEA, PyCharm, WebStorm e outros IDEs JetBrains.
Aplicativo Desktop e Web
O aplicativo desktop do Claude Code permite revisar diffs visualmente 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 é importante?
ANTHROPIC_BASE_URL informa ao Claude Code para qual endpoint de API enviar as requisições. O padrão é a API da Anthropic. Definir como https://api.novita.ai/anthropic roteia o tráfego para o endpoint compatível com Anthropic da Novita AI.
Qual é a diferença entre flags da CLI e comandos de barra?
As flags da CLI são definidas quando você inicia o claude a partir do seu shell. Os comandos de barra 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. Se você rotear para a Novita AI via ANTHROPIC_BASE_URL, precisará apenas de uma conta Novita AI.
Como os comandos de barra personalizados diferem do CLAUDE.md?
O CLAUDE.md é carregado no início de cada sessão e permanece no contexto. Os skills são carregados apenas quando invocados, então use CLAUDE.md para fatos do 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.
Artigos Recomendados
- Como Usar Agentes Claude Code: Configuração, Ferramentas, Permissões e Fluxo de Trabalho com Sandbox
- Plugins do Claude Code: Como as Ferramentas MCP Estendem o Claude Code com Capacidades Externas
- Regras do Claude Code: Como Escrever CLAUDE.md e Gerenciar o Contexto de Codificação Agêntica
- Claude MCP: Como Configurar Servidores MCP no Claude Code e Claude Desktop
- Como Usar DeepSeek V4 Flash no Claude Code Através da Novita AI
- Como acessar GLM-4.6 no Claude Code: Guia completo de configuração para desenvolvedores
