البدء

إذا كنت تستخدم macOS مع معالج Apple Silicon، تخطَّ هذه الصفحة واستخدم المثبّت بأمر واحد:

curl -fsSL https://f5-sales-demo.github.io/devcontainer/scripts/install.sh | bash

يتولى التعامل مع حزم Homebrew وإعدادات iTerm2 وتهيئة Podman ويحمّل كل ما تحتاجه.

المتطلبات الأساسية

بيئة تشغيل الحاويات

تحتاج إلى بيئة تشغيل حاويات على جهازك. يعمل كل من Docker أو Podman.

Docker
Podman

المنصة	التثبيت
macOS	Docker Desktop لنظام Mac
Windows	Docker Desktop لنظام Windows (واجهة WSL2 الخلفية)
Linux	Docker Engine أو Docker Desktop لنظام Linux

تحقق من أنه يعمل:

docker --version
docker compose version

المنصة	التثبيت
macOS	Podman Desktop لنظام Mac
Windows	Podman Desktop لنظام Windows
Linux	Podman + Podman Compose

تحقق من أنه يعمل:

podman --version
podman-compose version

يشغّل Podman على Linux الحاويات مباشرة (بدون آلة افتراضية). تأكد من أن مقبس Podman نشط حتى يتمكن podman-compose من الاتصال:

systemctl --user enable --now podman.socket

موارد النظام

المورد	الحد الأدنى	الموصى به
القرص	5 جيجابايت	10 جيجابايت أو أكثر
الذاكرة	8 جيجابايت مخصصة لبيئة تشغيل الحاويات	12 جيجابايت أو أكثر
المعالج	نواتان	4 أنوية أو أكثر

Docker
Podman

اضبط حدود الموارد في Docker Desktop → Settings → Resources.

على macOS/Windows، اضبط حدود الموارد في Podman Desktop → Settings → Resources، أو عبر سطر الأوامر:

podman machine set --cpus 4 --memory 12288
podman machine stop && podman machine start

على Linux، تشارك الحاويات موارد المضيف مباشرة — لا حاجة لتهيئة الموارد.

1. الإعداد

أنشئ مجلداً وحمّل ملف compose:

mkdir devcontainer && cd devcontainer
curl -fsSLO https://raw.githubusercontent.com/f5-sales-demo/devcontainer/main/docker-compose.yml

2. إضافة بيانات المصادقة (اختياري)

أنشئ ملف .env في نفس المجلد لتهيئة Claude Code مسبقاً. اختر أحد الخيارات التالية:

الخيار أ: Claude Max (OAuth)

CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-your-token-here

الخيار ب: LiteLLM أو وكيل متوافق مع Anthropic

إذا كان لديك مثيل LiteLLM أو وكيل آخر متوافق مع Anthropic، عيّن هذين المتغيرين:

LITELLM_BASE_URL=https://your-litellm-endpoint.example.com
LITELLM_API_KEY=your-api-key

عيّن النطاق فقط — تستنتج الحاوية لواحق URL الخاصة بالمزود تلقائياً (مثل /anthropic لـ Claude Code).

الملء التلقائي من بيانات الاعتماد المحلية

إذا كان git و gh مُهيأين على جهازك المضيف، يمكنك ملء معظم قيم .env تلقائياً. ابدأ بنسخ القالب:

cp .env.example .env

ثم شغّل الأوامر التي تتوافق مع إعداداتك:

# Git identity
echo "GIT_AUTHOR_EMAIL=$(git config user.email)" >> .env
echo "GIT_AUTHOR_NAME=\"$(git config user.name)\"" >> .env

# Timezone
echo "TZ=$(readlink /etc/localtime | sed 's|.*/zoneinfo/||')" >> .env

# GitHub CLI token (requires: gh auth login)
echo "GH_TOKEN=$(gh auth token)" >> .env

# SSH key (if you use SSH for git)
echo "SSH_PRIVATE_KEY=$(base64 < ~/.ssh/id_ed25519)" >> .env

ثم حرّر .env لإضافة رمز OAuth أو إعدادات وكيل LiteLLM (انظر الخيارات أعلاه).

docker compose up -d

podman-compose pull && podman-compose up -d

يسحب التشغيل الأول الصورة المبنية مسبقاً من ghcr.io (حوالي دقيقة واحدة حسب سرعة اتصالك). تستخدم عمليات التشغيل اللاحقة الصورة المخزنة مؤقتاً وتستغرق ثوانٍ.

4. الاتصال

Docker
Podman

docker compose exec dev zsh

podman-compose exec dev zsh

5. التحقق

# AI tools
claude --version
codex --version
pi --version

# Languages
node --version
python3 --version
go version

# Cloud CLIs
aws --version
az --version
terraform --version

اختبر اتصال الذكاء الاصطناعي:

claude -p "Say hello"

6. مشروعك الأول

cd /workspace
git clone https://github.com/your-org/your-project.git
cd your-project
claude

7. العرض عن بُعد (noVNC)

تتضمن الحاوية شاشة افتراضية لمشاهدة وكلاء الذكاء الاصطناعي وهم يتحكمون في المتصفح. افتح http://localhost:6080/vnc.html للاتصال. انظر العرض عن بُعد (noVNC) للتفاصيل.

8. أتمتة المتصفح (Chrome DevTools MCP)

يمكن لـ Claude Code التنقل في صفحات الويب والتقاط لقطات شاشة وفحص DOM باستخدام خادم Chrome DevTools MCP المدمج. لا حاجة لأي إعداد — يعمل تلقائياً في الوضع بدون واجهة. انظر Chrome DevTools MCP للتفاصيل.

9. الإيقاف وإعادة التشغيل

Docker
Podman

# إيقاف (يحافظ على البيانات)
docker compose down

# التشغيل مرة أخرى
docker compose up -d

# حذف كل شيء والبدء من جديد
docker compose down -v
docker compose up -d

# إيقاف (يحافظ على البيانات)
podman-compose down

# التشغيل مرة أخرى (السحب يضمن أحدث صورة)
podman-compose pull && podman-compose up -d

# حذف كل شيء والبدء من جديد
podman-compose down -v
podman-compose pull && podman-compose up -d

تبقى الشيفرة البرمجية في /workspace والمجلد الرئيسي محفوظة عبر عمليات إعادة التشغيل. انظر التهيئة — استمرارية البيانات للتفاصيل.

للبناء المحلي وتخصيص Dockerfile، انظر التطوير المحلي. لدمج VS Code، انظر VS Code. لخيارات العرض عن بُعد، انظر العرض عن بُعد (noVNC).