كيفية استخدام gpt-oss مع Claude Code

هل ترغب في تعزيز سير عملك البرمجي باستخدام GPT-OSS، نموذج OpenAI مفتوح الوزن، مباشرة داخل Claude Code؟ أنت على موعد مع تجربة رائعة! صدر GPT-OSS (بإصداراته 20B أو 120B) في أغسطس 2025، وهو قوة هائلة للبرمجة والاستدلال، ويمكنك إقرانه بواجهة سطر الأوامر الأنيقة لـ Claude Code لإعدادات مجانية أو منخفضة التكلفة. في هذا الدليل الحواري، سنرشدك عبر ثلاثة مسارات لدمج GPT-OSS مع Claude Code باستخدام Hugging Face أو OpenRouter أو LiteLLM. دعنا نتعمق ونجهز مساعدك البرمجي المدعوم بالذكاء الاصطناعي للعمل!

ما هو GPT-OSS ولماذا تستخدمه مع Claude Code؟

GPT-OSS هي عائلة نماذج OpenAI مفتوحة الوزن، حيث تقدم إصدارات 20B و 120B أداءً ممتازًا لمهام البرمجة والاستدلال والمهام الوكيلية. مع نافذة سياق بحجم 128 ألف توكن وترخيص Apache 2.0، فهو مثالي للمطورين الذين يرغبون في المرونة والتحكم. Claude Code، أداة سطر الأوامر (CLI) من Anthropic (الإصدار 0.5.3+)، هي المفضلة لدى المطورين لقدراتها على البرمجة التخاطبية. من خلال توجيه Claude Code إلى GPT-OSS عبر واجهات برمجة التطبيقات المتوافقة مع OpenAI، يمكنك الاستمتاع بواجهة Claude المألوفة مع الاستفادة من قوة GPT-OSS مفتوحة المصدر - دون تكاليف اشتراك Anthropic. هل أنت مستعد لتحقيق ذلك؟ دعنا نستكشف خيارات الإعداد!

المتطلبات الأساسية لاستخدام GPT-OSS مع Claude Code

قبل أن نبدأ، تأكد من توفر ما يلي:

• Claude Code ≥ 0.5.3: تحقق باستخدام claude --version. ثبّت عبر pip install claude-code أو حدّث باستخدام pip install --upgrade claude-code.
• حساب Hugging Face: سجّل في huggingface.co وأنشئ رمزًا للقراءة/الكتابة (الإعدادات > رموز الوصول).
• مفتاح OpenRouter API: اختياري، للمسار B. احصل عليه من openrouter.ai.
• Python 3.10+ و Docker: للإعدادات المحلية أو LiteLLM (المسار C).
• معرفة أساسية بسطر الأوامر (CLI): الإلمام بمتغيرات البيئة وأوامر الطرفية يساعد.

المسار أ: استضافة GPT-OSS ذاتيًا على Hugging Face

هل تريد تحكمًا كاملاً؟ استضف GPT-OSS على نقاط نهاية الاستدلال (Inference Endpoints) الخاصة بـ Hugging Face لإعداد خاص وقابل للتطوير. إليك الطريقة:

الخطوة 1: الحصول على النموذج

1. زر مستودع GPT-OSS على Hugging Face (openai/gpt-oss-20b أو openai/gpt-oss-120b).
2. اقبل ترخيص Apache 2.0 للوصول إلى النموذج.
3. بدلاً من ذلك، جرّب Qwen3-Coder-480B-A35B-Instruct (Qwen/Qwen3-Coder-480B-A35B-Instruct) لنموذج يركز على البرمجة (استخدم إصدار GGUF للأجهزة الأخف).

الخطوة 2: نشر نقطة نهاية استدلال لتوليد النصوص

1. في صفحة النموذج، انقر على Deploy (نشر) > Inference Endpoint (نقطة نهاية الاستدلال).
2. حدد قالب Text Generation Inference (TGI) (≥ v1.4.0).
3. قم بتمكين توافق OpenAI عن طريق تحديد Enable OpenAI compatibility (تمكين توافق OpenAI) أو إضافة --enable-openai في الإعدادات المتقدمة.
4. اختر الأجهزة: A10G أو CPU للإصدار 20B، و A100 للإصدار 120B. أنشئ نقطة النهاية.

الخطوة 3: جمع بيانات الاعتماد

1. بمجرد أن يصبح حالة نقطة النهاية قيد التشغيل، انسخ:

• ENDPOINT_URL: يبدو كـ https://<your-endpoint>.us-east-1.aws.endpoints.huggingface.cloud.
• HF_API_TOKEN: رمز Hugging Face الخاص بك من الإعدادات > رموز الوصول.

