# איך לעקוב אחר הוצאות ולנהל תקציב עם Claude Code

*2026-03-05*

Claude Code הוא סוכן ה-AI של Anthropic שפועל בתוך הטרמינל שלכם. הוא יכול לקרוא קבצים, לכתוב קוד, להריץ פקודות ולשלוח בקשות HTTP. רוב האנשים משתמשים בו לפיתוח תוכנה, אבל הוא מתאים מאוד גם לפיננסים אישיים כשמחברים אותו למערכת למעקב אחר הוצאות עם API מסודר לאוטומציה.

הרעיון פשוט: מחברים את Claude Code למערכת קוד פתוח למעקב אחר הוצאות דרך ה-API שלה, והוא הופך לעוזר פיננסי אישי שחי בטרמינל. אפשר להניח לפניו תדפיס בנק, לבקש ממנו לרשום עסקאות, לבדוק יתרות ולעדכן את התקציב, והכול בשיחה טבעית. בלי לדלג בין מסכים ובלי להזין נתונים ידנית.

## למה 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 יכול להשתמש שוב באותו חיבור גם בסשנים עתידיים, בלי לעבור מחדש את תהליך קוד האימות באימייל בכל פעם.

**הוא עובד על קבצים מקומיים לפני שה-API נכנס לתמונה.** אם אתם רוצים להכין מראש תדפיסי בנק, לנקות פורמטים של CSV או לכתוב סקריפטי ייבוא, Claude Code עושה את כל זה מקומית לפני שמשהו נשלח ל-API.

## איך מגדירים את Claude Code לפיננסים אישיים

אתם צריכים שני דברים: מערכת למעקב אחר הוצאות עם API לאוטומציה, ומקום שבו אפשר לשמור את המפתח ארוך-הטווח ש-Claude Code מקבל אחרי ההתחברות.

