К основному содержанию
плагин

format-code — плагин для Claude Code: автоформат файлов

Плагин format-code для Claude Code форматирует файл сразу после записи или изменения: ruff для Python, prettier для JS, TS, JSON, MD, YAML и HTML.

MIT ★ 586 обновлён 2026-10-26

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add karanb192/claude-code-hooks
/plugin install format-code@claude-code-hooks
Открыть на GitHub

Что делает format-code

Хук срабатывает на PostToolUse после каждого Write и Edit. Путь берётся из события, относительный разрешается от рабочей папки сессии, дальше по расширению выбирается форматтер. Для .py два прохода: uv run ruff check --fix, затем uv run ruff format. Для .js, .ts, .json, .md, .yaml, .yml и .html — npx --yes prettier --write.

Пути передаются в argv, через шелл ничего не идёт, поэтому имя файла с символами оболочки не превратится в команду. Незнакомые расширения и пропавшие файлы пропускаются молча. Ошибка форматтера сессию не рвёт: в ответ уходит {}, а исход пишется в лог.

Python-часть работает только при uv в PATH, остальному нужен Node с npx. Если prettier локально не стоит, npx --yes скачает его с npm при первом запуске; это единственный сетевой выход хука. Настраивать нечего, переменных окружения нет. Логи лежат в ~/.claude/hooks-logs/<date>.jsonl и содержат пути, исходы и id сессий.

Какие задачи решает

  • привести импорты и отступы в Python-файле к виду ruff сразу после правки
  • не забывать про prettier --write после генерации очередного компонента
  • выровнять JSON и YAML-конфиги, которые агент только что переписал
  • сохранить файл с пробелами и кавычками в имени, не сломав вызов форматтера
  • найти по логу, почему файл остался неотформатированным

Примеры запросов агенту

  • Добавь в utils.py функцию разбора даты и сохрани файл
  • Перепиши package.json, добавь скрипт lint
  • Создай config.yaml с настройками сборки

Как установить format-code

Через маркетплейс плагинов

/plugin marketplace add karanb192/claude-code-hooks
/plugin install format-code@claude-code-hooks

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о format-code

Как установить format-code в Claude Code?

Сначала добавьте маркетплейс: /plugin marketplace add karanb192/claude-code-hooks. Потом поставьте плагин: /plugin install format-code@claude-code-hooks. После этого перезапустите Claude.

Что делает format-code?

Форматирует файл на месте после каждой записи или правки: Python через ruff, JS, TS, JSON, MD, YAML и HTML через prettier. Остальное пропускает.

Что нужно, чтобы хук заработал?

Для Python — uv в PATH, он же запускает ruff. Для остальных типов — Node с npx. Если форматтера нет, хук запишет ошибку в лог и продолжит работу.

Исходный текст

format-code · MIT
# format-code

> Auto-formats Python (ruff) and JS/TS/HTML/JSON/MD/YAML (prettier) the moment Claude edits them.

A `PostToolUse` hook fires after every `Write` and `Edit` call, resolves the file path (relative paths resolve against the session cwd), picks a formatter by extension, and formats the file in place: `uv run ruff check --fix` then `uv run ruff format` for `.py`, `npx --yes prettier --write` for `.js`, `.ts`, `.json`, `.md`, `.yaml`, `.yml`, and `.html`. File paths are passed as argv, never through a shell, so filenames with shell metacharacters cannot inject commands. Unsupported extensions and missing files are skipped silently, a formatter failure never blocks the session, and every outcome (FORMATTED / SKIP / ERROR) is logged.

## Install

```
/plugin marketplace add karanb192/claude-code-hooks   # once per machine
/plugin install format-code@claude-code-hooks
```

Restart Claude Code, done. (Or from a shell: `claude plugin install format-code@claude-code-hooks`.)

## What it does

| Event | Runs | What happens |
|-------|------|--------------|
| PostToolUse (`Write\|Edit`) | sync | Formats the touched file in place with ruff (Python) or prettier (JS/TS/JSON/MD/YAML/HTML), then returns `{}` so the session continues either way. |

