Як відстежувати витрати й керувати бюджетом за допомогою Claude Code
Claude Code — це AI-агент Anthropic, який працює у вашому терміналі. Він уміє читати файли, писати код, виконувати команди й робити HTTP-запити. Більшість людей використовують Claude Code для розробки програмного забезпечення. Але він також дуже добре працює для особистих фінансів, якщо підключити його до трекера витрат із чистим machine API.
Суть налаштування така: ви підключаєте Claude Code до трекера витрат з відкритим кодом через його machine API, і він стає вашим фінансовим асистентом у терміналі. Кидаєте банківську виписку, просите Claude Code записати транзакції, перевірити баланси, оновити бюджет — усе через звичайну розмову. Без проклікування екранів інтерфейсу і без ручного введення даних.
Чому Claude Code добре підходить для трекінгу витрат
Claude Code відрізняється від ChatGPT або вебзастосунку Claude кількома важливими речами, які реально мають значення для особистих фінансів:
Він працює локально і може читати ваші файли. Коли ви завантажуєте банківську виписку у CSV чи PDF, Claude Code може прочитати її прямо з файлової системи. Без завантажень у хмару, без копіпасту, без скриншотів. Ви кажете: "розбери виписку з ~/Downloads/chase-march-2026.csv", і Claude Code читає файл.
Він може виконувати код і HTTP-запити. Claude Code не просто радить curl-команду, він її запускає. Якщо треба вставити 50 транзакцій у вашу базу витрат, він пише SQL, надсилає HTTP-запит і підтверджує результат. Увесь процес відбувається в межах однієї розмови.
Він пам’ятає ваше налаштування між сесіями. Коли отриманий ApiKey збережено поза пам’яттю чату, Claude Code може використовувати те саме підключення і в наступних сесіях, не проходячи email-код кожного разу заново.
Він працює з локальними файлами офлайн. Якщо вам треба попередньо обробити банківські виписки, почистити формат CSV чи написати import-скрипти, Claude Code зробить це локально ще до того, як щось торкнеться API.
Налаштування Claude Code для особистих фінансів
Вам потрібні дві речі: трекер витрат із machine API і місце, де зберегти довгоживучий ключ, який Claude Code отримує після входу.
Expense Budget Tracker — це система для особистих фінансів з відкритим кодом на базі Postgres. Її canonical discovery endpoint: GET https://api.expense-budget-tracker.com/v1/. Зареєструйтесь у хостинговій версії або розгорніть варіант для самостійного хостингу на власному сервері.
Крок 1: Дайте Claude Code discovery URL
Скажіть Claude Code підключитися через:
https://api.expense-budget-tracker.com/v1/
Claude Code має спочатку прочитати discovery response, а потім попросити:
- email вашого акаунта
- 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 особливо сильний. Завантажте банківську виписку й попросіть його її обробити:
> I downloaded my Chase statement to ~/Downloads/chase-march-2026.csv.
> Parse it and record all transactions to my chase-checking account.
Claude Code:
- Прочитає CSV-файл із вашої файлової системи
- Розбере кожен рядок — дату, суму, опис
- Підбере кожній транзакції одну з ваших категорій витрат (з
CLAUDE.md) - Збере
INSERT-запити для таблиціledger_entries - Надішле кожен через SQL API
- Розповість, що саме записав
Ви переглядаєте результат, просите Claude Code виправити помилково категоризовані транзакції — і все. Цілий місяць банківських рухів оброблено за кілька хвилин.
Для PDF-виписок чи скриншотів із банківського застосунку працює той самий підхід. Claude Code може читати зображення і PDF, витягувати звідти дані транзакцій і записувати все тим самим способом.
Перевірка балансів і пошук помилок
Після імпорту транзакцій завжди перевіряйте, що цифри сходяться:
> Check my account balances and compare them to what I see in the bank:
> chase-checking should be $4,230.15
> wise-eur should be €1,847.50
Claude Code робить запит до view accounts через SQL API, порівнює баланси й підсвічує розбіжності. Якщо в chase-checking вийшло 4,180.15 долара замість 4,230.15, Claude Code допоможе знайти відсутні 50 доларів — можливо, транзакцію пропустили або продублювали.
Ця щотижнева перевірка балансів — одна з найважливіших звичок в особистих фінансах. Кирило Маркін, який побудував Expense Budget Tracker і категоризує кожну особисту транзакцію вже понад п’ять років, робить цю перевірку щотижня без пропусків. Саме вона довго тримає дані надійними.
Запитання про ваші витрати
Коли дані про витрати вже в базі, Claude Code може відповісти на будь-яке питання про ваші фінанси, просто написавши SQL-запит:
> How much did I spend on dining out in the last 3 months?
> What are my top 5 expense categories this month?
> Show me all transactions over $100 from last week.
> What's my average monthly grocery spending over the past 6 months?
Claude Code напише SQL, виконає його через API й поверне відповідь звичайною мовою. Вам не обов’язково знати SQL, але ви завжди можете попросити його показати сам запит, перевірити, чи він має сенс, або підкрутити його.
Керування прогнозом бюджету
Трекінг витрат — це запис того, що вже сталося. Бюджетування — це планування того, що буде далі. І те, й інше живе в одній базі.
Таблиця budget_lines зберігає ваш місячний прогноз — очікувані доходи й заплановані витрати по категоріях для кожного місяця. Керувати цим через Claude Code можна так:
> Set my budget for April 2026:
> - groceries: $400
> - dining-out: $200
> - rent: $2,100
> - salary income: $8,500
> Copy everything else from March's budget.
Claude Code прочитає бюджетні рядки за березень, створить рядки за квітень із вашими змінами й запише їх через SQL API. У підсумку ви матимете rolling forecast на 12 місяців, який можна гортати у веб-інтерфейсі.
Хороша місячна рутина наприкінці кожного місяця може виглядати так:
> Compare my actual spending this month against the budget.
> For any category where I spent more than 20% over budget,
> adjust next month's forecast to be more realistic.
Claude Code читає actuals із ledger_entries, порівнює їх із планом у budget_lines і оновлює прогноз. Це той тип аналізу, який вручну забирає 30 хвилин, а з Claude Code — 2 хвилини.
Робота з кількома валютами
Якщо у вас є рахунки в різних валютах, Claude Code обробляє це природно. Трекер витрат зберігає кожну транзакцію в її початковій валюті й щодня отримує курси з ECB, CBR та NBS.
> I received €2,500 freelance payment into wise-eur yesterday.
> Record it as income, 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
Machine API Expense Budget Tracker відкриває невеликий набір relation'ів, із якими AI-агентам легко працювати. Дозволений набір публікується через GET /v1/schema.
| Table | Що в ній зберігається |
|---|---|
| ledger_entries | Усі транзакції доходів і витрат |
| budget_lines | План бюджету — суми по категоріях на кожен місяць |
| budget_comments | Нотатки до конкретних клітинок бюджету |
| exchange_rates | Щоденні FX-курси (підтягуються автоматично) |
| workspace_settings | Налаштування валюти звітності |
| account_metadata | Класифікація ліквідності рахунків |
| accounts | VIEW — поточні баланси по рахунках |
У ledger_entries чіткі колонки: event_id, ts, account_id, amount, currency, kind, category, counterparty, note. Claude Code може писати коректні INSERT-запити з першої спроби, бо назви колонок прямо описують, що всередині.
Безпека і контроль доступу
Давати Claude Code доступ до вашої expense-бази безпечно в межах обмежень SQL API:
Кожен запит проходить через Postgres Row Level Security. API-ключ прив’язаний до вашого користувача, а SQL виконується лише в обраному робочому просторі, тому Claude Code бачить лише ваші дані навіть у спільній базі.
На один запит дозволений лише один statement. Підтримуються SELECT, WITH, INSERT, UPDATE і DELETE. Claude Code не може створювати чи видаляти таблиці, не може використовувати transaction wrappers, не може викликати set_config() і не може надсилати SQL-коментарі чи quoted identifiers. SQL API жорстко обмежує це на сервері незалежно від того, що саме намагався відправити Claude Code.
API-ключі зберігаються як SHA-256-хеші — plaintext ніколи не лежить у базі. Ключі можна відкликати в самому продукті. Rate limit обмежує використання до 10 запитів на секунду і 10 000 на день, таймаут на statement — 30 секунд, а у відповіді не більше 100 рядків.
Сам API-ключ лишається у вашій локальній змінній середовища. Claude Code читає його з $EXPENSE_BUDGET_TRACKER_API_KEY під час запитів і не має жодної потреби комітити його в проєкт.
Просунутий варіант: прямий HTTP без agent-native логіну
Якщо у вас уже є довгоживучий ApiKey від Expense Budget Tracker, Claude Code може пропустити email OTP-підтвердження і просто використовувати наявний ключ. У цьому режимі викликаються ті самі endpoints:
GET /v1/openapi.jsonдля опублікованої machine-readable-специфікаціїGET /v1/schemaдля дозволених relation'івPOST /v1/sqlдля самих запитів
Це зручно для стабільних скриптів і попередньо налаштованих середовищ, але для більшості людей discovery URL плюс OTP-підтвердження — це найпростіше налаштування.
Реальний сценарій: щотижневий облік витрат за 10 хвилин
Кирило Маркін працює саме так уже багато років, і вся рутина зводиться до щотижневої сесії приблизно такого вигляду:
- Завантажити банківські виписки з усіх рахунків (2 хвилини)
- Відкрити Claude Code і попросити його обробити файли (3 хвилини — Claude Code працює, ви дивитеся)
- Переглянути, що Claude Code записав, і виправити хибні категорії (3 хвилини)
- Попросити Claude Code перевірити, що всі баланси рахунків збігаються з банком (1 хвилина)
- Якщо кінець місяця, попросити Claude Code порівняти actuals із бюджетом і оновити прогноз (2 хвилини)
Разом це 10 хвилин, щоб отримати повну картину фінансів — кожна транзакція категоризована, кожен баланс перевірений, бюджет оновлений. Система працює, бо нудні частини (парсинг, категоризація, вставка, підрахунки) — саме те, що Claude Code робить добре, а частини, де потрібне судження (перегляд категорій, рішення про зміну бюджету), лишаються за вами.
Як почати з Claude Code і Expense Budget Tracker
- Встановіть Claude Code, якщо ще не зробили цього
- Зареєструйтесь на expense-budget-tracker.com або розгорніть версію для самостійного хостингу застосунку
- Передайте Claude Code
https://api.expense-budget-tracker.com/v1/ - Пройдіть email OTP-підтвердження й збережіть отриманий ключ як
EXPENSE_BUDGET_TRACKER_API_KEY - Збережіть типовий робочий простір для цього ключа
- Додайте локальний
CLAUDE.mdзі своїми категоріями, рахунками й правилами роботи - Відкрийте Claude Code у своїй фінансовій директорії й киньте туди першу банківську виписку
Claude Code сам подивиться на схему, зіставить ваші категорії й почне записувати транзакції. Перегляньте результат, виправте все, що виглядає підозріло, — і у вас запущений AI-сценарій для обліку витрат прямо з термінала.
Трекер витрат має ліцензію MIT і повністю відкритий код на github.com/kirill-markin/expense-budget-tracker. Claude Code доступний на docs.anthropic.com/en/docs/claude-code. Обидва інструменти можна безкоштовно спробувати на старті.