Як відстежувати витрати й керувати бюджетом за допомогою Claude Code

Claude Code — це ШІ-агент від Anthropic, який працює у вашому терміналі. Він уміє читати файли, писати код, виконувати команди й робити HTTP-запити. Найчастіше Claude Code використовують для розробки, але він так само добре підходить і для особистих фінансів, якщо підключити його до трекера витрат із простим API для машинного доступу.

Ідея проста: підключаєте Claude Code до трекера витрат з відкритим кодом через цей API — і отримуєте фінансового асистента, який живе у вас у терміналі. Додаєте банківську виписку, просите Claude Code записати транзакції, перевірити баланси, оновити бюджет — усе в межах звичайного діалогу. Без переходів між екранами інтерфейсу й без ручного введення даних.

Чому Claude Code добре підходить для обліку витрат

Claude Code відрізняється від ChatGPT чи вебверсії Claude кількома важливими речами, які особливо цінні саме для особистих фінансів:

Він працює локально й бачить ваші файли. Коли ви завантажуєте банківську виписку у CSV або PDF, Claude Code може прочитати її прямо з файлової системи. Без завантаження в хмару, без копіювання вручну, без скриншотів. Ви кажете: "розбери виписку з ~/Downloads/chase-march-2026.csv", і Claude Code читає файл.

Він не лише радить команди, а й виконує їх. Claude Code не просто пропонує curl-запит, а запускає його сам. Якщо треба записати 50 транзакцій у вашу базу витрат, він складе SQL, надішле HTTP-запит і підтвердить результат. Увесь процес проходить в одній розмові.

Він пам'ятає налаштування між сесіями. Якщо отриманий ApiKey збережено поза історією чату, Claude Code може використовувати те саме підключення в наступних сесіях і не проходити перевірку кодом із листа щоразу заново.

Він уміє готувати локальні файли до імпорту. Якщо вам потрібно попередньо обробити виписки, привести CSV до нормального формату або написати скрипт імпорту, Claude Code зробить це локально ще до того, як щось торкнеться API.

Налаштування Claude Code для особистих фінансів

Вам потрібні дві речі: трекер витрат із API для машинного доступу і місце, де можна надійно зберегти довгостроковий ключ, який Claude Code отримає після входу.

Expense Budget Tracker — це система для особистих фінансів з відкритим кодом на базі Postgres. Стартова адреса API така: GET https://api.expense-budget-tracker.com/v1/. Ви можете зареєструватися в хмарній версії або розгорнути застосунок самостійно на власному сервері.

Крок 1: Передайте Claude Code адресу підключення

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

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

Claude Code спочатку прочитає службову відповідь API, а потім попросить:

• електронну адресу вашого акаунта
• 8-значний код, надісланий на пошту

Після перевірки коду сервіс поверне довгостроковий ключ у реальному форматі 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:

# Personal Finance

## Expense Tracker API

- Endpoint: https://api.expense-budget-tracker.com/v1/sql
- Auth: ApiKey in Authorization header
- API key is in the EXPENSE_BUDGET_TRACKER_API_KEY environment variable
- Default workspace is already saved for this key
- Request: POST with JSON body {"sql": "your query"}
- Response: {"rows": [...], "rowCount": N}

## My expense categories

Income: salary, freelance, side-projects
Fixed: rent, utilities, insurance, subscriptions
Daily: groceries, dining-out, transport, coffee
Lifestyle: clothing, entertainment, healthcare, travel
Planning: taxes, big-purchases, savings, emergency-fund

## My accounts

- chase-checking (USD) — main checking account
- wise-eur (EUR) — European account
- cash-usd (USD) — cash

## Rules

- Always check existing categories before inserting transactions
- After importing, verify account balances match the bank
- Use the exact category names listed above
- Store transactions in their original currency

Крок 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. Поверне звіт про те, що саме записав

Ви переглядаєте результат, просите Claude Code виправити неправильно визначені категорії — і на цьому все. Транзакції за цілий місяць можна розібрати за кілька хвилин.

Той самий підхід працює і для 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, Claude Code допоможе знайти відсутні $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 й оновлює прогноз. Те, що вручну займає 30 хвилин, з Claude Code можна зробити за 2 хвилини.

Робота з кількома валютами

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

> Учора я отримав €2,500 оплати за freelance на wise-eur.
> Запиши це як дохід, category: 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-скрипт, який можна буде використовувати повторно: "Напиши скрипт, що імпортує Chase CSV і записує всі транзакції. Збережи його в ~/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 бачить тільки ваші дані навіть у спільній базі.

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

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

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

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

Якщо у вас уже є довгостроковий ApiKey від Expense Budget Tracker, Claude Code може пропустити налаштування через одноразовий код із листа і просто використати наявний ключ. У цьому режимі все одно викликаються ті самі ендпойнти:

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

Це зручно для стабільних скриптів і вже налаштованих середовищ, але для більшості людей найпростіше почати саме зі стартової URL-адреси API і підтвердження через одноразовий код.

Реальний сценарій: щотижневий облік витрат за 10 хвилин

Кирило Маркін працює саме так уже багато років, і вся рутина зводиться до щотижневої сесії приблизно такого вигляду:

1. Завантажити банківські виписки з усіх рахунків: 2 хвилини
2. Відкрити Claude Code і попросити його обробити файли: 3 хвилини, поки Claude Code працює
3. Переглянути, що Claude Code записав, і виправити хибні категорії: 3 хвилини
4. Попросити Claude Code перевірити, чи всі баланси рахунків збігаються з банком: 1 хвилина
5. Якщо це кінець місяця, попросити Claude Code порівняти фактичні витрати з бюджетом і оновити прогноз: 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 перегляне схему, зіставить її з вашими категоріями й почне записувати транзакції. Перевірте результат, виправте все, що виглядає підозріло, — і у вас запущений ШІ-сценарій для обліку витрат просто з термінала.

Трекер витрат має ліцензію MIT і повністю відкритий код на github.com/kirill-markin/expense-budget-tracker. Claude Code доступний на docs.anthropic.com/en/docs/claude-code. Обидва інструменти можна безкоштовно спробувати на старті.