Claude Code: الاستخدام الأول لـ Claude Code

آخر تحديث: 2026-08-31

استخدامك الأول لـ Claude Code يشبه توظيف مساعد قوي — تحتاج لمعرفة كيف تعطي التعليمات وتؤكد العمليات وتصحح المسار.

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

📋 المتطلبات المسبقة: الفصل 3 - إعداد API واختيار النموذج

1. ما ستتعلمه


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:


---

## 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 أكثر طاعة؟
ج كُن محدداً في التعليمات. اذكر بوضوح ما يجب فعله وما لا يجب فعله والقيود. التعليمات الغامضة تؤدي لنتائج غامضة.

📖 ملخص


📝 تمارين

  1. أساسي (⭐): أنشئ مشروعاً فارغاً، استخدم Claude Code لتوليد تطبيق Hello World، أكّد أنه يعمل.
  2. متوسط (⭐⭐): اجعل Claude Code يضيف ميزة، ثم استخدم /diff لعرض التغييرات، تراجع يدوياً عن تعديل ملف واحد.
  3. متقدم (⭐⭐⭐): أعطِ Claude Code تعليمة غامضة وأخرى دقيقة، قارن فروق النتائج، لخّص أفضل ممارسات وصف المهام.
Web-Tutorial.com

فريق Web-Tutorial التقني

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

100%