استخدم Codex مع CometAPI

استخدم هذا الدليل لتشغيل Codex مع CometAPI كمزوّد نماذج. المراجع الرسمية:

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

المتطلب	التفاصيل
نظام التشغيل	macOS وLinux وWindows PowerShell الأصلي أو Windows مع WSL
Git	يُوصى بالإصدار 2.23+
Codex	ثبّت تطبيق Codex أو Codex CLI من البدء السريع لـ Codex
مفتاح CometAPI API	احصل عليه من لوحة تحكم CometAPI
model ID	استخدم model ID من صفحة النماذج

اختر مسار الإعداد

نوفّر خيارين لمساعدتك على تهيئة Codex بسرعة.

الخيار 1: تهيئة Codex يدويًا (موصى به)

عدّل ملف ~/.codex/config.toml على مستوى المستخدم مباشرةً. هذا هو المسار الأكثر موثوقية، خاصةً لمستخدمي Windows وWSL.

الخيار 2: التهيئة عبر سكربت

شغّل سكربت الإعداد كاختصار. يكتب إعدادات المزوّد نفسها ويخزّن مفتاح CometAPI API لصالح Codex.

تهيئة Codex يدويًا

يقرأ Codex إعدادات المزوّد الافتراضية الشخصية من ملف ~/.codex/config.toml على مستوى المستخدم. قم بتهيئة مزوّد CometAPI هناك، وليس في ملف .codex/config.toml خاص بالمشروع. يتجاهل Codex إعدادات provider وprovider-auth في ملفات تهيئة المشروع. يستخدم الإعداد الموصى به مزوّدًا مُسمّى cometapi ومصادقة مدعومة بأمر. يحافظ ذلك على فصل CometAPI عن مزوّد OpenAI المدمج، ولا يتطلب توريث متغيرات بيئة shell، ولا يستبدل ~/.codex/auth.json.

macOS / Linux / WSL
Windows PowerShell

خزّن مفتاح CometAPI API في ملف مفتاح محلي:

mkdir -p "$HOME/.codex"
printf "%s\n" "$COMETAPI_KEY" > "$HOME/.codex/cometapi_key"
chmod 600 "$HOME/.codex/cometapi_key"

أضف هذا الإعداد إلى ~/.codex/config.toml:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"

[model_providers.cometapi.auth]
command = "sh"
args = ["-c", "cat \"$HOME/.codex/cometapi_key\""]

خزّن مفتاح CometAPI API في الدليل الرئيسي لـ Codex على Windows:

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Content -NoNewline -Path "$HOME\.codex\cometapi_key" -Value $env:COMETAPI_KEY

أضف هذا الإعداد إلى $HOME\.codex\config.toml:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"

[model_providers.cometapi.auth]
command = "powershell.exe"
args = [
  "-NoProfile",
  "-Command",
  "$p=Join-Path $HOME '.codex/cometapi_key'; (Get-Content -Raw $p).Trim()",
]

يستخدم Codex الأصلي على Windows المسار $HOME\.codex، والذي يكون عادةً C:\Users\<user>\.codex. أما WSL فيستخدم ~/.codex الخاص بتوزيعة Linux. عدّل الدليل المطابق للبيئة التي يعمل فيها وكيل Codex.

استخدام المصادقة عبر متغير البيئة

إذا كنت تفضل الاحتفاظ بمفتاح CometAPI API في متغير بيئة، فاستخدم env_key بدلًا من كتلة [model_providers.cometapi.auth]. استخدم إعداد المزوّد هذا فقط عندما يكون COMETAPI_KEY متاحًا في البيئة التي تُشغّل Codex:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"
env_key = "COMETAPI_KEY"

لا تجمع بين env_key و[model_providers.cometapi.auth]. يدعم Codex طريقة مصادقة واحدة لكل مزوّد مخصص.

شغّل سكربت الإعداد

سكربت الإعداد اختياري. وهو يكتب إعدادات مزوّد cometapi نفسها إلى ~/.codex/config.toml، ويخزّن مفتاح CometAPI API الخاص بك في ~/.codex/cometapi_key، وينشئ نسخًا احتياطية قبل تغيير الملفات، ويتحقق من الإعداد باستخدام codex exec عندما تكون أداة Codex CLI متاحة. لنظام macOS أو Linux أو WSL، شغّل المُثبّت التفاعلي:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh)"

للإعداد غير التفاعلي، مرّر مفتاح API بشكل صريح:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY"

