Claude Code: متغيرات البيئة وتهيئة التطوير

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

متغيرات البيئة هي "لوحة التحكم" لـ Claude Code — مفاتيح API، واختيار النموذج، وتفضيلات الإخراج، كلها تُتحكم عبر متغيرات البيئة.

💡 نصيحة: متغيرات البيئة لها الأولوية القصوى، متجاوزة CLAUDE.md و settings.json. الأفضل للتهيئة الديناميكية (مفتاح API، اختيار النموذج).

📋 المتطلبات السابقة: الفصل 21 - تطبيق عملي: إضافة Chrome والمهام المتوازية

1. ما ستتعلمه


2. شرح متغيرات البيئة

(1) المتغيرات الأساسية

المتغير مطلوب الوصف مثال
ANTHROPIC_API_KEY مفتاح API sk-ant-api03-xxx
ANTHROPIC_BASE_URL عنوان URL للـ API https://api.deepseek.com
CLAUDE_MODEL النموذج الافتراضي claude-sonnet-4-20250514

(2) متغيرات التحكم بالسلوك

المتغير الوصف الافتراضي
CLAUDE_STYLE نمط الإخراج default
CLAUDE_LANGUAGE لغة الإخراج en
CLAUDE_AUTO_TEST اختبار تلقائي بعد التعديل false
CLAUDE_AUTO_COMMIT التزام تلقائي بالتغييرات false
CLAUDE_MAX_TURNS الحد الأقصى لدورات التكرار 50
CLAUDE_TIMEOUT مهلة العملية (بالثواني) 300

(3) متغيرات التنقيح

المتغير الوصف الافتراضي
CLAUDE_DEBUG تفعيل تسجيل التنقيح false
CLAUDE_HOOK_DEBUG تسجيل تنقيح الخطافات false
CLAUDE_LOG_LEVEL مستوى السجل info
CLAUDE_LOG_FILE مسار ملف السجل -

3. أفضل ممارسات تهيئة التطوير

(1) أولوية التهيئة

TEXT 📖 للعرض فقط
1. معاملات سطر الأوامر    --model claude-opus-4-20250514
2. متغيرات البيئة  CLAUDE_MODEL=claude-opus-4-20250514
3. .env الخاص بالمشروع           المتغيرات في ملف .env
4. CLAUDE.md الخاص بالمشروع      تهيئة على مستوى المشروع
5. الإعدادات العامة        ~/.claude/settings.json
6. CLAUDE.md العام       ~/.claude/CLAUDE.md
7. القيم الافتراضية         الافتراضيات المدمجة

(2) إدارة ملف .env

BASH
# .env
ANTHROPIC_API_KEY=sk-ant-api03-xxxxx
CLAUDE_MODEL=claude-sonnet-4-20250514
CLAUDE_STYLE=concise

# تأكد من إضافة .env إلى .gitignore
echo ".env*" >> .gitignore

▶ مثال 1: استخدام direnv للتبديل التلقائي

BASH
# project-a/.envrc
export ANTHROPIC_API_KEY="sk-ant-api03-project-a"
export CLAUDE_MODEL="claude-sonnet-4-20250514"

# project-b/.envrc
export ANTHROPIC_API_KEY="sk-deepseek-xxxxx"
export ANTHROPIC_BASE_URL="https://api.deepseek.com"
export CLAUDE_MODEL="deepseek-chat"

# دخول المجلد → تحميل التهيئة المناسبة تلقائياً

4. إدارة البيئات المتعددة

(1) مصفوفة البيئات

البيئة مفتاح API النموذج النمط التنقيح
التطوير مفتاح التطوير Sonnet verbose مفعّل
الاختبار مفتاح الاختبار Sonnet default معطّل
CI مفتاح CI Sonnet JSON معطّل
شخصي شخصي Opus concise معطّل

(2) حلول التبديل

BASH
# أسماء مستعارة للصدفة
alias claude-dev='ANTHROPIC_API_KEY=$DEV_KEY CLAUDE_DEBUG=true claude'
alias claude-ci='ANTHROPIC_API_KEY=$CI_KEY claude --headless --output json'

# direnv (موصى به)
# كل مجلد مشروع يحمّل .envrc المناسب تلقائياً

# ملف تهيئة
claude --env-file ./configs/production.env

▶ مثال 2: تهيئة مشتركة للفريق

BASH
# .env.example (مُودع في git، بدون أسرار)
ANTHROPIC_API_KEY=your-api-key-here
CLAUDE_MODEL=claude-sonnet-4-20250514
CLAUDE_STYLE=concise
CLAUDE_AUTO_TEST=true

# كل مطور ينسخ ويملأ
cp .env.example .env
# عدّل .env بمفتاح API الشخصي

5. التنقيح والتشخيص

BASH
# تفعيل التنقيح الكامل
export CLAUDE_DEBUG=true
export CLAUDE_LOG_LEVEL=debug
export CLAUDE_HOOK_DEBUG=1
export CLAUDE_LOG_FILE=/tmp/claude-debug.log

# تشغيل Claude Code
claude "test task"

# عرض السجلات
tail -f /tmp/claude-debug.log

6. مثال شامل: تهيئة تطوير كاملة

BASH
# ~/.zshrc (تهيئة عامة)
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"
export CLAUDE_MODEL="claude-sonnet-4-20250514"
export CLAUDE_STYLE="concise"
export CLAUDE_AUTO_TEST="true"

# .envrc الخاص بالمشروع
export CLAUDE_MODEL="claude-opus-4-20250514"  # هذا المشروع يستخدم Opus
export CLAUDE_MAX_TURNS="30"

# ~/.claude/settings.json
{
  "output": { "showDiff": true, "autoTest": true },
  "permissions": { "autoApprove": ["Read", "Write"] }
}

❓ أسئلة شائعة

س أولوية متغيرات البيئة مقابل CLAUDE.md؟
ج متغيرات البيئة تتفوق. CLAUDE.md للتفضيلات/الاتفاقيات؛ ومتغيرات البيئة لتهيئة التشغيل (مثل مفتاح API).
س هل مفتاح API في .env آمن؟
ج للتطوير المحلي نعم، لكن تأكد من إضافة .env إلى .gitignore. استخدم Secrets لـ CI.
س ما القيمة المناسبة لـ CLAUDE_MAX_TURNS؟
ج 20-30 للاستخدام اليومي. 50 للمهام المعقدة. القيمة الصغيرة جداً قد توقف المهام مبكراً.
س كيف أتحقق من أن متغيرات البيئة تعمل؟
ج شغّل /config في Claude Code، أو echo $ANTHROPIC_API_KEY.

📖 ملخص


📝 تمارين

  1. أساسي (⭐): هيّئ CLAUDE_STYLE و CLAUDE_LANGUAGE، وتحقق من تغير الإخراج.
  2. متوسط (⭐⭐): استخدم direnv لمشروعين بمفتاح API ونموذج مختلفين، وتحقق من التبديل التلقائي.
  3. متقدم (⭐⭐⭐): صمّم تهيئة بيئة على مستوى الفريق تغطي تطوير/اختبار/CI مع أمان الأسرار.
Web-Tutorial.com

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

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

100%