2. لاحظ معرف النموذج (على سبيل المثال، gpt-oss-20b أو gpt-oss-120b).

الخطوة 4: تهيئة Claude Code

1. عيّن متغيرات البيئة في الطرفية الخاصة بك:

export ANTHROPIC_BASE_URL="https://<your-endpoint>.us-east-1.aws.endpoints.huggingface.cloud"
export ANTHROPIC_AUTH_TOKEN="hf_xxxxxxxxxxxxxxxxx"
export ANTHROPIC_MODEL="gpt-oss-20b"  # أو gpt-oss-120b

استبدل <your-endpoint> و hf_xxxxxxxxxxxxxxxxx بقيمك الخاصة.

2. اختبر الإعداد:

claude --model gpt-oss-20b

يوجه Claude Code إلى نقطة نهاية GPT-OSS الخاصة بك، ويقوم ببث الاستجابات عبر واجهة برمجة تطبيقات TGI /v1/chat/completions، محاكياً مخطط OpenAI.

الخطوة 5: ملاحظات حول التكلفة والتوسع

• تكاليف Hugging Face: تتوسع نقاط نهاية الاستدلال تلقائيًا، لذا راقب الاستخدام لتجنب استهلاك الرصيد. تكلفة A10G حوالي 0.60 دولارًا في الساعة، و A100 حوالي 3 دولارات في الساعة.
• الخيار المحلي: لتجنب تكاليف السحابة، قم بتشغيل TGI محليًا باستخدام Docker:

docker run --name tgi -p 8080:80 -e HF_TOKEN=hf_xxxxxxxxxxxxxxxxx ghcr.io/huggingface/text-generation-inference:latest --model-id openai/gpt-oss-20b --enable-openai

ثم عيّن ANTHROPIC_BASE_URL="http://localhost:8080".

المسار ب: وكيل GPT-OSS عبر OpenRouter

لا يوجد DevOps؟ لا مشكلة! استخدم OpenRouter للوصول إلى GPT-OSS بأقل إعداد. إنه سريع ويتولى الفوترة نيابة عنك.

الخطوة 1: التسجيل واختيار نموذج

1. سجّل في openrouter.ai وانسخ مفتاح API الخاص بك من قسم Keys (المفاتيح).
2. اختر معرف النموذج (model slug):

• openai/gpt-oss-20b
• openai/gpt-oss-120b
• qwen/qwen3-coder-480b (لنموذج Qwen المخصص للمبرمجين)

الخطوة 2: تهيئة Claude Code

1. عيّن متغيرات البيئة:

export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_AUTH_TOKEN="or_xxxxxxxxx"
export ANTHROPIC_MODEL="openai/gpt-oss-20b"

استبدل or_xxxxxxxxx بمفتاح OpenRouter API الخاص بك.

2. اختبره:

claude --model openai/gpt-oss-20b

يتصل Claude Code بـ GPT-OSS عبر واجهة برمجة تطبيقات OpenRouter الموحدة، مع دعم البث والاحتياطي.

الخطوة 3: ملاحظات التكلفة

• تسعير OpenRouter: حوالي 0.50 دولار لكل مليون توكن إدخال، وحوالي 2.00 دولار لكل مليون توكن إخراج لـ GPT-OSS-120B، وهو أرخص بكثير من النماذج الاحتكارية مثل GPT-4 (حوالي 20.00 دولارًا لكل مليون).
• الفوترة: يدير OpenRouter الاستخدام، لذا تدفع فقط مقابل ما تستخدمه.

المسار ج: استخدام LiteLLM لأساطيل النماذج المختلطة

هل تريد التوفيق بين نماذج GPT-OSS و Qwen و Anthropic في سير عمل واحد؟ يعمل LiteLLM كوكيل لتبديل النماذج بسلاسة.

الخطوة 1: تثبيت وتهيئة LiteLLM

1. ثبّت LiteLLM:

pip install litellm

2. أنشئ ملف تهيئة (litellm.yaml):

model_list:
  - model_name: gpt-oss-20b
    litellm_params:
      model: openai/gpt-oss-20b
      api_key: or_xxxxxxxxx  # مفتاح OpenRouter
      api_base: https://openrouter.ai/api/v1
  - model_name: qwen3-coder
    litellm_params:
      model: openrouter/qwen/qwen3-coder
      api_key: or_xxxxxxxxx
      api_base: https://openrouter.ai/api/v1

استبدل or_xxxxxxxxx بمفتاح OpenRouter الخاص بك.

3. ابدأ الوكيل:

litellm --config litellm.yaml

الخطوة 2: توجيه Claude Code إلى LiteLLM

