Publicado originalmente em claudeguide.io/claude-code-korean-guide

Claude Code: Guia Completo - Da Instalação ao Uso Avançado (2026)

Claude Code é um agente de codificação AI que roda no terminal (com base em 2026). Instale com a linha npm install -g @anthropic-ai/claude-code e, ao digitar o comando claude na pasta do projeto, você pode usá-lo imediatamente. Não é apenas uma simples autocompletação de código, mas um agente autônomo que lê e modifica arquivos e executa comandos no terminal. Este guia cobre tudo, desde a instalação até as configurações avançadas do CLAUDE.md, integração com servidores MCP e execução paralela de subagentes.

Instalação e Configuração Inicial

Passo 1: Verificar Node.js

Claude Code requer Node.js versão 18 ou superior.

node --version   # Deve ser v18.0.0 ou superior

Se você não tiver o Node.js ou se a versão for baixa, instale a versão LTS mais recente em nodejs.org.

Passo 2: Instalar Claude Code

npm install -g @anthropic-ai/claude-code

Após a instalação, verifique a versão:

claude --version

Passo 3: Autenticação da Conta Anthropic

claude

Na primeira execução, o navegador será aberto solicitando que você faça login na sua conta Anthropic. Você será autenticado se tiver uma assinatura Claude.ai Pro ou Max, ou se tiver uma chave de API da Anthropic.

Para autenticar diretamente com a chave da API:

export ANTHROPIC_API_KEY="sk-ant-api03-..."
claude

Uso Básico

Modo Interativo

Ao digitar claude na pasta do projeto, o modo interativo será iniciado:

No diretório do projeto:
$ cd ~/projects/my-app
$ claude

Principais Comandos Slash

Execução Única Não Interativa

# Solicitação de revisão de código
claude "Revise o diff deste PR e encontre problemas de segurança"

# Análise de arquivo
claude "Encontre vulnerabilidades no arquivo src/auth/login.ts"

# Criação de testes
claude "Crie um teste unitário para a classe UserService"

CLAUDE.md — Arquivo de Configuração do Projeto

CLAUDE.md é o arquivo de configuração que informa ao Claude Code sobre o contexto do projeto. Ao criar um arquivo CLAUDE.md na raiz do projeto, ele será carregado automaticamente em todas as sessões.

Modelo Básico

# Visão Geral do Projeto

Este projeto é um aplicativo SaaS feito com Next.js 15 + TypeScript.
DB: PostgreSQL (Drizzle ORM), Autenticação: Clerk, Implantação: Vercel.

## Estilo de Código

- Usar modo estrito do TypeScript
- Componentes: App Router (priorizar componentes do servidor)
- CSS: Tailwind CSS (componentes shadcn/ui)
- Testes: Vitest + Testing Library
- Proibido o commit de `console.log`

## Estrutura de Diretórios

- `app/` — Roteador Next.js (App Router)
- `lib/` — Utilitários compartilhados e cliente DB
- `components/` — Componentes de UI reutilizáveis

## Comandos de Desenvolvimento

bash
bun run dev # Servidor de desenvolvimento
bun run build # Build de produção
bun run test # Executar testes
bun run typecheck # Verificação de tipos

## Restrições Importantes

- As migrações do DB devem sempre usar `bun run db:migrate`
- A chave da API nunca deve ser hardcoded no código
- Usar Drizzle ORM em vez de Prisma

markdown

Uso Avançado do CLAUDE.md

Registro de padrões frequentemente usados:

## Padrões Repetidos

Ao adicionar novas rotas de API, consulte este arquivo: `app/api/_template/route.ts`
Ao adicionar novas tabelas ao DB: adicione ao schema.ts → `bun run db:generate` → `bun run db:migrate`

Referência a Documentos Externos:

## Documentos Relacionados

- Especificação da API: docs/api-spec.md
- Esquema do DB: docs/schema.md
- Guia de Implantação: docs/deploy.md

Configuração de Permissões (.claude/settings.json)

Claude Code solicita permissões poderosas, como modificar arquivos, executar comandos no terminal e realizar buscas na web. Você pode controlar isso de forma detalhada com .claude/settings.json.

{
  "permissions": {
    "allow": [
      "Bash(bun run *)",
      "Bash(git log *)",
      "Bash(git diff *)",
      "Bash(cat *)",
      "Bash(ls *)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push --force *)"
    ]
  }
}

Dica: Você pode verificar o estado atual das permissões com o comando /doctor.

Integração com o Servidor MCP

O MCP (Modelo de Protocolo de Contexto) permite que o Claude Code se integre a serviços externos. Você pode controlar diretamente o GitHub, Slack, bancos de dados, buscas na web, etc., a partir do Claude Code.

Como Adicionar um Servidor MCP

# Adicionar servidor MCP do GitHub
claude mcp add github npx @modelcontextprotocol/server-github

# Servidor MCP de Sistema de Arquivos (acesso a arquivos locais)
claude mcp add filesystem npx @modelcontextprotocol/server-filesystem /path/to/dir

Ou adicione diretamente em ~/.claude/settings.json:

{
  "mcpServ