بالنسبة إلى Windows PowerShell الأصلي، شغّل المُثبّت التفاعلي:

powershell -c "irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1' | iex"

لإعداد Windows غير التفاعلي، مرّر مفتاح API بشكل صريح:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY"

بشكل افتراضي، لا يستبدل السكربت ~/.codex/auth.json ولا يزيل تسجيل دخول ChatGPT. استخدم --force-auth-json أو -ForceAuthJson فقط إذا كنت تريد أن يدير السكربت تسجيل الدخول بمفتاح API في Codex من خلال auth.json.

اختر أو غيّر model ID

استخدم model ID من صفحة Models. في الإعداد اليدوي، غيّر قيمة model في ~/.codex/config.toml. لنظام macOS أو Linux أو WSL، مرّر --model عند تشغيل سكربت الإعداد:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY" --model your-model-id

بالنسبة إلى Windows PowerShell الأصلي، مرّر -Model عند تشغيل سكربت الإعداد:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY -Model 'your-model-id'"

يستخدم السكربت CODEX_HOME عندما يكون مضبوطًا. وإلا فإنه يكتب إلى ~/.codex الخاص بالبيئة الحالية.

تحقّق من الإعداد

للتحقق من الإعداد باستخدام Codex CLI، شغّل هذا الأمر للقراءة فقط من أي مشروع محلي:

codex exec --ephemeral --skip-git-repo-check --sandbox read-only --color never "Reply exactly with: COMETAPI_CODEX_OK"

إذا لم تكن أداة Codex CLI متاحة في PATH، فافتح تطبيق Codex وأرسل Prompt قصيرًا من مشروع محلي.

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

لا يزال Codex يستخدم موفّر OpenAI الافتراضي

تأكد من أن model_provider = "cometapi" موجود في ملف ~/.codex/config.toml على مستوى المستخدم.

تم تغيير مفتاح API

حدّث ~/.codex/cometapi_key، أو أعد تشغيل سكربت الإعداد باستخدام قيمة $COMETAPI_KEY المحدّثة.

يفشل سكربت PowerShell أثناء فحوصات ما قبل التشغيل

استخدم خطوات PowerShell الأصلية اليدوية الخاصة بـ Windows، ثم شغّل أمر التحقق.

إعداد shell الممرَّر عبر pipe لا يطلب أي مفتاح API

استخدم --key "$COMETAPI_KEY"، أو عيّن COMETAPI_KEY، أو شغّل الأمر التفاعلي sh -c "$(curl ...)".

تنتهي مهلة الاتصال أو يتم استخدام base URL خاطئ

تأكد من أن base_url هو https://api.cometapi.com/v1 في ~/.codex/config.toml.

لم يتم العثور على النموذج

راجع صفحة Models لمعرفة model IDs المتاحة.

يؤثر إعداد Windows على البيئة الخاطئة

عدّل $HOME\.codex لوضع Windows الأصلي، أو عدّل ~/.codex داخل WSL لوضع وكيل WSL.

تم تغيير تسجيل دخول ChatGPT

لا تستخدم --force-auth-json أو -ForceAuthJson إلا إذا كنت تريد وضع تسجيل الدخول بمفتاح API.

نظرة عامة

وكلاء البرمجة بالذكاء الاصطناعي

وكلاء الذكاء الاصطناعي

عملاء دردشة الذكاء الاصطناعي

الترجمة واللغة

منصات الأتمتة

المراقبة والتقييم

أطر عمل الذكاء الاصطناعي

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

اختر مسار الإعداد

الخيار 1: تهيئة Codex يدويًا (موصى به)

الخيار 2: التهيئة عبر سكربت

تهيئة Codex يدويًا

استخدام المصادقة عبر متغير البيئة

شغّل سكربت الإعداد

اختر أو غيّر model ID

تحقّق من الإعداد

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

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

​اختر مسار الإعداد

الخيار 1: تهيئة Codex يدويًا (موصى به)

الخيار 2: التهيئة عبر سكربت

​تهيئة Codex يدويًا

​استخدام المصادقة عبر متغير البيئة

​شغّل سكربت الإعداد

​اختر أو غيّر model ID

​تحقّق من الإعداد

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

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

اختر مسار الإعداد

تهيئة Codex يدويًا

استخدام المصادقة عبر متغير البيئة

شغّل سكربت الإعداد

اختر أو غيّر model ID

تحقّق من الإعداد

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