format-code — плагин для Claude Code: автоформат файлов
Плагин format-code для Claude Code форматирует файл сразу после записи или изменения: ruff для Python, prettier для JS, TS, JSON, MD, YAML и HTML.
MIT ★ 586 обновлён 2026-10-26
/plugin marketplace add karanb192/claude-code-hooks
/plugin install format-code@claude-code-hooksЧто делает 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