Claude Code: الاستخدام الأول لـ Claude Code
آخر تحديث: 2026-08-31
استخدامك الأول لـ Claude Code يشبه توظيف مساعد قوي — تحتاج لمعرفة كيف تعطي التعليمات وتؤكد العمليات وتصحح المسار.
💡 نصيحة: في الاستخدام الأول، تمرّن على مشروع بسيط. Claude Code يعدّل الملفات؛ رغم إمكانية التراجع عن التغييرات، بناء عادات آمنة أمر مهم.
📋 المتطلبات المسبقة: الفصل 3 - إعداد API واختيار النموذج
1. ما ستتعلمه
- إطلاق Claude Code في مشروع
- طرق إعطاء تعليمات المهام
- تأكيد العمليات والموافقة على الصلاحيات
- عرض التغييرات والتراجع عنها
- أفضل الممارسات للاستخدام الأول
2. إطلاق جلستك الأولى
(1) التحضير
BASH
# 1. Create a practice project
mkdir my-first-claude && cd my-first-claude
git init
# 2. Create a simple file
echo 'function hello() { return "Hello"; }' > index.js
# 3. Launch Claude Code
claude
(2) الواجهة التفاعلية
TEXT
📖 للعرض فقط
╭─────────────────────────────────────────╮
│ Claude Code │
│ Model: claude-sonnet-4-20250514 │
│ Project: my-first-claude │
╰─────────────────────────────────────────╯
> █ (type your instruction)
▶ مثال 1: المحادثة الأولى
TEXT
📖 للعرض فقط
> Hello, please look at this project
Claude: Let me check the project structure and file contents...
📁 Project structure:
- index.js
📄 index.js:
```javascript
function hello() { return "Hello"; }
This is a simple JavaScript project with just one hello دالة.
Add a goodbye دالة and unit tests
Claude: I'll add a goodbye دالة and test file.
→ Reading index.js → Modifying index.js (adding goodbye دالة) → Creating index.test.js → Running: npm test ✅ 2 tests passed
Done:
- Added goodbye() دالة in index.js
- Created index.test.js with 2 test cases
- All tests passing
---
## 3. آلية تأكيد العمليات
### (1) سير الموافقة على الصلاحيات
يطلب Claude Code تأكيداً للعمليات الحساسة:
| نوع العملية | السلوك الافتراضي | مثال |
|:----------|:--------------|:----|
| **قراءة ملف** | تنفيذ تلقائي | قراءة index.js |
| **إنشاء ملف** | طلب تأكيد | إنشاء ملف جديد test.js |
| **تعديل ملف** | طلب تأكيد | تعديل ملف موجود |
| **تشغيل أمر** | طلب تأكيد | تنفيذ npm test |
| **حذف ملف** | طلب تأكيد | حذف ملف قديم |
### (2) خيارات التأكيد
```text
Claude wants to edit index.js:
- Add goodbye() function after hello()
- Add module.exports
Allow? (y/n/a/e)
y = yes (this time)
n = no
a = always allow edits to this file
e = edit the change before applying
▶ مثال 2: التعامل مع تأكيدات الصلاحيات
TEXT
📖 للعرض فقط
> Refactor project to TypeScript
Claude: I'll perform the following:
1. Create tsconfig.json
2. Convert index.js to index.ts
3. Add type definitions
4. Update package.json
Allow creating tsconfig.json? [y/n/a/e] y
✅ Created tsconfig.json
Allow editing index.js → index.ts? [y/n/a/e] a
✅ Always allowing edits to index.ts
Allow running: npm install typescript --save-dev? [y/n/a/e] y
✅ Installed typescript
All changes applied successfully!
4. عرض التغييرات والتراجع عنها
(1) عرض التغييرات
BASH
# View current session file changes
claude /diff
# View git diff
git diff
# View specific file changes
git diff index.js
(2) التراجع عن العمليات
BASH
# Revert all changes (git-based)
git checkout .
git clean -fd
# Revert single file
git checkout -- index.js
# View change history
git log --oneline -5
▶ مثال 3: التراجع عن عمليات خاطئة
TEXT
📖 للعرض فقط
> Rename all functions
Claude: Renaming functions...
→ hello → greet
→ goodbye → farewell
→ Modified 3 files
# Alice finds the rename doesn't match expectations
# Use git to revert
$ git diff --stat
index.js | 6 +++---
index.test.js | 8 ++++----
utils.js | 4 ++--
$ git checkout .
# All changes reverted ✓
5. أفضل الممارسات للاستخدام الأول
(1) قائمة عادات الأمان
| العادة | السبب | الممارسة |
|---|---|---|
| git init أولاً | تراجع سهل | أدِر كل مشروع بـ git |
| التزامات صغيرة | تقليل خسارة التراجع | التزم بعد كل ميزة |
| قراءة التأكيدات | تجنب الأخطاء | لا تضغط y بلا تفكير |
| استخدام /diff | فهم التغييرات | تحقق بعد العمليات الكبيرة |
| تجنب الإنتاج | تقليل المخاطر | تمرّن على مشاريع اختبار أولاً |
(2) نصائح وصف المهام
TEXT
📖 للعرض فقط
# Bad description
> Help me change some code
# Good description
> In src/auth/jwt.ts, add token refresh logic,
> set expiry to 7 days, write corresponding unit tests
# Better description (with constraints)
> Refactor UserService query methods:
> 1. Use Repository pattern instead of direct SQL
> 2. Add pagination support (default 20 per page)
> 3. Write integration tests
> 4. Don't modify the interface signatures
6. مثال شامل: تجربة أولى كاملة
BASH
# Alice's first Claude Code experience
# 1. Prepare project
mkdir todo-app && cd todo-app
git init
npm init -y
# 2. Launch Claude Code
claude "Create a simple Node.js TODO app:
1. Support add, delete, list tasks
2. Store data in JSON file
3. Include complete unit tests
4. Use ES Module syntax"
# Claude Code work process:
# → Reading package.json
# → Creating src/todo.js (core TODO logic)
# → Creating src/storage.js (JSON file storage)
# → Creating src/index.js (CLI entry)
# → Creating tests/todo.test.js (unit tests)
# → Running: npm test → 8/8 passed ✓
# → Creating README.md
# 3. Check results
git add -A && git commit -m "feat: initial todo app by Claude Code"
# 4. Add more requirements
claude "Add task priority feature (high/medium/low), update tests"
# Claude Code continues iterating...
❓ أسئلة شائعة
س الإطلاق الأول بطيء، ماذا أفعل؟
ج الإطلاق الأول يحمل سياق المشروع؛ المشاريع الكبيرة قد تستغرق 10-30 ثانية. التفاعلات اللاحقة أسرع.
س ضغطت تأكيداً خاطئاً، ماذا الآن؟
ج استخدم
git checkout . فوراً للتراجع، أو أخبر Claude Code "تراجع عن التغيير الأخير".س Claude Code أفسد أكوادي، ماذا أفعل؟
ج هذا الغرض من git.
git diff لرؤية التغييرات، git checkout . للتراجع. استخدم دائماً تحت إدارة git.س كل تأكيد مزعج، هل يمكن أن يكون تلقائياً؟
ج نعم. اختر
a (السماح دائماً) لملفات محددة، أو اضبط سياسات الصلاحيات في CLAUDE.md.س هل يمكنني التراجع عن تغييرات جلسة كاملة؟
ج نعم. إذا كان لديك التزام git قبل الجلسة،
git reset --soft HEAD~1 يتراجع إلى حالة ما قبل الجلسة.س كيف أجعل Claude Code أكثر طاعة؟
ج كُن محدداً في التعليمات. اذكر بوضوح ما يجب فعله وما لا يجب فعله والقيود. التعليمات الغامضة تؤدي لنتائج غامضة.
📖 ملخص
- شغّل
claudeفي دليل المشروع للبدء؛ يُوصى بإدارة المشروع بـ git - تعديلات الملفات وتنفيذ الأوامر تحتاج تأكيداً؛ اختر
aللموافقة التلقائية - استخدم
/diffوgit diffلعرض التغييرات،git checkout .للتراجع - أوصاف المهام يجب أن تكون محددة: ماذا + قيود + النتيجة المتوقعة
- تمرّن على مشاريع بسيطة أولاً، ابنِ عادات آمنة
📝 تمارين
- أساسي (⭐): أنشئ مشروعاً فارغاً، استخدم Claude Code لتوليد تطبيق Hello World، أكّد أنه يعمل.
- متوسط (⭐⭐): اجعل Claude Code يضيف ميزة، ثم استخدم
/diffلعرض التغييرات، تراجع يدوياً عن تعديل ملف واحد. - متقدم (⭐⭐⭐): أعطِ Claude Code تعليمة غامضة وأخرى دقيقة، قارن فروق النتائج، لخّص أفضل ممارسات وصف المهام.