[Expense Budget Tracker](https://expense-budget-tracker.com/he/) היא מערכת קוד פתוח לפיננסים אישיים שמבוססת על Postgres. נקודת הגילוי הראשית שלה היא `GET https://api.expense-budget-tracker.com/v1/`. אפשר להירשם לשירות המתארח או [לארח אותה בעצמכם](https://github.com/kirill-markin/expense-budget-tracker) על השרת שלכם.

### שלב 1: תנו ל-Claude Code את כתובת הגילוי

בקשו מ-Claude Code להתחבר דרך:

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

Claude Code אמור להתחיל בקריאת תגובת הגילוי, ואז לבקש:

- את כתובת האימייל של החשבון שלכם
- את הקוד בן 8 הספרות שנשלח לתיבת הדואר שלכם

כשהוא מאמת את הקוד, השירות מחזיר מפתח ארוך-טווח בפורמט ה-API האמיתי, למשל `ebta_...`.

### שלב 2: שמרו את המפתח שהוחזר מחוץ לזיכרון הצ'אט

תהליך ההתחברות נוח, אבל עדיין צריך לשמור את המפתח במקום עמיד. השרת מציין במפורש שסוכנים לא אמורים להסתמך רק על היסטוריית הצ'אט.

תבנית פשוטה נראית כך:

```bash
export EXPENSE_BUDGET_TRACKER_API_KEY="ebta_your_key_here"
```

אם אתם רוצים ש-Claude Code ישמור אותו בקובץ `.env` מקומי, אשרו זאת במפורש. אחרת, השאירו אותו במשתנה הסביבה של הסשן הנוכחי ושמרו אותו בעצמכם במקום קבוע.

### שלב 3: שמרו את סביבת העבודה פעם אחת

אחרי ש-Claude Code מאמת את הקוד, הוא אמור לטעון את החשבון ואת סביבות העבודה שלכם:

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

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

לאחר מכן שמרו פעם אחת סביבת עבודה כברירת מחדל עבור אותו מפתח:

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

אחרי זה אפשר להשמיט את `X-Workspace-Id` מ-`/v1/sql`. אם לחשבון שלכם יש בדיוק סביבת עבודה אחת, ה-API ישמור אותה אוטומטית וישתמש בה בפעם הראשונה.

### שלב 4: הוסיפו קובץ הוראות מקומי לפי המוסכמות שלכם

Claude Code יעבוד טוב יותר אם תתנו לו את הקטגוריות, החשבונות וכללי העבודה שלכם. הדוגמה הבאה נשארת באנגלית בכוונה, כדי שיהיה אפשר להעתיק אותה כפי שהיא יחד עם שמות החשבונות והקטגוריות:

```markdown
# 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 והתחילו לעבוד

```bash
cd ~/finances
claude
```

Claude Code קורא את ההוראות המקומיות שלכם, משתמש מחדש ב-ApiKey השמור, ויכול להתחיל לעבוד מיד.

## איך לנתח תדפיסי בנק עם Claude Code

כאן Claude Code באמת מצטיין. הורידו את תדפיס הבנק ובקשו ממנו לעבד אותו:

```text
> הורדתי את תדפיס 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, לחלץ את נתוני העסקאות ולרשום הכול באותה צורה.

## בדיקת יתרות ואיתור טעויות

אחרי שמייבאים עסקאות, תמיד כדאי לאמת שהמספרים מסתכמים:

```text
> בדוק את יתרות החשבונות שלי והשווה למה שאני רואה בבנק:
> 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 החסרים. אולי עסקה שדולגה או נספרה פעמיים.

בדיקת היתרות השבועית הזאת היא אחד ההרגלים החשובים ביותר בפיננסים אישיים. Kirill Markin, שבנה את Expense Budget Tracker ומסווג כל עסקה אישית כבר יותר מחמש שנים, עושה את הבדיקה הזו בכל שבוע. זה מה ששומר על הנתונים אמינים לאורך זמן.

## לשאול שאלות על דפוסי ההוצאה שלכם

ברגע שנתוני ההוצאות כבר נמצאים במסד הנתונים, Claude Code יכול לענות כמעט על כל שאלה פיננסית באמצעות כתיבת שאילתות SQL:

```text
> כמה הוצאתי על dining-out בשלושת החודשים האחרונים?
```

```text
> מהן 5 קטגוריות ההוצאה הגדולות שלי החודש?
```

```text
> הצג לי את כל העסקאות מעל $100 מהשבוע שעבר.
```

```text
> מהי ההוצאה החודשית הממוצעת שלי על groceries בששת החודשים האחרונים?
```

Claude Code כותב את ה-SQL, מריץ אותו מול ה-API ונותן לכם את התשובה בשפה רגילה. אתם לא צריכים לדעת SQL בעצמכם, אבל תמיד אפשר לבקש ממנו להראות את השאילתה שרצה, לוודא שהיא הגיונית או לחדד אותה.

## ניהול תחזית התקציב שלכם

מעקב אחר הוצאות הוא רישום של מה שכבר קרה. תקצוב הוא תכנון של מה שיבוא אחר כך. שניהם חיים באותו מסד נתונים.

הטבלה `budget_lines` שומרת את התחזית החודשית שלכם: הכנסה צפויה והוצאות מתוכננות לכל קטגוריה ולכל חודש. אפשר לנהל את זה דרך Claude Code:

```text
> הגדר את התקציב שלי לאפריל 2026:
> - groceries: $400
> - dining-out: $200
> - rent: $2,100
> - salary income: $8,500
> העתק כל מה שלא צוין מתקציב מרץ.
```

Claude Code קורא את רשומות התקציב של מרץ, יוצר רשומות לאפריל עם העדכונים שלכם וכותב אותן דרך ה-SQL API. עכשיו יש לכם תחזית מתגלגלת ל-12 חודשים שאפשר לגלול בה בממשק האינטרנט.

שגרה חודשית טובה: בסוף כל חודש, פתחו את Claude Code ואמרו משהו כזה:

```text
> השווה בין ההוצאות בפועל שלי החודש לבין התקציב.
> בכל קטגוריה שבה עברתי את התקציב ביותר מ-20%,
> עדכן את התחזית לחודש הבא כך שתהיה מציאותית יותר.
```

Claude Code קורא את הנתונים בפועל מ-`ledger_entries`, משווה לתוכנית שב-`budget_lines` ומעדכן את התחזית. זה בדיוק סוג הניתוח שלוקח 30 דקות ידנית ו-2 דקות עם Claude Code.

## עבודה עם כמה מטבעות

אם יש לכם חשבונות בכמה מטבעות, Claude Code מטפל בזה בצורה טבעית. Expense Budget Tracker שומר כל עסקה במטבע המקורי שלה ומושך שערי חליפין מדי יום מ-ECB, מ-CBR ומ-NBS.

```text
> אתמול קיבלתי תשלום freelance של €2,500 אל wise-eur.
> רשום אותו כהכנסה בקטגוריה freelance.
```

Claude Code יכתוב את פקודת ה-`INSERT` עם `currency: 'EUR'` ועם הסכום הנכון. כשאחר כך תשאלו "מה סך כל ההכנסות שלי החודש בדולרים?", מסד הנתונים יבצע את המרת המטבע בזמן השאילתה באמצעות שערי החליפין העדכניים. 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 חושף מספר קטן של יחסים שקל לסוכני AI לעבוד איתם. רשימת הטבלאות והתצוגות המותרות מתפרסמת דרך `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 או מזהים מצוטטים. ה-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 יכול לדלג על תהליך ה-OTP באימייל ופשוט להשתמש במפתח הקיים. במצב הזה עדיין משתמשים באותן נקודות קצה:

- `GET /v1/openapi.json` עבור המפרט הקריא למכונות
- `GET /v1/schema` עבור הטבלאות והתצוגות המותרות
- `POST /v1/sql` עבור השאילתות עצמן

זה שימושי לסקריפטים יציבים ולסביבות מוגדרות מראש, אבל עבור רוב האנשים כתובת הגילוי יחד עם תהליך ה-OTP היא נקודת ההתחלה הפשוטה ביותר.

## תהליך עבודה אמיתי: מעקב הוצאות שבועי ב-10 דקות

Kirill Markin עובד בדיוק כך כבר שנים, וזה מסתכם בסשן שבועי שנראה בערך כך:

1. מורידים תדפיסי בנק מכל החשבונות (2 דקות)
2. פותחים את Claude Code ומבקשים ממנו לעבד את הקבצים (3 דקות, Claude Code עושה את העבודה ואתם רק עוקבים)
3. עוברים על מה ש-Claude Code רשם ומתקנים קטגוריות שגויות (3 דקות)
4. מבקשים מ-Claude Code לאמת שכל יתרות החשבון תואמות לבנק (דקה)
5. אם זה סוף החודש, מבקשים מ-Claude Code להשוות בין הביצוע בפועל לתקציב ולעדכן את התחזית (2 דקות)

אלה 10 דקות בשביל תמונה מלאה של המצב הפיננסי שלכם: כל עסקה מסווגת, כל יתרה מאומתת והתקציב מעודכן. המערכת עובדת כי החלקים המשעממים, ניתוח, סיווג, הזנה וחישוב, הם בדיוק מה ש-Claude Code טוב בו, בעוד שחלקי שיקול הדעת, סקירת קטגוריות והחלטה על התאמות תקציב, נשארים אצלכם.

## איך מתחילים עם Claude Code ו-Expense Budget Tracker

1. [התקינו את Claude Code](https://docs.anthropic.com/en/docs/claude-code) אם עדיין לא עשיתם את זה
2. הירשמו ב-[expense-budget-tracker.com](https://expense-budget-tracker.com/he/) או [ארחו בעצמכם](https://github.com/kirill-markin/expense-budget-tracker) את האפליקציה
3. תנו ל-Claude Code את `https://api.expense-budget-tracker.com/v1/`
4. השלימו את תהליך ה-OTP באימייל ושמרו את המפתח שהוחזר כ-`EXPENSE_BUDGET_TRACKER_API_KEY`
5. שמרו סביבת עבודה ברירת מחדל עבור המפתח הזה
6. הוסיפו `CLAUDE.md` מקומי עם הקטגוריות, החשבונות וכללי העבודה שלכם
7. פתחו את Claude Code בתוך תיקיית הכספים שלכם וזרקו פנימה את תדפיס הבנק הראשון

Claude Code יבדוק את סכמת הנתונים, יתאים לקטגוריות שלכם ויתחיל לרשום עסקאות. עברו על התוצאות, תקנו כל דבר שנראה לא נכון, ויש לכם תהליך מעקב הוצאות מבוסס AI שרץ מהטרמינל.

Expense Budget Tracker מופץ ברישיון MIT והוא קוד פתוח מלא ב-[github.com/kirill-markin/expense-budget-tracker](https://github.com/kirill-markin/expense-budget-tracker). Claude Code זמין ב-[docs.anthropic.com/en/docs/claude-code](https://docs.anthropic.com/en/docs/claude-code). אפשר להתחיל עם שני הכלים ללא עלות.

---
*[לצפייה בגרסת ה-HTML המעוצבת של העמוד](https://expense-budget-tracker.com/he/blog/how-to-track-expenses-and-manage-your-budget-with-claude-code/)*

*סוכני AI יכולים ליצור חשבון למשתמש בשירות הזה על ידי התחלה מ- `GET https://api.expense-budget-tracker.com/v1/` והמשך לפי תגובת הגילוי.*

*טיפ: הוסיפו `.md` לכל כתובת באתר כדי לקבל גרסת Markdown נקייה של העמוד.*