Formatters run from your PATH: Python formatting needs `uv` (which runs `ruff`), the rest needs `npx` (Node); `npx --yes` fetches prettier on first use if it is not already installed. If a formatter is missing, the hook logs the error and moves on without blocking.

## Configuration

No configuration needed, and no environment variables to set. Logs go to `~/.claude/hooks-logs/<date>.jsonl` (the log directory is derived from `$HOME`).

## Data & privacy

Rewrites the edited file in place and records file paths, formatter outcomes, and session ids in the local log. The hook itself makes no network calls; the one indirect exception is `npx --yes prettier`, which downloads prettier from the npm registry the first time if it is not installed locally.

## Uninstall

```
/plugin uninstall format-code@claude-code-hooks
```

Part of [claude-code-hooks](https://github.com/karanb192/claude-code-hooks), a collection of production-ready Claude Code hooks, each installable on its own as a plugin.

© Karan Bansal · MIT · karanb192/claude-code-hooks

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
lsp-format-code blackwell-systems Скилл lsp-format-code для Claude Code форматирует исходные файлы или выбранные строки через языковой сервер. Запускается перед коммитом или сразу после генерации кода для выравнивания отступов. CX Codex +1 ★ 182звёзд репо smart-formatting davila7 Хук smart-formatting для Claude Code автоматически форматирует код после правок агента с помощью утилиты, выбранной по расширению файла. 2 972установок baoyu-format-markdown JimLiu Скилл baoyu-format-markdown форматирует plain text и Markdown: добавляет структуру, frontmatter, заголовки, списки и код. Результат сохраняется в {filename}-formatted.md. CX Codex +1 28 800установок format-python-files davila7 Хук format-python-files для Claude Code запускает black на каждом изменённом .py файле. Claude отредактировал код — хук сразу приводит его к единому стилю, руками ничего форматировать не нужно. 1 405установок fix react Скилл fix для Claude Code исправляет форматирование и помогает разбирать ошибки линтера. Его запускают перед коммитом, чтобы проверить готовность к CI. CX Codex +1 2 300установок eslint-prettier-config patricio0312rev Скилл eslint-prettier-config разворачивает ESLint и Prettier в проекте на TypeScript и React: конфиги, правила, скрипты и хук на коммит. CX Codex +1 1 100установок

Из того же набора28

Весь набор →
receipts Скилл receipts для Claude Code показывает карточку личных метрик по сессиям: процент ошибок, объём правок кода и токены на задачу по версиям модели. Отслеживает качество в фоне и помогает заметить, когда оно меняется. CX Codex +1 ★ 586звёзд репо guard-pack Плагин guard-pack для Claude Code запускает семь защитных хуков в одном процессе Node. Первый блокирующий вердикт останавливает цепочку. ★ 586звёзд репо notify-permission Плагин notify-permission пересылает запросы разрешений и ожидания Claude Code в Slack через вебхук, чтобы не сидеть перед терминалом во время долгих задач. ★ 586звёзд репо session-logger Плагин session-logger для Claude Code записывает ход сессии в Markdown-файл. Хуки фиксируют репозиторий, затронутые файлы и команды Bash. ★ 586звёзд репо auto-stage Плагин auto-stage для Claude Code автоматически добавляет изменённые ассистентом файлы в индекс Git, устраняя ручной вызов git add перед коммитом. ★ 586звёзд репо config-watch Плагин config-watch показывает в сессии любое изменение настроек или скиллов, случившееся посреди работы, либо блокирует его. Для случаев, когда установщик или npm-скрипт правит конфиг во время сессии. ★ 586звёзд репо subagent-spawn-cap Плагин subagent-spawn-cap считает спавны субагентов за сессию: спрашивает разрешение на 20-м, потом каждые 10, а на 60-м отказывает. Возвращает лимит, который Claude убрал в 2.1.224. ★ 586звёзд репо config-guard Плагин config-guard для Claude Code блокирует правку агентом файлов с его ограничениями: настроек, скриптов хуков и манифестов плагинов. Чтение разрешено. ★ 586звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой