Как вести учет расходов и управлять бюджетом с помощью Claude Code

Claude Code - это ИИ-агент Anthropic, который работает прямо в терминале. Он умеет читать файлы, писать код, выполнять команды и отправлять HTTP-запросы. Чаще всего его используют для разработки, но и для личных финансов он подходит отлично, если подключить его к трекеру расходов с понятным API для автоматизированного доступа.

Идея простая: вы подключаете Claude Code к трекеру расходов с открытым исходным кодом через API для автоматизированного доступа, и он становится вашим финансовым помощником в терминале. Достаточно положить рядом банковскую выписку, попросить занести транзакции, сверить остатки по счетам или обновить бюджет, и все это в обычном диалоге. Без ручного ввода и бесконечных переходов по интерфейсу.

Почему Claude Code хорошо подходит для учета расходов

Claude Code отличается от ChatGPT и веб-приложения Claude в нескольких важных аспектах, которые особенно полезны для личных финансов.

Он работает локально и читает файлы с диска. Если вы скачали банковскую выписку в CSV или PDF, Claude Code может открыть ее прямо из файловой системы. Ничего не нужно загружать в чат, копировать вручную или делать скриншоты. Достаточно сказать: "разбери выписку в ~/Downloads/chase-march-2026.csv", и агент сам прочитает файл.

Он не только подсказывает команды, но и выполняет их. Claude Code не ограничивается примером curl. Если нужно записать 50 транзакций в базу, он сам составит SQL, отправит HTTP-запросы и проверит результат. Весь сценарий укладывается в один разговор.

Он сохраняет рабочие настройки между сессиями. Если хранить полученный ApiKey вне истории чата, Claude Code сможет использовать одно и то же подключение в следующих сессиях и не проходить заново вход по коду из письма.

Он умеет готовить данные локально до обращения к API. Если выписку нужно привести к нормальному виду, почистить CSV или написать небольшой импорт-скрипт, Claude Code сделает это на вашей машине еще до отправки данных в API.

Как настроить Claude Code для личных финансов

Нужны две вещи: трекер расходов с API для автоматизированного доступа и место, где будет храниться долгоживущий ключ, который Claude Code получает после входа.

Expense Budget Tracker - это система личных финансов с открытым исходным кодом на базе Postgres. Канонический URL обнаружения API: GET https://api.expense-budget-tracker.com/v1/. Можно зарегистрироваться в облачной версии или развернуть систему самостоятельно на своем сервере.

Шаг 1. Передайте Claude Code URL обнаружения API

Скажите Claude Code подключаться по адресу:

https://api.expense-budget-tracker.com/v1/

Сначала Claude Code должен прочитать ответ по этому URL, а затем запросить:

• адрес электронной почты вашего аккаунта
• восьмизначный код, который придет на почту

После проверки кода сервис вернет долгоживущий ключ в обычном API-формате, например ebta_....

Шаг 2. Сохраните ключ вне памяти чата

Сама процедура входа удобная, но ключ все равно нужно сохранить в постоянном месте. Бэкенд прямо предупреждает агентов, что нельзя полагаться только на историю диалога.

Простейший вариант:

export EXPENSE_BUDGET_TRACKER_API_KEY="ebta_your_key_here"

Если хотите, чтобы Claude Code сохранил ключ в локальный .env, подтвердите это явно. Если нет, держите его только в оболочке текущей сессии и сохраните его постоянным способом самостоятельно.

Шаг 3. Один раз сохраните рабочее пространство

После проверки кода Claude Code должен загрузить ваш аккаунт и список рабочих пространств:

curl https://api.expense-budget-tracker.com/v1/me \
  -H "Authorization: ApiKey $EXPENSE_BUDGET_TRACKER_API_KEY"

curl https://api.expense-budget-tracker.com/v1/workspaces \
  -H "Authorization: ApiKey $EXPENSE_BUDGET_TRACKER_API_KEY"

Затем нужно один раз сохранить рабочее пространство по умолчанию для этого ключа:

curl -X POST https://api.expense-budget-tracker.com/v1/workspaces/workspace-id/select \
  -H "Authorization: ApiKey $EXPENSE_BUDGET_TRACKER_API_KEY"

После этого для /v1/sql уже не нужен X-Workspace-Id. Если у аккаунта только одно рабочее пространство, API само сохранит его и начнет использовать при первом обращении.

Шаг 4. Добавьте локальный файл инструкций со своими правилами

Claude Code работает заметно лучше, если заранее описать ему свои категории, счета и правила работы. Для этого удобно завести локальный файл CLAUDE.md:

# Личные финансы

## API трекера расходов

- Точка доступа: https://api.expense-budget-tracker.com/v1/sql
- Авторизация: ApiKey в заголовке Authorization
- API-ключ хранится в переменной окружения EXPENSE_BUDGET_TRACKER_API_KEY
- Рабочее пространство по умолчанию уже сохранено для этого ключа
- Запрос: POST с JSON-телом {"sql": "ваш запрос"}
- Ответ: {"rows": [...], "rowCount": N}

## Мои категории расходов

Доходы: salary, freelance, side-projects
Постоянные расходы: rent, utilities, insurance, subscriptions
Повседневные расходы: groceries, dining-out, transport, coffee
Образ жизни: clothing, entertainment, healthcare, travel
Планирование: taxes, big-purchases, savings, emergency-fund

## Мои счета

- chase-checking (USD) - основной расчетный счет
- wise-eur (EUR) - европейский счет
- cash-usd (USD) - наличные

## Правила

- Всегда проверяй существующие категории перед вставкой транзакций
- После импорта сверяй остатки по счетам с данными банка
- Используй точные названия категорий из списка выше
- Храни транзакции в исходной валюте

Шаг 5. Откройте Claude Code и начинайте работу

cd ~/finances
claude

Claude Code прочитает локальные инструкции, повторно использует сохраненный ApiKey и сможет сразу приступить к работе.

Как разбирать банковские выписки с помощью Claude Code

Здесь Claude Code особенно полезен. Скачайте банковскую выписку и попросите его обработать:

> Я скачал выписку Chase в ~/Downloads/chase-march-2026.csv.
> Разбери ее и запиши все транзакции в мой счет chase-checking.

Claude Code:

1. прочитает CSV-файл с диска
2. разберет каждую строку: дату, сумму и описание
3. сопоставит каждую транзакцию с одной из категорий из файла CLAUDE.md
4. подготовит INSERT-запросы для таблицы ledger_entries
5. отправит их через SQL API
6. сообщит, что именно записал

Дальше вы просто просматриваете результат и, если нужно, просите исправить неверно назначенные категории. Месячная выписка превращается в аккуратно занесенные данные за считаные минуты.

Тот же подход работает и для PDF-выписок или скриншотов банковского приложения. Claude Code умеет читать изображения и PDF, извлекать из них данные о транзакциях и записывать их тем же способом.

Как сверять балансы и находить ошибки

После импорта транзакций всегда стоит проверить, что цифры сходятся:

> Проверь остатки по моим счетам и сравни их с тем, что я вижу в банке:
> chase-checking должно быть $4,230.15
> wise-eur должно быть €1,847.50

Claude Code запросит представление accounts через SQL API, сравнит остатки и покажет расхождения. Если по chase-checking получилось $4,180.15 вместо $4,230.15, агент поможет найти недостающие $50: возможно, одна транзакция не импортировалась или, наоборот, была учтена дважды.

Еженедельная сверка балансов - одна из самых полезных привычек в личных финансах. Кирилл Маркин, создатель Expense Budget Tracker, который уже больше пяти лет категоризирует все свои личные транзакции, делает такую проверку каждую неделю. Именно она помогает со временем сохранять данные точными и надежными.

Какие вопросы о расходах можно задавать

Когда данные уже лежат в базе, Claude Code может отвечать почти на любые вопросы о ваших финансах, просто составляя SQL-запросы:

> Сколько я потратил на рестораны за последние 3 месяца?

> Какие 5 категорий расходов были самыми большими в этом месяце?

> Покажи все транзакции больше $100 за прошлую неделю.

> Какой у меня средний месячный расход на продукты за последние 6 месяцев?

Claude Code сам напишет SQL, выполнит его через API и объяснит результат обычным языком. Самому знать SQL не обязательно, но при желании можно попросить показать запрос, убедиться, что он корректен, и при необходимости уточнить формулировку.

Как управлять прогнозом бюджета

Учет расходов фиксирует то, что уже произошло. Бюджетирование помогает планировать то, что будет дальше. И то и другое хранится в одной базе данных.

Таблица budget_lines содержит помесячный прогноз: ожидаемые доходы и плановые расходы по категориям на каждый месяц. Этим прогнозом тоже можно управлять через Claude Code:

> Установи мой бюджет на апрель 2026:
> - groceries: $400
> - dining-out: $200
> - rent: $2,100
> - salary income: $8,500
> Все остальное скопируй из мартовского бюджета.

Claude Code прочитает мартовские строки бюджета, создаст записи на апрель с вашими изменениями и отправит их через SQL API. В результате у вас будет прогноз на 12 месяцев вперед, который можно просматривать в веб-интерфейсе.

Удобная ежемесячная рутина может выглядеть так:

> Сравни мои фактические расходы за этот месяц с бюджетом.
> Для каждой категории, где я вышел больше чем на 20%,
> скорректируй прогноз на следующий месяц так, чтобы он был реалистичнее.

Claude Code прочитает фактические данные из ledger_entries, сравнит их с планом в budget_lines и обновит прогноз. Вручную на такой анализ легко уходит полчаса, а с Claude Code все занимает пару минут.

Работа с несколькими валютами

Если у вас есть счета в разных валютах, Claude Code нормально работает и с этим. Трекер расходов хранит каждую транзакцию в исходной валюте и ежедневно подтягивает курсы из ECB, CBR и NBS.

> Вчера я получил €2,500 за фриланс на wise-eur.
> Запиши это как доход в категории freelance.

Claude Code сформирует INSERT с currency: 'EUR' и правильной суммой. А когда позже вы спросите, какой у вас общий доход за месяц в USD, база сама выполнит конвертацию по актуальным курсам на момент запроса. Claude Code останется только вернуть результат.

Что Claude Code умеет такого, чего не умеет веб-интерфейс

Сила Claude Code в личных финансах - в сочетании доступа к файлам, HTTP-запросов и обычного диалога в одном инструменте.

Пакетная обработка. Можно сложить в одну папку пять банковских выписок из разных счетов и попросить Claude Code обработать их все. Он прочитает каждый файл, разнесет транзакции по нужным счетам и в конце сверит остатки. В веб-интерфейсе на это ушел бы час однообразных действий.

Нестандартный анализ. "В какие месяцы за последний год у меня были самые большие траты на развлечения и какие там были крупнейшие транзакции?" У большинства приложений для бюджета нет готовой кнопки под такой вопрос. Claude Code сам напишет SQL, выполнит его и разберет результат.

Преобразование форматов. Банк выгружает странный CSV со склеенными колонками и европейским форматом дат? Попросите Claude Code сначала привести файл в нормальный вид. Он перепишет его локально, а потом импортирует уже чистую версию.

Скрипты на будущее. Можно попросить Claude Code один раз написать Python-скрипт для повторного использования: "Напиши скрипт, который импортирует CSV из Chase и записывает все транзакции. Сохрани его в ~/finances/import-chase.py." В следующий раз вы просто запускаете готовый скрипт напрямую, с Claude Code или без него.

С какой схемой базы работает Claude Code

API для автоматизированного доступа в Expense Budget Tracker открывает небольшой набор таблиц и представлений, с которыми ИИ-агенту удобно работать. Список разрешенных объектов публикуется через GET /v1/schema.

Таблица	Что хранит
ledger_entries	Все доходные и расходные транзакции
budget_lines	План бюджета: суммы по категориям и месяцам
budget_comments	Комментарии к отдельным ячейкам бюджета
exchange_rates	Ежедневные курсы валют, которые подгружаются автоматически
workspace_settings	Настройки отчетной валюты
account_metadata	Классификация ликвидности счетов
accounts	VIEW с текущими остатками по счетам

