1. انسخ التكوين النموذجي:

   cd examples
   cp claude_desktop/claude_desktop_config.example.json claude_desktop/claude_desktop_config.json
   

2. عدّل ملف التكوين واستبدل مسارات العناصر النائبة:

   • استبدل /path/to/your/python بمسار Python الفعلي لديك (مثل /usr/bin/python3 أو /opt/homebrew/bin/python3)
   • استبدل /path/to/coderunner بالمسار الفعلي للمستودع المستنسخ لديك

   مثال بعد التعديل:

   {
     "mcpServers": {
       "coderunner": {
         "command": "/opt/homebrew/bin/python3",
         "args": ["/Users/yourname/coderunner/examples/claude_desktop/mcpproxy.py"]
       }
     }
   }
   

3. حدّث تكوين Claude Desktop:

   • افتح Claude Desktop
   • انتقل إلى الإعدادات → المطوّر
   • أضف تكوين خادم MCP
   • أعد تشغيل Claude Desktop

4. ابدأ استخدام CodeRunner في Claude: يمكنك الآن أن تطلب من Claude تنفيذ كود، وسيعمل بأمان داخل بيئة العزل!

البدء السريع:

# 1. Install and start CodeRunner (one-time setup)
git clone https://github.com/instavm/coderunner.git
cd coderunner
sudo ./install.sh

# 2. Install the Claude Code plugin
claude plugin marketplace add https://github.com/instavm/coderunner-plugin
claude plugin install instavm-coderunner

# 3. Reconnect to MCP servers
/mcp

خطوات التثبيت:

1. انتقل إلى سوق الإضافات:

   

2. أضف مستودع InstaVM:

   

3. نفّذ كود Python مع Claude Code:

   

وهكذا! أصبح بإمكان Claude Code الآن الوصول إلى جميع أدوات CodeRunner:

• execute_python_code - تشغيل كود Python في نواة Jupyter دائمة
• navigate_and_get_all_visible_text - استخراج بيانات الويب باستخدام Playwright
• list_skills - سرد المهارات المتاحة (docx وxlsx وpptx وpdf ومعالجة الصور وغيرها)
• get_skill_info - الحصول على توثيق لمهارات محددة
• get_skill_file - قراءة ملفات المهارات والأمثلة

لمعرفة المزيد: راجع مستودع الإضافة للحصول على توثيق مفصل.

أنشئ أو عدّل ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "coderunner": {
      "type": "remote",
      "url": "http://coderunner.local:8222/mcp",
      "enabled": true
    }
  }
}

بعد حفظ التكوين:

1. أعد تشغيل OpenCode
2. ستتوفر أدوات CodeRunner تلقائيًا
3. ابدأ بتنفيذ كود Python مع وصول كامل إلى البيئة المعزولة

1. عيّن مفتاح OpenAI API الخاص بك:

   export OPENAI_API_KEY="your-openai-api-key-here"
   

2. شغّل العميل:

   python examples/openai_agents/openai_client.py
   

3. ابدأ البرمجة: أدخل مطالبات مثل "اكتب كود Python لتوليد 100 رقم أولي" وشاهدها تُنفَّذ بأمان داخل بيئة العزل!

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal",
  "mcpServers": {
    "coderunner": {
      "httpUrl": "http://coderunner.local:8222/mcp"
    }
  }
}

{
  "mcpServers": {
    "coderunner": {
      "command": "/path/to/venv/bin/python",
      "args": [
        "/path/to/coderunner/examples/claude_desktop/mcpproxy.py"
      ],
      "disabled": false,
      "autoApprove": [
        "execute_python_code"
      ]
    }
  }
}