כלי קידוד ב-CLI

כלי קידוד צריך שלוש הגדרות כדי לעבוד עם Shannon: כתובת הבסיס של ה-API, מפתח ה-API שלכם ומזהה מודל של Shannon. הדף הזה נותן את ההגדרות המדויקות ל-Claude Code ול-Codex CLI, מסביר איך מודל הקידוד shannon-coder-1 נספר, ומפרט את השגיאות שהכלים האלה פוגשים.

באיזה endpoint כל כלי משתמש

שלושת ה-endpoints מקבלים את אותו מפתח API, כ-Authorization: Bearer או כ-x-api-key. הכותרות anthropic-version, anthropic-beta ו-openai-beta שהכלים האלה שולחים מתקבלות.

בחירת מודל Shannon

כל בקשה חייבת לציין מזהה מודל ש-Shannon מפרסם. כלי קידוד שולח את שם מודל ברירת המחדל שלו אלא אם אומרים לו אחרת, ושם ש-Shannon לא מפרסם נענה ב-400 ובהודעה unknown model: <name>. אף שם אחר אינו ממופה למודל של Shannon, ולכן הגדירו את המודל בכלי לפני הבקשה הראשונה.

GET /v1/models מפרט כל מזהה עם חלון ההקשר שלו. הוא אינו צריך מפתח. מודלים ותמחור

כלי קידוד מכוונים את המודל עם system prompt ארוך. ה-system prompt מיושם על ידי shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro ומודלי ה-open-weight המתארחים, ולכן בחרו אחד מהם עבור כלי קידוד.

Claude Code

Claude Code קורא את החיבור שלו ממשתני סביבה. הגדירו אותם במעטפת שמפעילה אותו, או בבלוק 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. Subagents וחלק מהפקודות מבקשים מודל לפי שמו המובנה, וכל שם חייב להיפתר למזהה של Shannon.
• בדוגמה בקשות הרקע מופנות ל-shannon-1.6-lite, שנספר בטוקנים. כותרות סשן ובקשות דומות אינן משתמשות אז בקריאות Coder.
• Claude Code שואל את POST /v1/messages/count_tokens מה גודל ההקשר. ה-endpoint סופר עבור מודלי ה-open-weight המתארחים. עם מזהה של Shannon הוא עונה 400; Claude Code רואה בספירת טוקנים דבר אופציונלי ומעריך את הגודל בעצמו. ספירת טוקנים

כדי לבדוק את הכתובת, המפתח ומזהה המודל לפני שמפעילים את הכלי, שלחו בקשה אחת ידנית:

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 נספר בטוקנים מהיתרה שלכם, לא בקריאות Coder.

אותה בדיקה עבור ה-endpoint של 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 טוקנים, קריאות לכלים, reasoning וקלט טקסט. הוא נספר באחת משתי דרכים, לפי ה-endpoint שהכלי משתמש בו.

קריאה היא בקשה אחת, בכל גודל. היא נספרת כשהבקשה מתקבלת, לפני שהמודל עונה. סשן של סוכן שולח בקשה אחת לכל צעד שהוא עושה, ולכן משימה ארוכה משתמשת בהרבה קריאות. המכסה תלויה בתוכנית שלכם ומתחדשת כל 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.

ב-stream הסטטוס כבר 200, ולכן השגיאה מגיעה כאירוע וה-stream נסגר אחר כך בדרך הרגילה:

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"}

על מה לולאת סוכן יכולה לסמוך

פתרון תקלות

המפתח והיתרה שלכם נמצאים בדף מפתחות ושימוש. מפתחות ושימוש