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.📖 ملخص
- متغيرات البيئة الأساسية:
ANTHROPIC_API_KEY،CLAUDE_MODEL،CLAUDE_STYLE - الأولوية: CLI > متغيرات البيئة > .env > CLAUDE.md > الإعدادات
- direnv للتبديل التلقائي للتهيئة على مستوى المجلد
.env.exampleفي git، و.envفي .gitignore- متغيرات التنقيح تُفعّل فقط عند استكشاف الأخطاء
📝 تمارين
- أساسي (⭐): هيّئ
CLAUDE_STYLEوCLAUDE_LANGUAGE، وتحقق من تغير الإخراج. - متوسط (⭐⭐): استخدم direnv لمشروعين بمفتاح API ونموذج مختلفين، وتحقق من التبديل التلقائي.
- متقدم (⭐⭐⭐): صمّم تهيئة بيئة على مستوى الفريق تغطي تطوير/اختبار/CI مع أمان الأسرار.