1. عيّن متغيرات البيئة:

export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_AUTH_TOKEN="litellm_master"
export ANTHROPIC_MODEL="gpt-oss-20b"

2. اختبره:

claude --model gpt-oss-20b

يوجه LiteLLM الطلبات إلى GPT-OSS عبر OpenRouter، مع تسجيل التكلفة وتوجيه بسيط (simple-shuffle) للموثوقية.

الخطوة 3: ملاحظات

• تجنب توجيه الكمون: استخدم وضع التبديل البسيط (simple-shuffle) في LiteLLM لمنع المشكلات مع نماذج Anthropic.
• تتبع التكلفة: يسجل LiteLLM الاستخدام للشفافية.

اختبار GPT-OSS مع Claude Code

دعنا نتأكد من أن GPT-OSS يعمل! افتح Claude Code وجرب هذه الأوامر:

توليد الكود:

claude --model gpt-oss-20b "Write a Python REST API with Flask"

توقع استجابة مثل:

from flask import Flask, jsonify
app = Flask(__name__)
@app.route('/api', methods=['GET'])
def get_data():
    return jsonify({"message": "Hello from GPT-OSS!"})
if __name__ == '__main__':
    app.run(debug=True)

تحليل قاعدة الكود:

claude --model gpt-oss-20b "Summarize src/server.js"

يستفيد GPT-OSS من نافذة السياق البالغة 128 ألف توكن لتحليل ملف JavaScript الخاص بك وإرجاع ملخص.

تصحيح الأخطاء:

claude --model gpt-oss-20b "Debug this buggy Python code: [paste code]"

بمعدل نجاح HumanEval يبلغ 87.3%، يجب أن يكتشف GPT-OSS المشكلات ويصلحها بدقة.

نصائح استكشاف الأخطاء وإصلاحها

• خطأ 404 على /v1/chat/completions؟ تأكد من أن --enable-openai نشط في TGI (المسار أ) أو تحقق من توفر نموذج OpenRouter (المسار ب).
• استجابات فارغة؟ تحقق من أن ANTHROPIC_MODEL يطابق معرف النموذج (على سبيل المثال، gpt-oss-20b).
• خطأ 400 بعد تبديل النموذج؟ استخدم توجيه التبديل البسيط (simple-shuffle) في LiteLLM (المسار ج).
• أول توكن بطيء؟ قم بتسخين نقاط نهاية Hugging Face بمطالبة صغيرة بعد التوسع إلى الصفر.
• تعطل Claude Code؟ حدّث إلى الإصدار ≥ 0.5.3 وتأكد من تعيين متغيرات البيئة بشكل صحيح.

لماذا تستخدم GPT-OSS مع Claude Code؟

إقران GPT-OSS مع Claude Code هو حلم المطورين. ستحصل على:

• توفير التكاليف: تكلفة توكنات الإدخال في OpenRouter البالغة 0.50 دولار لكل مليون تتفوق على النماذج الاحتكارية، وإعدادات TGI المحلية مجانية بعد تكاليف الأجهزة.
• قوة المصدر المفتوح: يتيح لك ترخيص Apache 2.0 الخاص بـ GPT-OSS تخصيصه أو نشره بشكل خاص.
• سير عمل سلس: تبدو واجهة سطر الأوامر (CLI) الخاصة بـ Claude Code وكأنك تدردش مع رفيق برمجي، بينما يتعامل GPT-OSS مع المهام الثقيلة بنسب 94.2% MMLU و 96.6% AIME.
• المرونة: تبديل بين نماذج GPT-OSS أو Qwen أو Anthropic باستخدام LiteLLM أو OpenRouter.

يثني المستخدمون على براعة GPT-OSS في البرمجة، واصفين إياه بأنه "وحش صديق للميزانية للمشاريع متعددة الملفات". سواء قمت بالاستضافة الذاتية أو عبر وكيل OpenRouter، فإن هذا الإعداد يحافظ على التكاليف منخفضة والإنتاجية عالية.

الخاتمة

أنت الآن جاهز للانطلاق مع GPT-OSS و Claude Code! سواء قمت بالاستضافة الذاتية على Hugging Face، أو استخدمت وكيل OpenRouter، أو LiteLLM للتبديل بين النماذج، فقد حصلت على إعداد برمجي قوي وفعال من حيث التكلفة. من توليد واجهات برمجة تطبيقات REST إلى تصحيح الأخطاء البرمجية، يقدم GPT-OSS أداءً ممتازًا، ويجعل Claude Code الأمر يبدو سهلاً. جربه، وشارك مطالباتك المفضلة في التعليقات، ودعنا نستمتع بالبرمجة بالذكاء الاصطناعي!