У таблицы ledger_entries понятные поля: event_id, ts, account_id, amount, currency, kind, category, counterparty, note. Благодаря таким названиям Claude Code обычно может составить корректный INSERT с первой попытки.

Безопасность и контроль доступа

Давать Claude Code доступ к базе расходов безопасно в рамках ограничений SQL API.

Каждый запрос проходит через механизм Postgres Row Level Security. API-ключ привязан к конкретному пользователю, а SQL выполняется только в выбранном рабочем пространстве, поэтому Claude Code видит только ваши данные даже в общей базе.

В одном запросе разрешено только одно выражение. Поддерживаются только SELECT, WITH, INSERT, UPDATE и DELETE. Claude Code не может создавать или удалять таблицы, не может оборачивать запросы в транзакции, не может вызывать set_config() и не может отправлять SQL-комментарии или идентификаторы в кавычках. Все эти ограничения принудительно проверяются на стороне сервера, независимо от того, что агент попытается отправить.

API-ключи хранятся как SHA-256-хэши, ключ в открытом виде никогда не хранится в базе. Ключ можно позже отозвать из продукта. Лимиты использования такие: 10 запросов в секунду, 10 000 запросов в день, таймаут 30 секунд и максимум 100 строк в одном ответе.

Сам API-ключ остается в вашей локальной переменной окружения. Claude Code читает его из $EXPENSE_BUDGET_TRACKER_API_KEY, когда делает запросы. Добавлять его в коммит не нужно.

Продвинутый вариант: прямой HTTP без встроенного входа агента

Если у вас уже есть долгоживущий ApiKey Expense Budget Tracker, Claude Code может пропустить вход по коду из письма и сразу использовать существующий ключ. В этом режиме он обращается к тем же API-эндпоинтам:

• GET /v1/openapi.json - опубликованная машиночитаемая спецификация
• GET /v1/schema - список разрешенных таблиц и представлений
• POST /v1/sql - сами SQL-запросы

Такой вариант удобен для постоянных скриптов и заранее подготовленных окружений, но для большинства пользователей связка из URL обнаружения API и входа по одноразовому коду остается самым простым способом настройки.

Реальный сценарий: еженедельный учет расходов за 10 минут

Кирилл Маркин пользуется именно таким процессом уже много лет. В типичную еженедельную сессию обычно входят такие шаги:

1. Скачать выписки по всем счетам из банка, 2 минуты
2. Открыть Claude Code и попросить обработать файлы, 3 минуты
3. Просмотреть, что Claude Code записал, и поправить ошибочные категории, 3 минуты
4. Попросить Claude Code сверить остатки по счетам с банком, 1 минута
5. Если месяц закончился, попросить сравнить факт с бюджетом и обновить прогноз, 2 минуты

Итого примерно 10 минут на полную картину личных финансов: все транзакции занесены, остатки сверены, бюджет обновлен. Это работает потому, что рутинные части процесса, такие как разбор, категоризация, запись и пересчет, Claude Code делает хорошо, а решения, где нужен человеческий контекст, остаются за вами.

С чего начать с Claude Code и Expense Budget Tracker

1. Установите Claude Code, если он у вас еще не установлен
2. Зарегистрируйтесь на expense-budget-tracker.com или разверните приложение самостоятельно
3. Передайте Claude Code адрес https://api.expense-budget-tracker.com/v1/
4. Пройдите вход по коду из письма и сохраните полученный ключ как EXPENSE_BUDGET_TRACKER_API_KEY
5. Сохраните рабочее пространство по умолчанию для этого ключа
6. Добавьте локальный CLAUDE.md со своими категориями, счетами и правилами работы
7. Откройте Claude Code в каталоге с финансами и передайте ему первую банковскую выписку

Claude Code посмотрит схему, сопоставит ваши категории и начнет заносить транзакции. Дальше останется просмотреть результат, поправить то, что выглядит сомнительно, и пользоваться готовой связкой ИИ-агента и трекера расходов прямо из терминала.

Expense Budget Tracker распространяется по лицензии MIT и полностью открыт на github.com/kirill-markin/expense-budget-tracker. Claude Code доступен на docs.anthropic.com/en/docs/claude-code. Оба инструмента можно начать использовать бесплатно.