claude-code-cache-fix CLI
Локальный прокси между Claude Code и Anthropic: чинит сбои промпт-кэша, стабилизирует префикс запроса и показывает расход квоты в строке состояния
- 448 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Прокси стоит на пути всех запросов к API Anthropic и может читать и переписывать их и ответы, в том числе ваши промпты и код
- Режим forward-proxy расшифровывает TLS для `api.anthropic.com` через локальный CA, которому должен доверять клиент
- Прокси слушает порт на машине, а запуск службой оставляет его работающим постоянно
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/claude-code-cache-fixОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Прокси стоит на пути всех запросов к API Anthropic и может читать и переписывать их и ответы, в том числе ваши промпты и код
- Режим forward-proxy расшифровывает TLS для `api.anthropic.com` через локальный CA, которому должен доверять клиент
- Прокси слушает порт на машине, а запуск службой оставляет его работающим постоянно
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
claude-code-cache-fix ставится как npm-пакет и поднимает на вашей машине HTTP-прокси, который стоит между Claude Code и API Anthropic. Прокси перехватывает запросы `POST /v1/messages` и приводит их к виду, при котором промпт-кэш не ломается: убирает нестабильный отпечаток версии из системного промпта, задает детерминированный порядок определений инструментов и MCP, расставляет метки `cache_control` с нужным TTL и нормализует идентификаторы в сообщениях. Если чинить нечего, запрос уходит без изменений. Кроме кэша, цепочка расширений выполняет и другие задачи. Расширение `thinking-block-sanitize` по умолчанию убирает пустые блоки размышлений, которые вызывают ошибку 400 при возобновлении сессии. `auto-1m-guard` замечает, что Claude Code сам включил контекст на миллион токенов, и по настройке предупреждает или вырезает эту отметку. `bootstrap-defense` ведет журнал серверных вставок в промпт Claude Code и может их блокировать. Отдельно доступен необязательный потолок расходов на сессию. Телеметрия кэша пишется в `~/.claude/quota-status/`, а строка состояния показывает квоту за 5 часов и 7 дней, уровень TTL и долю попаданий в кэш. Запуск: пакет из npm, прокси на порту 9801 и `ANTHROPIC_BASE_URL=http://127.0.0.1:9801 claude`. Для версий Claude Code до 2.1.112 есть режим preload без прокси.
Для кого. Для тех, кто работает с Claude Code по подписке или с оплатой за токены, видит скачки расхода при возобновлении длинных сессий и готов поставить локальный прокси.
Подходит, если
- После `--resume` в длинной сессии счетчик `cache_creation_input_tokens` постоянно подскакивает, а доля чтения из кэша низкая
- Квота на пять часов тратится быстрее, чем должна, и нужно видеть TTL и долю попаданий в строке состояния
- Сессия возобновляется с ошибкой 400 из-за блоков размышлений
- Нужен жесткий потолок расходов на сессию против разбегающихся субагентов
- Вы хотите видеть, какие серверные вставки Claude Code подмешивает в промпт: расширение `bootstrap-defense` ведет их журнал
Не подходит, если
- Кэш у вас и так держится на высоком уровне: автор прямо называет это поводом не ставить прокси
- Вы редко возобновляете длинные сессии и не упираетесь в квоту
- Не хотите ставить локальный прокси на путь запросов к API: он может читать и переписывать `POST /v1/messages`
- Нужны `/remote-control`, `/schedule` и коннекторы claude.ai в обычном режиме с `ANTHROPIC_BASE_URL`: для них есть режим forward-proxy, который требует доверять локальному CA
Пример запроса к агенту
Поставь claude-code-cache-fix, запусти прокси на порту 9801 и проверь по логам, выросла ли доля чтения из кэша после возобновления сессииОграничения
Нужны Node.js 18 или новее и Claude Code. Прокси слушает `127.0.0.1:9801`. API Anthropic из России недоступен, поэтому без собственного маршрута к нему проверка не пройдет.
- Прокси видит и может менять запросы и ответы API. Автор подчеркивает, что исправление кэша невозможно без этого.
- Режим forward-proxy (`--remote-control`) расшифровывает TLS только для `api.anthropic.com` с помощью локально созданного CA, клиент должен ему доверять. Остальной трафик идет напрямую.
- Две необязательные функции делают собственные исходящие запросы: обновление OAuth и ускорение загрузок. Обе выключены по умолчанию.
- Версия 4.0.0 включила `thinking-block-sanitize` по умолчанию, горячая перезагрузка расширений теперь необязательна.
- Лицензия MIT.
Как отключить. Остановите процесс прокси, уберите `ANTHROPIC_BASE_URL` (или `HTTPS_PROXY` и `NODE_EXTRA_CA_CERTS` для режима forward-proxy) и удалите пакет командой `npm rm -g claude-code-cache-fix`. Каталог `~/.claude/cache-fix-ca/` с локальным CA можно стереть вручную.
Частые вопросы
Как понять, нужен ли мне claude-code-cache-fix?
Посчитайте долю чтения из кэша по транскриптам сессий в `~/.claude/projects/`: команда `jq` есть в README. Если на длинной сессии она стабильно высокая, прокси не нужен. Низкая доля и всплески `cache_creation_input_tokens` при `--resume` означают, что он пригодится.
Как запустить Claude Code через прокси?
Выполните `npm install -g claude-code-cache-fix`, запустите `node "$(npm root -g)/claude-code-cache-fix/proxy/server.mjs" &`, затем `ANTHROPIC_BASE_URL=http://127.0.0.1:9801 claude`. Обертки и `NODE_OPTIONS` не нужны.
Что делать, чтобы работали Remote Control и коннекторы claude.ai?
Начиная с Claude Code 2.1.196 нестандартный `ANTHROPIC_BASE_URL` отключает `/remote-control`, `/schedule` и коннекторы claude.ai. Запустите `cache-fix-proxy --remote-control`: режим forward-proxy оставляет адрес API прежним.
Не отправляет ли прокси мои данные наружу?
На обычном пути он делает только запросы к Anthropic, которые все равно шли бы от Claude Code, а телеметрия пишется в локальные файлы в `~/.claude/`. Исключения выключены по умолчанию: обновление OAuth и ускорение загрузок.
Что дает расширение session-budget-breaker?
Необязательный жесткий потолок на сессию: когда накопленные токены, оценка стоимости или скорость расхода превышают заданный лимит, прокси обрывает запросы этой сессии локально, не доводя их до API.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыClaude Usage
claude-usage
Локальная панель по логам Claude Code: токены, модели, сессии и проекты. Подписчикам Pro и Max показывает полную картину вместо шкалы
Показывает, что на самом деле уходит в API у Claude Code и Codex: перехватывает локальный трафик и раскладывает токены и деньги по источникам
Claude Code Tools
claude-code-tools
Набор практичных инструментов для Claude Code, Codex CLI и похожих агентов: утилиты, скиллы, агенты, хуки и плагины для работы в терминале
GitHub Action, который запускает Claude Code в pull requests и issues: отвечает на упоминания, делает ревью и вносит правки
Continuous Claude
continuous-claude
Claude Code в непрерывном цикле: итерация, pull request, ожидание проверок и слияние. Остановка по нескольким сигналам завершения. Нужны jq и gh
Token Optimizer
token-optimizer
Плагин для Claude Code и Codex: режет лишние токены, сохраняет работу между сессиями и сжатиями, показывает стоимость. Лицензия некоммерческая
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| claude-code-cache-fix (эта запись) | нет | 448 | ||
| RTK | нет | 84 886 | сжимает вывод команд git и тестов, чтобы агент тратил меньше токенов на чтение терминала | |
| Context Mode | нет | не нужна | 32 711 | MCP-сервер, который держит крупный вывод инструментов вне контекста и хранит память сессии |
| TokenTracker | нет | 2 149 | считает токены и расходы по локальным логам и показывает панель, запросы не меняет |
Коротко о README
Страница начинается с честного описания, что прокси делает с трафиком, и с разбора, нужен ли он вам. Дальше идет способ измерить кэш без установки, список актуальных предупреждений и быстрый старт в режимах reverse-proxy и forward-proxy. Основная часть описывает цепочку расширений с таблицей, работу службой и в Docker, настройку, переход с версии 3.x, защиту от конкретных регрессий, строку состояния с квотой и режим preload для старых версий Claude Code.