أدوات البرمجة بسطر الأوامر

تحتاج أداة البرمجة إلى ثلاثة إعدادات لتعمل مع Shannon: عنوان base URL لـ API، ومفتاح API الخاص بك، ومعرّف نموذج Shannon. تعطي هذه الصفحة الإعدادات الدقيقة لـ Claude Code وCodex CLI، وتشرح كيف يُحتسب نموذج البرمجة shannon-coder-1، وتسرد الأخطاء التي تصادفها هذه الأدوات.

نقطة النهاية التي تستخدمها كل أداة

تقبل نقاط النهاية الثلاث مفتاح API نفسه، بصيغة Authorization: Bearer أو x-api-key. وتُقبل الترويسات anthropic-version وanthropic-beta وopenai-beta التي ترسلها هذه الأدوات.

اختيار نموذج Shannon

يجب أن يسمّي كل طلب معرّف نموذج تنشره Shannon. ترسل أداة البرمجة اسم نموذجها الافتراضي الخاص ما لم تخبرها بغير ذلك، والاسم الذي لا تنشره Shannon يُجاب عنه بـ 400 والرسالة unknown model: <name>. لا يُربط أي اسم آخر بنموذج Shannon، لذا اضبط النموذج في الأداة قبل الطلب الأول.

يسرد GET /v1/models كل معرّف مع نافذة سياقه. ولا يحتاج مفتاحاً. النماذج والأسعار

توجّه أدوات البرمجة النموذج بتوجيهات نظام طويلة. تطبّق توجيهات النظام النماذج shannon-coder-1 وshannon-1.6-lite وshannon-1.6-pro وshannon-2-lite وshannon-2-pro والنماذج المفتوحة الأوزان المستضافة، لذا اختر واحداً منها لأداة البرمجة.

Claude Code

يقرأ Claude Code اتصاله من متغيرات البيئة. اضبطها في الصدفة (shell) التي تشغّله، أو في الكتلة env من ~/.claude/settings.json لإبقائها في كل جلسة.

# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Where to send requests, and your Shannon API key
export ANTHROPIC_BASE_URL=https://api.shannon-ai.com
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY

# Shannon model ids: the session model, and the model behind each built-in name
export ANTHROPIC_MODEL=shannon-coder-1
export ANTHROPIC_DEFAULT_OPUS_MODEL=shannon-coder-1
export ANTHROPIC_DEFAULT_SONNET_MODEL=shannon-coder-1
export ANTHROPIC_DEFAULT_HAIKU_MODEL=shannon-1.6-lite

# The context window of the session model
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=131072

claude

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.shannon-ai.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "shannon-coder-1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "shannon-coder-1",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "shannon-coder-1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "shannon-1.6-lite",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "131072"
  }
}

• اضبط المتغيرات الثلاثة ANTHROPIC_DEFAULT_…_MODEL كلها. تطلب الوكلاء الفرعيون وبعض الأوامر نموذجاً باسمه المضمّن، ويجب أن يُحل كل اسم إلى معرّف Shannon.
• يوجّه المثال طلبات الخلفية إلى shannon-1.6-lite، وهو يُحتسب بالـ tokens. فلا تستهلك عناوين الجلسات والطلبات المشابهة استدعاءات Coder.
• يسأل Claude Code الخدمة POST /v1/messages/count_tokens عن حجم السياق. تحسب نقطة النهاية للنماذج المفتوحة الأوزان المستضافة. ومع معرّف Shannon تجيب بـ 400؛ ويعتبر Claude Code عدّ tokens اختيارياً ويقدّر الحجم بنفسه. عدّ الـ tokens

للتحقق من العنوان والمفتاح ومعرّف النموذج قبل تشغيل الأداة، أرسل طلباً واحداً يدوياً:

curl https://api.shannon-ai.com/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shannon-1.6-lite",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "Say OK."}]
  }'

Codex CLI

يتحدث Codex CLI إلى Responses API. صِف Shannon كمزوّد نماذج في ~/.codex/config.toml، واختر هناك معرّف نموذج Shannon، وضع مفتاح API في متغير البيئة الذي يسميه المزوّد.

model = "shannon-coder-1"
model_provider = "shannon"
model_context_window = 131072

[model_providers.shannon]
name = "Shannon"
base_url = "https://api.shannon-ai.com/v1"
env_key = "SHANNON_API_KEY"
wire_api = "responses"

# Install Codex CLI
npm install -g @openai/codex

# Your Shannon API key, under the name given as env_key
export SHANNON_API_KEY=YOUR_API_KEY

# Start it; --model selects another Shannon id for one run
codex
codex --model shannon-1.6-pro

• لا يحتفظ /v1/responses بأي محادثة على الخادم: كل طلب يحمل المحادثة في input. ويُقبل previous_response_id للتوافق.
• تُعرض أدوات الدوال (type: "function") على النموذج في /v1/responses.
• على /v1/responses يُحتسب shannon-coder-1 بالـ tokens من رصيدك، لا باستدعاءات Coder.

الفحص نفسه لنقطة نهاية Responses:

curl https://api.shannon-ai.com/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shannon-1.6-lite",
    "input": "Say OK."
  }'

نموذج البرمجة وطريقة احتسابه

shannon-coder-1 هو نموذج Shannon لوكلاء البرمجة. يعرضه GET /v1/models بنافذة سياق من 131,072 token ومع استدعاءات الأدوات والاستدلال وإدخال النص. ويُحتسب بإحدى طريقتين، بحسب نقطة النهاية التي تستخدمها الأداة.

الاستدعاء هو طلب واحد، مهما كان حجمه. ويُحتسب عند قبول الطلب، قبل أن يجيب النموذج. ترسل جلسة الوكيل طلباً واحداً لكل خطوة تتخذها، لذا تستهلك المهمة الطويلة استدعاءات كثيرة. وتعتمد الحصة على خطتك وتبدأ من جديد كل 4 ساعات، عند 00:00 و04:00 و08:00 و12:00 و16:00 و20:00 UTC.

تعرض صفحة الخطط الأرقام الحالية. الخطط

عند استنفاد استدعاءات نافذة ما، يُجاب عن الطلب بـ 429. وعلى /v1/messages يأتي الخطأ نفسه بشكل Anthropic.

{
  "error": {
    "type": "rate_limit_error",
    "message": "Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan"
  }
}

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan"
  }
}

تجاوز السياق

عندما تكون المحادثة أكبر من نافذة سياق النموذج، يجيب /v1/chat/completions و/v1/messages بـ 400 والنوع invalid_request_error والرمز context_length_exceeded ورسالة تبدأ بـ prompt is too long. تقرأ أدوات البرمجة هذا الخطأ لضغط الجلسة وإعادة إرسال الطلب. وتنتجه النماذج shannon-coder-1 وshannon-1.6-lite وshannon-1.6-pro.

{
  "error": {
    "type": "invalid_request_error",
    "code": "context_length_exceeded",
    "message": "prompt is too long: 140211 tokens > 131072 maximum",
    "param": null
  }
}

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "code": "context_length_exceeded",
    "message": "prompt is too long: 140211 tokens > 131072 maximum",
    "param": null
  }
}

الرسالة هي prompt is too long: <sent> tokens > <limit> maximum. وعندما لا يُعرف الرقمان تكون prompt is too long. Please compact the conversation and try again.

في البث تكون الحالة 200 بالفعل، لذا يصل الخطأ كحدث ثم يُغلق البث بالطريقة المعتادة:

data: {"error":{"message":"prompt is too long: 140211 tokens > 131072 maximum","type":"invalid_request_error","code":"context_length_exceeded","param":null}}

data: {"id":"chatcmpl-…","object":"chat.completion.chunk","created":…,"model":"shannon-coder-1","choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"usage":{…}}

data: [DONE]

event: error
data: {"type":"error","error":{"type":"invalid_request_error","message":"prompt is too long: 140211 tokens > 131072 maximum"}}

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{…}}

event: message_stop
data: {"type":"message_stop"}

ما يمكن أن تعتمد عليه حلقة الوكيل

استكشاف الأخطاء

مفتاحك ورصيدك في صفحة المفاتيح والاستخدام. المفاتيح والاستخدام