إعداد المزوّد في Goose

توجيه مزوّدات goose المتوافقة مع Anthropic وOpenAI إلى QCode: أي حقل HOST يأخذ أي URL، وما لا يستطيع goose configure فعله

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

آخر تحقق: 2026-11-12 · 📄 وفق الوثائق الرسمية (goose v1.54.0، الإصدار الذي كُتبت بقية هذه الصفحة على أساسه في 2026-10-13؛ وقد أُعيد التحقق من قائمة نماذج Claude أدناه مقابل وثائق نماذج Anthropic في 2026-11-12)

نظرة سريعة¶

يصف goose نفسه بأنه «وكيل الذكاء الاصطناعي الأصلي مفتوح المصدر — تطبيق سطح المكتب وCLI وAPI». وهو الآن مشروع تابع لمؤسسة Agentic AI Foundation، لذا توجد الوثائق على goose-docs.ai (عنوان block.github.io/goose السابق يعيد التوجيه فقط)، والمستودع هو aaif-goose/goose، بينما لا تزال صيغة Homebrew تُسمى block-goose-cli. الإصدار المشار إليه في هذه الصفحة هو الإصدار المستقر v1.54.0، الصادر في 2026-10-08.

أي بروتوكول¶

لا تستدعِ Claude أبدًا عبر نقطة النهاية المتوافقة مع OpenAI. يقدّم QCode معرّفات claude-* على جانب Anthropic Messages فقط؛ ويرفضها جانب OpenAI (model_not_available_on_endpoint). أبقِ مزوّدين بدلًا من مزوّد واحد، واختر لكل جلسة باستخدام goose run --provider … --model …. التفاصيل: نقاط النهاية ومسارات API.

اسم الحقل هو HOST وليس base_url. يطلب goose الحقول ANTHROPIC_HOST وOPENAI_HOST وGOOSE_PROVIDER__HOST. أدخل المضيف مع بادئة المسار فقط — لا تكتب /v1/messages في الحقل. على جانب OpenAI، مسار الطلب حقل موثّق منفصل: يصف الجدول الرسمي OPENAI_BASE_PATH بأنه «Request path appended to the host (defaults to v1/chat/completions)». لا توضّح الوثائق الرسمية كيفية دمج ANTHROPIC_HOST مع مسار messages، لذا تعرض هذه الصفحة قيمة QCode فقط ولا تدّعي شيئًا على أنه مقيس.

التثبيت¶

CLI، عبر Homebrew أو السكربت الرسمي:

brew install block-goose-cli

# or
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

goose update
goose --version

سطح المكتب: على macOS استخدم Homebrew أو أزرار التنزيل؛ وعلى Linux توفّر الصفحة الرسمية حزم .deb و.rpm وFlatpak:

brew install --cask block-goose

إعداد Claude (مزوّد Anthropic)¶

يتبع المسار التفاعلي مطالبات prompt الرسمية:

goose configure
# Configure Providers (Change provider or update credentials)  -> choose Anthropic
# Provider Anthropic requires ANTHROPIC_API_KEY, please enter a value  -> your QCode key
# Enter your desired ANTHROPIC_HOST or press Enter to use the default.  -> https://api.qcode.cc/api

تؤدي المتغيرات التي تجمعها صفحة متغيرات البيئة الرسمية ضمن نقاط النهاية المخصصة المهمة نفسها دون المعالج:

export GOOSE_PROVIDER="anthropic"
export GOOSE_MODEL="claude-sonnet-5"
export GOOSE_PROVIDER__TYPE="anthropic"
export GOOSE_PROVIDER__HOST="https://api.qcode.cc/api"
export GOOSE_PROVIDER__API_KEY="cr_your_qcode_key"

في config.yaml (macOS/Linux: ~/.config/goose/config.yaml) توجد إعدادات المزوّد في المفتاحين active_provider وproviders:

active_provider: anthropic
providers:
  anthropic:
    enabled: true
    model: claude-sonnet-5
    configured: true

• لا ينتمي المفتاح إلى ذلك الملف: تنص الوثائق الرسمية على «Provider API keys do not go in config.yaml». احتفظ به في حلقة المفاتيح عبر goose configure، أو في secrets.yaml، أو في متغير بيئة المزوّد.
• العُقد الإقليمية: استبدل المضيف بـ https://asia.qcode.cc/api أو https://us.qcode.cc/api. المفتاح نفسه يعمل.
• معرّفات Claude المتاحة على QCode: claude-sonnet-5، claude-sonnet-5-5، claude-opus-5، claude-opus-5-5، claude-haiku-5-5، claude-sonnet-4-6، claude-fable-5-2، claude-fable-5-1، claude-fable-5. تُحتسب الفاتورة حسب token؛ وتُدرج أسعار كل نموذج على https://qcode.cc/models
• claude-fable-5-2 هو Claude Fable 5.2، صدر في 2026-11-09 وهو Fable الحالي على QCode؛ لا يزال claude-fable-5-1 السابق معروضًا للبيع. يعمل على نقطة نهاية Anthropic Messages نفسها بنافذة سياق 1M token وبحد أقصى للإخراج 128K، لذا على جانب goose تتغير قيمة النموذج فقط: export GOOSE_MODEL="claude-fable-5-2".

إعداد نماذج GPT والنماذج الصينية (متوافقة مع OpenAI)¶

يمكن لمزوّد OpenAI المدمج «الاتصال بـ API OpenAI الرسمي (api.openai.com) أو بأي نقطة نهاية متوافقة مع OpenAI»، وتنص الإرشادات الرسمية لمثل هذه البوابة على «ضبط OPENAI_HOST على جذر الوكيل الخاص بك (من دون مسار لاحق) وضبط OPENAI_BASE_PATH على المسار الذي يقدّمه (عادةً v1/chat/completions)»:

export OPENAI_API_KEY="cr_your_qcode_key"
export OPENAI_HOST="https://api.qcode.cc"
export OPENAI_BASE_PATH="openai/v1/chat/completions"
export GOOSE_PROVIDER="openai"
export GOOSE_MODEL="gpt-6.1-sol"

البديل هو الإبقاء على المسار الافتراضي الموثّق ونقل البادئة إلى المضيف، export OPENAI_HOST="https://api.qcode.cc/openai" مع إبقاء OPENAI_BASE_PATH عند v1/chat/completions. وفي كلتا الحالتين يذهب الطلب إلى عنوان URL لنقطة النهاية الموثّق https://api.qcode.cc/openai/v1/chat/completions.

كمزوّد مخصّص مسمّى¶

شغّل goose configure، ثم اختر Custom Providers، ثم Add A Custom Provider (يقرأ سطر القائمة «Add a new OpenAI/Anthropic/Ollama compatible Provider»):

يقرأ المزوّد مفتاحه من متغير البيئة الذي عيّنته له. وبحسب الصياغة الرسمية، «ثم استخدم api_key_env لتعيين مفتاح جلستك»، مع المثال الموثّق:

export CUSTOM_CORP_API_API_KEY="your-api-key"
goose session start --provider custom_corp_api

استخدم اسم المزوّد ومتغير المفتاح الخاصين بك بدلًا من custom_corp_api / CUSTOM_CORP_API_API_KEY. إذا كنت تفضّل كتابة ملف JSON بنفسك، فسيوضع في macOS/Linux: ~/.config/goose/custom_providers/. لاحظ أمرين: «يجب أن تستخدم المزوّدات المخصّصة تنسيقات API متوافقة مع OpenAI أو Anthropic أو Ollama.» ولا تعرض الأمثلة الرسمية إلا "engine": "openai" — لا تنشر الوثائق أي قيمة للجانب الخاص بـ Anthropic، لذا أنشئ المزوّدات المخصّصة المتوافقة مع Anthropic عبر goose configure ودع goose يكتب ذلك السطر.

تشمل معرّفات النماذج الصينية على QCode كلًّا من deepseek-v4.1-flash، وdeepseek-v4-flash، وdeepseek-v4-pro، وglm-5.3، وglm-5.2، وqwen3.8-max، وqwen3.8-flash، وqwen3.7-plus، وkimi-k3 — راجع النماذج الصينية.

التحقق¶

goose info
goose run --provider anthropic --model claude-sonnet-5 -t "ping"

يرد في وصف goose info: «Shows goose information, including the version, configuration file location, session storage, and logs». وعند goose run، يظهر في وصف --provider: «Specify the provider to use for this session (overrides environment variable)»، وفي وصف --model: «Specify the model to use for this session (overrides environment variable)».

قبل أن تبدأ في تصحيح أخطاء goose نفسه، تأكد من نقطة النهاية:

KEY="cr_your_qcode_key"
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

يعني جسم JSON يحتوي على content أن جهة نقطة النهاية قد أجابت، وأن المشكلة المتبقية تقع في إعدادات goose. بُنيت هذه الصفحة من الوثائق الرسمية؛ لم يكن هناك مفتاح اختبار، لذلك لم يُقَس أي طلب هنا على QCode.

استكشاف الأخطاء وإصلاحها / القيود المعروفة¶

الفوترة حسب token؛ وتُدرَج أسعار كل نموذج على https://qcode.cc/models

مواضيع ذات صلة¶

• نقاط النهاية ومسارات API — البروتوكول × عائلة النموذج
• توافق الأدوات — أي الأدوات تستخدم أي بروتوكول
• إعداد OpenCode — وكيل طرفية آخر على نقطتي النهاية نفسيهما
• إعداد Crush — الزوج نفسه من المزوّدين، مع ملف إعدادات JSON بدلًا من معالج
• تكامل Aider — نقطتا النهاية أيضًا، ويُختار حسب اسم النموذج
• اختيار النموذج
• النماذج الصينية

المؤسسات ←