وكلاء ونماذج CodeRouter

توضح هذه الصفحة كيف يصل كل وكيل إلى CodeRouter على جهاز Mac وعلى جهاز cmux Cloud، وكيف يختار كل وكيل نموذجاً.

على جهاز Mac

يبدأ cr الوكيل الذي ثبّته مسبقاً ويوجّهه إلى CodeRouter لذلك التشغيل. يجب أن يكون الوكيل في PATH لديك. كل ما يلي اسم الوكيل يُمرَّر دون تغيير.

Codex

يشغّل cr codex برنامج Codex مع مزوّد نماذج CodeRouter. تعمل الأوامر الفرعية مثل exec وreview وresume بالطريقة نفسها. يشغّل cr naked برنامج Codex العادي متجاوزاً CodeRouter.

cr codex
cr codex exec "fix the failing test"
cr codex -m <model>
cr naked

OpenCode

يحمّل cr opencode نماذج حسابات OpenCode Go الخاصة بفريقك ويستخدم أولها ما لم تمرّر --model. يجب أن تكون قيمة --model أحد تلك النماذج؛ شغّل opencode العادي لأي مزوّد آخر.

cr opencode
cr opencode --model <model>

Pi

يضيف cr pi مزوّد coderouter إلى Pi بالنماذج نفسها التي يستخدمها Codex، ويستخدم النموذج الأول ما لم تمرّر --model. المزوّد ثابت، لذا يُرفض --provider. دعم Pi تجريبي.

cr pi
cr pi --model <model>

Claude Code وعملاء API الآخرون

لا يحتوي cr على مشغّل لـ Claude Code. لتوجيه Claude Code على جهاز Mac، أو أي أداة تستخدم Anthropic Messages API أو OpenAI Responses API، أنشئ مفتاح CodeRouter API ووجّه الأداة إلى coderouter.dev.

أنشئ مفتاحاً في قسم مفاتيح API في لوحة تحكم CodeRouter. يبدأ المفتاح بـ crk_ ويُعرض مرة واحدة. يتطلب إنشاء مفتاح أو إلغاؤه إذناً بإدارة مفاتيح API في ذلك الفريق، وهو إذن تملكه دائماً في فريقك الشخصي: cmux.com/dashboard/coderouter

# Claude Code and Anthropic Messages API clients
export ANTHROPIC_BASE_URL=https://coderouter.dev
export ANTHROPIC_API_KEY=crk_...
claude

# OpenAI Responses API clients
export OPENAI_BASE_URL=https://coderouter.dev/v1
export OPENAI_API_KEY=crk_...

يستخدم مفتاح API الخاص بالمؤسسة حسابات الفريق المشتركة فقط. يمكن للمفتاح في فريقك الشخصي أن يستخدم حساباتك الخاصة أيضاً. يخدم CodeRouter واجهة OpenAI Responses API، لا Chat Completions.

على جهاز لا يستطيع فتح متصفح، يسجّل cr login --api-key دخول cr بمفتاح، ويوفّر CODEROUTER_API_KEY مفتاحاً لأمر واحد. ألغِ المفتاح من لوحة التحكم، أو شغّل cr logout على الجهاز الذي يستخدمه.

cr login --api-key <key>
CODEROUTER_API_KEY=<key> cr codex exec "run the tests"

على أجهزة cmux Cloud

لا تحتاج أجهزة Cloud إلى إعداد. يستخدم كل وكيل حسابات CodeRouter الخاصة بفريقك عبر عنوان CodeRouter خاص، ويكتب cmux إعداداته في أول مرة تبدأ فيها صدفة أو يبدأ الوكيل:

• يحصل Claude Code على ANTHROPIC_BASE_URL وقيمة بديلة لـ ANTHROPIC_API_KEY في كل مرة يبدأ فيها، وليس من كل صدفة، لذا لا تتقدّم أبداً على تسجيل دخولك الخاص. مطالبات التشغيل الأول مُجاب عنها مسبقاً.
• يحصل Codex على مزوّد نماذج cmux في ~/.codex/config.toml.
• يحصل Pi على تجاوز للمزوّد في ~/.pi/agent/models.json.
• ينزّل OpenCode قائمة مزوّديه من CodeRouter في أول تشغيل، ويحفظها في ~/.config/cmux/opencode-team.json، ويضيفها إلى إعداداتك الخاصة في كل تشغيل.

يكتب cmux كل ملف فقط عندما يكون مفقوداً، لذا تُحفظ تعديلاتك. لا يُغيَّر إعداد Codex الذي يحدد مزوّد نماذج آخر.

لاستخدام حسابك الخاص بدلاً من ذلك، شغّل cr use own على الجهاز، ثم سجّل الدخول بالطريقة المعتادة للوكيل: /login في Claude Code، أو codex login، أو opencode auth login. يعيدك cr use team إلى حسابات الفريق، ويغيّر cr use own codex وكيلاً واحداً، ويعرض cr use طريقة تسجيل دخول كل وكيل. إن لم تختر، يستخدم الوكيل الذي سجّلت الدخول إليه على الجهاز حسابك الخاص، ويعرض الوكيل الذي لا يملك فريقك حساباً له تسجيل الدخول المعتاد. يُطبَّق التغيير في المرة التالية التي يبدأ فيها الوكيل.

شغّل الوكلاء كالمعتاد. يحوّل cmux coderouter agent الموجّه المجرد إلى صيغة التشغيل لمرة واحدة الخاصة بالوكيل؛ داخل الجهاز يعمل في الطرفية الحالية، وعلى جهاز Mac يبدأ الوكيل على الجهاز الذي تسمّيه، مثل cmux vm agent.

# Inside a Cloud machine
claude
codex
cmux coderouter agent claude "summarize the current checkout"

# From your Mac
cmux coderouter agent codex --machine brave-otter -- "run the tests"

تستخدم أجهزة Cloud حسابات الفريق الذي يملكها. إذا أبلغ وكيل بعدم توفر أي حساب، فأضف حساباً أو شارك حساباً موجوداً مع ذلك الفريق.

النماذج

يستخدم Codex وPi كتالوج نماذج الحساب الذي يختاره CodeRouter، والمتاح على /v1/models، لذا يعرض منتقي النماذج في Codex ما تستطيع حساباتك استخدامه. اختر نموذجاً باستخدام الخيار -m في Codex أو أمر /model. بالنسبة لمفتاح OpenRouter، يرسل CodeRouter معرّف نموذج OpenAI المجرد بصيغة openai/<model>.

يعرض OpenCode نماذج حسابات OpenCode Go الخاصة بالفريق.

يرسل Claude Code النموذج الذي تختاره بـ --model أو /model، ويمرّره CodeRouter إلى الحساب المختار. تخدم حسابات الاشتراك ومفاتيح API النماذج التي تسمح بها Anthropic لذلك الحساب.

تحوّل حسابات Bedrock معرّفات نماذج Claude إلى معرّفات نماذج Bedrock بجدول مدمج، وتمر معرّفات Bedrock دون تغيير. النموذج الذي ليس له تعيين يعيد not_found_error. لتعيين نموذج آخر، أضف الحساب مع --model:

cmux coderouter claude add bedrock --region us-east-1 \
  --model <claude-model-id>=<bedrock-model-id>

داخل جهاز Cloud، يطبع cmux coderouter models كتالوج نماذج Codex بصيغة JSON.

# Inside a Cloud machine
cmux coderouter models