كيف تتابع مصروفاتك وتدير ميزانيتك باستخدام Claude Code

Claude Code هو وكيل ذكاء اصطناعي من Anthropic يعمل من داخل الطرفية. يستطيع قراءة الملفات، وكتابة الشيفرة، وتنفيذ الأوامر، وإرسال طلبات HTTP. يستخدمه معظم الناس في تطوير البرمجيات، لكنه مناسب أيضًا للتمويل الشخصي عندما توصله بمتتبّع مصروفات يوفّر واجهة برمجة تطبيقات واضحة ونظيفة للوصول الآلي.

الفكرة كالتالي: تصل Claude Code بمتتبّع مصروفات مفتوح المصدر عبر واجهته البرمجية، فيتحول إلى مساعد مالي شخصي يعيش داخل الطرفية. تضع كشفًا بنكيًا في مجلدك، وتطلب منه تسجيل المعاملات، ومراجعة الأرصدة، وتحديث الميزانية، وكل ذلك عبر محادثة طبيعية. لا حاجة إلى التنقل بين الشاشات ولا إلى إدخال البيانات يدويًا.

لماذا يناسب Claude Code تتبّع المصروفات

يختلف Claude Code عن ChatGPT أو تطبيق Claude على الويب في نقاط مهمة تجعل استخدامه في التمويل الشخصي عمليًا:

يعمل محليًا ويقرأ ملفاتك مباشرة. عندما تنزّل كشفًا بنكيًا بصيغة CSV أو PDF، يستطيع Claude Code قراءته مباشرة من نظام الملفات لديك. لا حاجة إلى رفع الملف أو نسخه ولصقه أو التقاط لقطات شاشة. يكفي أن تقول: "حلّل الكشف البنكي الموجود في ~/Downloads/chase-march-2026.csv"، فيقرأ الملف بنفسه.

ينفّذ الشيفرة ويرسل طلبات HTTP بنفسه. Claude Code لا يكتفي باقتراح أمر curl، بل يشغّله فعلًا. وإذا احتاج إلى إدخال 50 معاملة في قاعدة بيانات المصروفات، فإنه يكتب SQL، ويرسل طلب HTTP، ثم يتأكد من النتيجة. كل ذلك يحدث داخل المحادثة نفسها.

يحتفظ بإعدادك بين جلسة وأخرى. بعد حفظ ApiKey الذي تعيده الخدمة خارج ذاكرة الدردشة، يستطيع Claude Code إعادة استخدام الاتصال نفسه في الجلسات اللاحقة بدل تكرار خطوة رمز التحقق البريدي في كل مرة.

يعالج الملفات محليًا قبل أن يرسل أي شيء إلى الواجهة البرمجية. إذا أردت تنظيف ملف CSV، أو تهيئة كشوف بنكية، أو كتابة سكربت للاستيراد، فيمكنه إنجاز ذلك كله محليًا أولًا قبل أن يتعامل مع الـ API.

إعداد Claude Code للتمويل الشخصي

أنت تحتاج إلى شيئين: متتبّع مصروفات يوفّر واجهة برمجة تطبيقات مناسبة للوكلاء، ومكان تحفظ فيه المفتاح طويل الأمد الذي يحصل عليه Claude Code بعد تسجيل الدخول.

Expense Budget Tracker هو نظام مفتوح المصدر للتمويل الشخصي مبني على Postgres. وعنوان الاكتشاف المعتمد فيه هو GET https://api.expense-budget-tracker.com/v1/. يمكنك إنشاء حساب في النسخة المستضافة أو استضافته ذاتيًا على خادمك.

الخطوة 1: أعطِ Claude Code رابط الاكتشاف

اطلب من Claude Code الاتصال باستخدام:

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

من المفترض أن يبدأ بقراءة استجابة الاكتشاف، ثم يطلب منك:

• بريدك الإلكتروني المرتبط بالحساب
• الرمز المكوّن من 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. وإذا كان حسابك يحتوي على مساحة عمل واحدة فقط، فستُحفَظ تلقائيًا وتُستخدَم من أول مرة.

