Claude Code: шпаргалка

Все команды, флаги, файлы и конфиги одной страницей. Сделай закладку - пригодится.

Установка

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# macOS - Homebrew
brew install --cask claude-code

# Windows - WinGet
winget install Anthropic.ClaudeCode

Старый npm install -g @anthropic/claude-code устарел.

CLI-флаги

Slash-команды (в сессии)

Bundled skills

Горячие клавиши

Файлы и папки

project/
├── CLAUDE.md                       # контекст проекта (стек, команды, правила)
├── .claude/
│   ├── settings.json               # permissions, hooks (проектные)
│   ├── settings.local.json         # личные настройки (gitignore)
│   ├── skills/<name>/SKILL.md      # свои /команды
│   ├── commands/<name>.md          # старый формат skill (обратная совместимость)
│   └── agents/<name>.md            # свои субагенты
├── .mcp.json                       # MCP-серверы (project scope)
└── .env                            # секреты для MCP (gitignore)

~/.claude/
├── settings.json                   # глобальные настройки
├── skills/<name>/SKILL.md          # глобальные skills
├── agents/<name>.md                # глобальные субагенты
└── .claude.json                    # MCP local/user scope

CLAUDE.md - минимум

# Проект

Краткое описание (1-2 строки)

## Стек
- Next.js 15, TypeScript, Prisma, Tailwind

## Команды
- `npm run dev` - dev-сервер
- `npm run test` - тесты
- `npm run lint` - линтер

## Правила
- Без `any` в TS
- Conventional Commits
- Не трогать `src/generated/`

.claude/settings.json - permissions

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git diff *)",
      "Bash(git status)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push *)",
      "WebFetch(*)"
    ]
  }
}

Шаблон правила: Tool(спецификатор) - Bash(npm run *), Read(./.env), Edit(./src/**), WebFetch(domain:example.com), Skill(my-skill). deny побеждает allow.

SKILL.md - frontmatter

---
name: review
description: Код-ревью изменений по стандартам проекта   # ≤1024 симв., решает модель
allowed-tools: Read, Bash                                # ограничить инструменты
argument-hint: "[путь или пусто]"                         # подсказка для $ARGUMENTS
effort: medium                                            # low / medium / high / xhigh / max
context: fork                                             # запустить в субагенте
user-invocable: true                                      # доступен через /имя
disable-model-invocation: false                           # авто-вызов моделью разрешён
model: opus                                               # модель для skill
agent: Explore                                            # тип субагента (если context: fork)
paths: ["src/**/*.ts"]                                    # активация по путям
shell: bash                                               # bash / powershell
when_to_use: "когда меняешь TS-файлы"                     # подсказка модели
hooks: { ... }                                            # скилл-локальные хуки
---

Тело - инструкция агенту обычным Markdown.
$ARGUMENTS - подставляется из вызова /name <args>

Subagent - .claude/agents/<name>.md

---
name: security-reviewer
description: Аудит на уязвимости - injection, утечки, небезопасные зависимости
model: opus
tools: Read, Grep, Bash
---

Проверь изменения на уязвимости. Верни список с файлом и строкой.

Вызов - вручную через /agents или авто-делегирование по description.

MCP - claude mcp add

# Локальный (stdio) - опции ДО имени, команда отделяется `--`
claude mcp add --transport stdio <name> -- npx -y <пакет> [args]

# Удалённый (HTTP)
claude mcp add --transport http <name> <url>

# Scope: local (default), project (→ .mcp.json), user (общий)
claude mcp add --scope project --transport stdio postgres -- npx -y @modelcontextprotocol/server-postgres

# Авторизация для HTTP
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer ${GITHUB_TOKEN}"

claude mcp list             # все серверы
claude mcp get <name>       # детали
claude mcp remove <name>    # удалить
claude mcp logs <name>      # логи (если не работает)

В сессии: /mcp - список доступных инструментов.

.mcp.json - пример

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": { "Authorization": "Bearer ${GITHUB_TOKEN}" }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": { "POSTGRES_CONNECTION_STRING": "${DATABASE_URL}" }
    }
  }
}

Hooks - события

В .claude/settings.json:

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Edit|Write",
      "hooks": [{ "type": "command", "command": "npm run lint -- --fix" }]
    }]
  }
}

Плагины и маркетплейсы

# Подключить маркетплейс
/plugin marketplace add owner/repo

# Установить плагин
/plugin install <имя>@<маркетплейс>

Скиллы из плагина вызываются с префиксом: /имя-плагина:имя-скилла. Официальный маркетплейс claude-plugins-official доступен сразу.

SDK для своих воркфлоу

# TypeScript / JS
npm install @anthropic-ai/claude-agent-sdk

# Python
pip install claude-agent-sdk

import { query } from "@anthropic-ai/claude-agent-sdk";

const result = await query({
  prompt: "Найди все TODO",
  options: { maxTurns: 10, cwd: "/path/to/project" },
});
for await (const m of result) console.log(m);

Глубже в темы

• Установка и базовая настройка
• Skills - свои /команды
• Agents и SDK
• MCP - внешние инструменты
• Свой MCP-сервер с нуля