כיצד להתקין את OpenCode?

הדרך המהירה ביותר היא להשתמש ב-npm: הרץ את 'npm install -g opencode'. לחלופין, השתמש ב-Homebrew ב-macOS ('brew install opencode'), Go install ('go install github.com/opencode-ai/opencode@latest') או הורד את הקובץ הבינארי ממדור ה-GitHub releases.

האם OpenCode עובד ללא Claude?

כן. לאחר ש-Anthropic הגבילה את הגישה ל-Claude ב-OpenCode, הכלי עובד כעת עם GPT-5.4, Gemini 2.5 Pro, Ollama (local models) וספקים אחרים. פשוט הגדר את ה-API key המועדף עליך.

מהן דרישות המערכת עבור OpenCode?

OpenCode דורש Node.js 18+ (עבור npm install) או Go 1.21+ (עבור Go install). הוא פועל על macOS, Linux ו-Windows (מומלץ WSL). GPU אינו נדרש — הכלי מתחבר ל-AI APIs בענן.

כיצד להגדיר את OpenCode לאחר ההתקנה?

הרץ את 'opencode' בספריית הפרויקט. בהרצה הראשונה תתבקש להגדיר API key. ניתן להגדיר את הספק (OpenAI, Google, Ollama) ב-~/.config/opencode/config.toml או באמצעות משתני סביבה.

מדוע התקנת OpenCode נכשלת?

בעיות נפוצות: גרסת Node.js ישנה מדי (נדרשת 18+), שגיאות הרשאה (השתמש ב-'sudo npm install -g opencode' או תקן הרשאות npm), בעיות רשת מאחורי firewalls ארגוניים (השתמש בדגל --registry) או היעדר Go ב-PATH (עבור שיטת Go install).

أهم النقاط المستفادة

مسارات تثبيت متعددة: npm، Homebrew، سكريبت curl، تثبيت Go، Docker، والبناء من المصدر -- اختر ما يناسب toolchain الخاصة بك.
خمس دقائق للتشغيل الأول: أسرع مسار (سكريبت تثبيت curl) يجعل OpenCode يعمل في أقل من خمس دقائق على أي نظام Unix.
مستقل عن المزود (Provider-agnostic): يعمل OpenCode مع OpenAI، Google Gemini، نماذج Ollama المحلية، والمزيد -- لست مقيداً بمزود AI واحد.
الإعداد بسيط للغاية: ملف config.toml واحد ومتغير بيئة واحد هما كل ما تحتاجه لبدء البرمجة باستخدام AI في terminal الخاصة بك.

كيفية تثبيت OpenCode: دليل الإعداد خطوة بخطوة (2026)

OpenCode هو وكيل برمجة AI مفتوح المصدر مصمم لـ terminal. إنه يجلب قوة نماذج اللغة الكبيرة مباشرة إلى command line الخاصة بك، مما يتيح لك كتابة، refactor، debug، وفهم الكود دون مغادرة المحرر أو workflow الخاص بـ terminal.

سواء كنت تقوم بإعداد OpenCode لأول مرة أو تنتقل من أداة برمجة AI أخرى، فإن هذا الدليل سيرشدك عبر كل طريقة تثبيت، والإعداد الأولي، وإعداد المزود، وخطوات troubleshooting التي ستحتاجها.

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

قبل تثبيت OpenCode، تأكد من أن نظامك يلبي المتطلبات التالية.

نظام التشغيل

يعمل OpenCode على macOS، Linux، و Windows. لمستخدمي Windows، يوصى بشدة باستخدام WSL (Windows Subsystem for Linux). يتوفر أيضاً دعم Windows الأصلي عبر Scoop.

متطلبات التشغيل (تعتمد على طريقة التثبيت)

طريقة التثبيت	المتطلبات
npm	Node.js 18 أو أعلى
Homebrew	macOS أو Linux مع تثبيت Homebrew
سكريبت Curl	bash, curl
تثبيت Go	Go 1.22 أو أعلى
Docker	Docker Engine 20+
بناء من المصدر	Go 1.22+, Git

متطلبات Terminal

يوفر OpenCode واجهة TUI (Terminal User Interface)، لذا يجب أن يدعم terminal emulator الخاص بك true color و rendering الصحيح لـ Unicode. معظم الـ terminals الحديثة (iTerm2، Alacritty، WezTerm، Windows Terminal، Ghostty) تعمل بشكل مباشر. قد تواجه الـ terminals القديمة مثل Terminal.app الافتراضي في macOS مشكلات في rendering.

تحقق من إصدار Node.js الخاص بك:

node --version

تحقق من إصدار Go الخاص بك (في حال استخدام طريقة تثبيت Go):

go version

الطريقة 1: سكريبت التثبيت (الأسرع)

سكريبت التثبيت الرسمي هو أسرع طريقة لتشغيل OpenCode. يكتشف نظام التشغيل والمعمارية الخاصة بك، وينزل binary الصحيح، ويضعه في PATH الخاص بك.

curl -fsSL https://opencode.ai/install | bash

هذا الأمر الواحد يتولى كل شيء. بعد اكتماله، تحقق من التثبيت:

opencode --version

تعمل هذه الطريقة على macOS و Linux. لا تتطلب Node.js أو Go.

الطريقة 2: تثبيت npm

إذا كان لديك بالفعل Node.js في workflow الخاص بك، فإن npm هو الخيار الأكثر ألفة.

npm install -g opencode-ai@latest

اسم الحزمة على npm هو opencode-ai وليس opencode. هذا مصدر شائع للارتباك.

للتحقق:

opencode --version

إذا واجهت أخطاء في الأذونات، فإما أن تقوم بإصلاح أذونات دليل npm العالمي أو استخدم npx لتشغيله بدون تثبيت عالمي:

npx opencode-ai@latest

الطريقة 3: Homebrew (macOS و Linux)

يمكن لمستخدمي Homebrew تثبيت OpenCode من tap الرسمي:

brew install anomalyco/tap/opencode

يقوم هذا بتثبيت أحدث إصدار مستقر ويتولى التحديثات من خلال brew upgrade.

للتحقق:

opencode --version

الطريقة 4: تثبيت Go

إذا كان لديك Go 1.22+ مثبتاً، يمكنك التثبيت مباشرة من المصدر عبر go install:

go install github.com/opencode-ai/opencode@latest

تأكد من أن $GOPATH/bin (أو $HOME/go/bin افتراضياً) موجود في PATH الخاص بك. أضفه إلى shell profile الخاص بك إذا لم يكن موجوداً بالفعل:

export PATH="$PATH:$(go env GOPATH)/bin"

تحقق:

opencode --version

الطريقة 5: Docker

تشغيل OpenCode في Docker مفيد لـ CI/CD pipelines أو عندما تريد بيئة معزولة.

docker pull ghcr.io/opencode-ai/opencode:latest

قم بتشغيله مع عمل mount لدليل مشروعك:

docker run -it --rm \
  -v "$(pwd)":/workspace \
  -w /workspace \
  -e OPENAI_API_KEY="$OPENAI_API_KEY" \
  ghcr.io/opencode-ai/opencode:latest

تعد أعلام -it ضرورية لأن OpenCode يستخدم TUI تفاعلية. يقوم علم -v بعمل mount لدليل مشروعك الحالي حتى يتمكن OpenCode من قراءة وتعديل ملفاتك.

الطريقة 6: البناء من المصدر

للمساهمين أو أي شخص يريد أحدث إصدار (bleeding-edge):

git clone https://github.com/opencode-ai/opencode.git
cd opencode
go build -o opencode .

انقل binary إلى دليل في PATH الخاص بك:

sudo mv opencode /usr/local/bin/

يتطلب البناء من المصدر Go 1.22+ و Git. يمنحك هذا الوصول إلى ميزات غير مصدّرة ويتيح لك تعديل الأداة لاحتياجاتك الخاصة.

الطريقة 7: Scoop (Windows)

يمكن لمستخدمي Windows الذين يفضلون تجربة أصلية على WSL استخدام Scoop:

scoop install opencode

يتولى Scoop إعداد PATH تلقائياً.

التشغيل الأول والإعداد

مع تثبيت OpenCode، انتقل إلى أي دليل مشروع وقم بتشغيله:

cd your-project
opencode

عند التشغيل الأول، يفتح OpenCode واجهة TUI الخاصة به ويطلب منك توصيل مزود AI. يمكنك استخدام أمر /connect التفاعلي لإضافة API key الخاص بك:

/connect

يرشدك هذا خلال اختيار مزود (OpenAI، Google، Anthropic، إلخ) وإدخال API key الخاص بك. يتم تخزين بيانات الاعتماد في ~/.local/share/opencode/auth.json.

لبدء أسرع، يمكنك أيضاً تهيئة مشروعك بـ:

/init

يقوم هذا بتحليل هيكل repository الخاص بك وإنشاء ملف agents.md مع سياق حول codebase الخاص بك، مما يساعد الـ AI على تقديم استجابات أكثر دقة من البداية.

إعداد مزودي AI

يدعم OpenCode مزودي AI متعددين. إليك كيفية إعداد كل واحد منهم.

OpenAI (GPT-5.4, GPT-4.1, o3)

قم بتعيين API key كمتغير بيئة:

export OPENAI_API_KEY="sk-your-key-here"

أو أضفه إلى shell profile الخاص بك (~/.zshrc، ~/.bashrc) للاستمرار.

Google Gemini (Gemini 2.5 Pro, Gemini 2.5 Flash)

export GOOGLE_API_KEY="your-google-api-key"

يمكنك الحصول على Google API key من Google AI Studio.

Ollama (نماذج محلية -- مجانية، خاصة)

يتيح لك Ollama تشغيل النماذج محلياً دون أي API key. قم بتثبيت Ollama أولاً، ثم اسحب نموذجاً، ثم قم بإعداد OpenCode:

# Install Ollama (if not already installed)
curl -fsSL https://ollama.com/install.sh | sh

# Pull a coding model
ollama pull qwen2.5-coder:32b

# OpenCode detects Ollama automatically when running on localhost:11434

لا يلزم وجود API key لـ Ollama. يكتشفه OpenCode تلقائياً عند التشغيل محلياً.

Anthropic (Claude -- وصول محدود)

قامت Anthropic بتقييد الوصول إلى Claude في أدوات الطرف الثالث بما في ذلك OpenCode. إذا كان لديك API key لا يزال يعمل:

export ANTHROPIC_API_KEY="sk-ant-your-key-here"

ومع ذلك، يستخدم معظم المستخدمين في 2026 OpenAI أو Gemini كمزود أساسي لهم مع OpenCode بسبب هذه القيود.

الإعداد الأساسي: شرح config.toml

يستخدم OpenCode ملف إعداد TOML للتحكم الدقيق. يوجد ملف الإعداد في ~/.config/opencode/config.toml (أو في جذر مشروعك كـ opencode.json للإعدادات الخاصة بالمشروع).

إليك مثال عملي لملف config.toml:

# Provider configuration
[provider.openai]
apiKey = "{env:OPENAI_API_KEY}"

[provider.openai.models.gpt]
id = "gpt-5.4"

[provider.google]
apiKey = "{env:GOOGLE_API_KEY}"

[provider.google.models.gemini]
id = "gemini-2.5-pro"

# Disable providers you do not use
disabled_providers = ["anthropic"]

أمور رئيسية يجب ملاحظتها:

استبدال المتغيرات: استخدم {env:VARIABLE_NAME} للإشارة إلى متغيرات البيئة بدلاً من كتابة المفاتيح يدوياً (hardcoding).
اختيار النموذج: يمكنك تحديد النموذج الذي تريد استخدامه بالضبط تحت كل مزود.
المزودون المعطلون: منع OpenCode من تحميل المزودين الذين لا تملك بيانات اعتماد لهم، لتجنب تحذيرات التشغيل.
تجاوز Base URL: إذا كنت تستخدم proxy أو custom endpoint، أضف baseURL = "https://your-proxy.com/v1" تحت قسم المزود.

للإعداد على مستوى المشروع، أنشئ ملف opencode.json في جذر مشروعك:

{
  "provider": "openai",
  "model": "gpt-5.4"
}

يؤدي هذا إلى تجاوز الإعدادات العالمية لهذا المشروع المحدد.

تحقق من التثبيت الخاص بك

اتبع قائمة التحقق هذه للتأكد من أن كل شيء يعمل بشكل صحيح.

1. تحقق من الإصدار

opencode --version

يجب أن ترى رقم الإصدار مطبوعاً. اعتباراً من March 2026، أحدث إصدار مستقر هو في نطاق 0.x.

2. قم بتشغيل TUI

cd any-project-directory
opencode

يجب أن ترى واجهة terminal الخاصة بـ OpenCode مع وجود prompt في الأسفل.

3. اختبر prompt بسيطاً

في TUI الخاصة بـ OpenCode، اكتب طلباً بسيطاً:

Explain what this project does based on the file structure.

إذا حصلت على استجابة من الـ AI، فإن إعداد المزود الخاص بك يعمل.

4. اختبر عمليات الملفات

اطلب من OpenCode إنشاء ملف اختبار صغير:

Create a file called test-opencode.txt with the text "OpenCode is working"

تحقق من إنشاء الملف في دليل مشروعك، ثم قم بحذفه.

حل المشكلات الشائعة (Troubleshooting)

"command not found: opencode"

الـ binary ليس في PATH الخاص بك. تعتمد الحلول على طريقة التثبيت:

npm: قم بتشغيل npm list -g opencode-ai لتأكيد التثبيت. إذا تم التثبيت، فتحقق من أن دليل bin العالمي لـ npm موجود في PATH الخاص بك: npm config get prefix وأضف /bin إلى ذلك المسار.
Go: أضف $(go env GOPATH)/bin إلى PATH الخاص بك.
سكريبت Curl: أعد تشغيل سكريبت التثبيت أو انقل binary يدوياً إلى /usr/local/bin/.

أخطاء في الأذونات أثناء تثبيت npm

لا تستخدم sudo npm install -g. بدلاً من ذلك، قم بإصلاح دليل npm الافتراضي:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
npm install -g opencode-ai@latest

"Error: Node.js version too old"

تتطلب حزمة npm الخاصة بـ OpenCode إصدار Node.js 18+. تحقق من إصدارك:

node --version

إذا كنت تستخدم إصداراً أقدماً، فقم بالترقية باستخدام nvm:

nvm install 18
nvm use 18

أخطاء الشبكة خلف جدار حماية (firewall) للشركة

إذا توقف تثبيت npm أو فشل بسبب قيود الشبكة:

npm install -g opencode-ai@latest --registry https://registry.npmmirror.com

أو قم بتنزيل binary مباشرة من صفحة إصدارات GitHub وضعه في PATH الخاص بك يدوياً.

"API key not found" أو "No provider configured"

تأكد من تصدير (export) متغير البيئة الخاص بـ API key في نفس جلسة shell:

echo $OPENAI_API_KEY

إذا لم يطبع شيئاً، فقم بتعيينه مرة أخرى:

export OPENAI_API_KEY="sk-your-key-here"

للاستمرار، أضف سطر export إلى ملف ~/.zshrc أو ~/.bashrc الخاص بك وقم بتشغيل source ~/.zshrc.

مشكلات في rendering الخاص بـ TUI (نص مشوه، حدود مفقودة)

انتقل إلى terminal emulator حديث يدعم true color. الخيارات الموصى بها: iTerm2 (macOS)، Alacritty (عابر للمنصات)، WezTerm (عابر للمنصات)، أو Windows Terminal (Windows).

تثبيت Go: "go: command not found"

Go ليس مثبتاً أو ليس في PATH الخاص بك. قم بتثبيت Go من go.dev/dl وتأكد من وجوده في PATH الخاص بك:

export PATH="$PATH:/usr/local/go/bin"

تحديث OpenCode

حافظ على تحديث OpenCode للحصول على أحدث دعم للنماذج وإصلاحات الأخطاء.

npm:

npm update -g opencode-ai

Homebrew:

brew upgrade opencode

سكريبت Curl: أعد تشغيل أمر التثبيت:

curl -fsSL https://opencode.ai/install | bash

تثبيت Go: أعد التشغيل باستخدام @latest:

go install github.com/opencode-ai/opencode@latest

الخطوات التالية

الآن بعد تثبيت OpenCode وإعداده، فأنت جاهز لبدء استخدامه في workflow اليومي الخاص بك.

تعلم الأوامر: اطلع على OpenCode Tutorial 2026 للحصول على شرح كامل للأوامر، و workflows، والميزات المتقدمة.
إعداد تكامل GitHub: قم بتثبيت OpenCode GitHub App لاستخدام مراجعة الكود المدعومة بـ AI واستجابات الـ issues مباشرة في repositories الخاصة بك.
استكشف أمر /init: قم بتشغيل /init في مشروعك لإنشاء ملف agents.md الذي يمنح OpenCode سياقاً عميقاً حول معمارية codebase الخاص بك.
جرب مزودين متعددين: قم بإعداد اثنين أو ثلاثة من المزودين والتبديل بينهم للعثور على النموذج الذي يعمل بشكل أفضل لمهام البرمجة الخاصة بك.

يعد OpenCode أحد أسرع أدوات AI مفتوحة المصدر نمواً في 2026 لأنه يلبي احتياجات المطورين حيث يعملون بالفعل: terminal. مع استغراق التثبيت أقل من خمس دقائق وتطلب الإعداد API key واحداً فقط، فلا يوجد سبب لعدم تجربته اليوم.

NxCode

כיצד להתקין את OpenCode: מדריך הגדרה שלב אחר שלב (2026)