الخطوة 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": "your query"}
- الاستجابة: {"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 البرمجية
6. إبلاغك بما سجّله بالفعل

بعدها تراجع النتيجة، وتطلب منه تصحيح أي تصنيف خاطئ، وينتهي الأمر. شهر كامل من المعاملات البنكية يمكن إدخاله في بضع دقائق.

والأسلوب نفسه يعمل مع كشوف PDF أو لقطات شاشة تطبيقك البنكي. يستطيع Claude Code قراءة الصور وملفات PDF، واستخراج بيانات المعاملات منها، ثم تسجيل كل شيء بالطريقة نفسها.

مراجعة الأرصدة واكتشاف الأخطاء

بعد استيراد المعاملات، تحقّق دائمًا من أن الأرقام متطابقة:

> تحقّق من أرصدة حساباتي وقارنها بما يظهر لي في البنك:
> يجب أن يكون رصيد chase-checking هو $4,230.15
> ويجب أن يكون رصيد wise-eur هو €1,847.50

سيستعلم Claude Code عن العرض accounts عبر واجهة SQL البرمجية، ويقارن الأرصدة، وينبّهك إلى أي فروق. وإذا ظهر رصيد chase-checking بقيمة 4,180.15 دولارًا بدل 4,230.15 دولارًا، فيمكنه مساعدتك في العثور على الخمسين دولارًا المفقودة: ربما معاملة لم تُستورد، أو معاملة احتُسبت مرتين.

فحص الأرصدة الأسبوعي هذا من أهم العادات في التمويل الشخصي. وKirill Markin، الذي أنشأ Expense Budget Tracker ويصنّف كل معاملة شخصية منذ أكثر من خمس سنوات، يجري هذا الفحص كل أسبوع بلا انقطاع. وهذا ما يحافظ على موثوقية البيانات مع مرور الوقت.

اطرح أسئلة عن إنفاقك

بمجرد أن تصبح بيانات المصروفات موجودة في قاعدة البيانات، يمكن لـ Claude Code الإجابة عن أي سؤال مالي عبر كتابة استعلامات SQL:

> كم أنفقت على dining-out خلال آخر 3 أشهر؟

> ما أكبر 5 فئات مصروفات لدي هذا الشهر؟

> اعرض لي جميع المعاملات التي تتجاوز $100 من الأسبوع الماضي.

> ما متوسط إنفاقي الشهري على groceries خلال آخر 6 أشهر؟

سيكتب Claude Code الاستعلام، ويشغّله عبر الـ API، ثم يقدّم لك الإجابة بلغة واضحة. لا تحتاج إلى معرفة SQL بنفسك، لكن يمكنك دائمًا أن تطلب منه عرض الاستعلام الذي نفّذه، أو التحقق من صحته، أو تعديله.

إدارة توقّعات ميزانيتك

تتبّع المصروفات يعني تسجيل ما حدث فعلًا. أما إعداد الميزانية فيعني التخطيط لما سيأتي بعد ذلك. وكلاهما موجود في قاعدة البيانات نفسها.

يخزّن جدول budget_lines توقّعك الشهري: الدخل المتوقع والمصروفات المخطط لها لكل فئة ولكل شهر. ويمكنك إدارة ذلك عبر Claude Code:

> اضبط ميزانيتي لشهر أبريل 2026:
> - groceries: $400
> - dining-out: $200
> - rent: $2,100
> - salary income: $8,500
> انسخ بقية البنود من ميزانية مارس.

سيقرأ Claude Code بنود ميزانية مارس، وينشئ بنود أبريل مع تعديلاتك، ثم يكتبها عبر واجهة SQL البرمجية. وهكذا تحصل على توقّع متدحرج لمدة 12 شهرًا يمكنك استعراضه لاحقًا في واجهة الويب.

ومن الروتين الجيد شهريًا أن تفتح Claude Code في نهاية كل شهر وتقول له شيئًا مثل:

> قارن إنفاقي الفعلي هذا الشهر بالميزانية.
> وإذا وجدت أي فئة تجاوز إنفاقها الميزانية بأكثر من 20%،
> فعدّل توقّع الشهر القادم ليكون أكثر واقعية.

سيقرأ Claude Code القيم الفعلية من ledger_entries، ويقارنها بالخطة الموجودة في budget_lines، ثم يحدّث التوقّع. وهذا النوع من التحليل قد يستغرق 30 دقيقة يدويًا، بينما ينجزه Claude Code في نحو دقيقتين.

العمل بعدة عملات

إذا كانت لديك حسابات بعملات مختلفة، فسيتعامل Claude Code مع ذلك بشكل طبيعي. فمتتبّع المصروفات يخزّن كل معاملة بعملتها الأصلية، ويجلب أسعار الصرف يوميًا من ECB وCBR وNBS.

> استلمت أمس دفعة 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

تكشف الواجهة البرمجية المخصصة للوكلاء في 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 البرمجية:

كل استعلام يمر عبر Postgres Row Level Security. ويرتبط مفتاح الـ API بمستخدمك، ويُنفّذ SQL فقط على مساحة العمل المختارة. وهذا يعني أن Claude Code لا يستطيع رؤية سوى بياناتك، حتى لو كانت قاعدة البيانات مشتركة.

ويُسمح بتعليمة واحدة فقط في كل طلب. وأنواع التعليمات المدعومة هي SELECT وWITH وINSERT وUPDATE وDELETE. لا يستطيع Claude Code إنشاء الجداول أو حذفها، ولا استخدام أغلفة المعاملات، ولا استدعاء set_config()، ولا إرسال تعليقات SQL أو المعرّفات المقتبسة. وتفرض واجهة SQL هذه القيود من جهة الخادم مهما حاول Claude Code إرسال شيء آخر.

تُخزَّن مفاتيح الـ API على هيئة تجزئات SHA-256، ولا تُحفَظ قيمها النصية الصريحة داخل قاعدة البيانات. ويمكنك إلغاء المفاتيح لاحقًا من داخل المنتج. كما أن حدود المعدل تقيد الاستخدام عند 10 طلبات في الثانية و10,000 طلب يوميًا، مع مهلة قدرها 30 ثانية وحد أقصى 100 صف في كل استجابة.

يبقى مفتاح الـ API في متغير البيئة المحلي لديك. ويقرأه Claude Code من $EXPENSE_BUDGET_TRACKER_API_KEY عند إرسال الطلبات، ولا يحتاج أبدًا إلى حفظه داخل مشروعك.