CLI कोडिङ टुलहरू

कोडिङ टुललाई Shannon सँग चलाउन तीन सेटिङ चाहिन्छ: API को बेस URL, तपाईंको API की, र Shannon मोडल id। यो पेजले Claude Code र Codex CLI का ठ्याक्कै सेटिङ दिन्छ, कोडिङ मोडल shannon-coder-1 कसरी गणना गरिन्छ भनेर बताउँछ, र यी टुलहरूले भेट्ने त्रुटिहरू सूचीबद्ध गर्छ।

हरेक टुलले कुन इन्डपोइन्ट प्रयोग गर्छ

तीनवटै इन्डपोइन्टले उही API की लिन्छन्, Authorization: Bearer वा x-api-key का रूपमा। यी टुलहरूले पठाउने anthropic-version, anthropic-beta र openai-beta हेडरहरू स्वीकार गरिन्छन्।

Shannon मोडल छान्नुहोस्

हरेक अनुरोधमा Shannon ले प्रकाशित गरेको मोडल id को नाम हुनैपर्छ। तपाईंले अर्को नभनेसम्म कोडिङ टुलले आफ्नै पूर्वनिर्धारित मोडलको नाम पठाउँछ, र Shannon ले प्रकाशित नगरेको नामलाई 400 र unknown model: <name> सन्देशले जवाफ दिइन्छ। अरू कुनै नाम Shannon मोडलमा म्याप गरिँदैन, त्यसैले पहिलो अनुरोध अघि टुलमा मोडल सेट गर्नुहोस्।

GET /v1/models ले हरेक id लाई त्यसको कन्टेक्स्ट विन्डोसहित सूचीबद्ध गर्छ। यसलाई की चाहिँदैन। मोडल र मूल्य

कोडिङ टुलहरूले लामो सिस्टम प्रम्प्टबाट मोडललाई निर्देशित गर्छन्। सिस्टम प्रम्प्ट shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro र होस्ट गरिएका ओपन-वेट मोडलहरूले लागू गर्छन्, त्यसैले कोडिङ टुलका लागि यीमध्ये एउटा छान्नुहोस्।

Claude Code

Claude Code ले आफ्नो कनेक्सन environment variable बाट पढ्छ। तिनलाई यसलाई सुरु गर्ने शेलमा सेट गर्नुहोस्, वा हरेक सेसनका लागि राख्न ~/.claude/settings.json को env ब्लकमा।

# 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 id मा रूपान्तरण हुनुपर्छ।
• नमूनाले ब्याकग्राउन्ड अनुरोधहरूलाई shannon-1.6-lite तर्फ देखाउँछ, जुन टोकनमा गणना गरिन्छ। त्यसपछि सेसन शीर्षक र यस्तै अनुरोधहरूले Coder कल प्रयोग गर्दैनन्।
• Claude Code ले कन्टेक्स्टको साइजका लागि POST /v1/messages/count_tokens सोध्छ। इन्डपोइन्टले होस्ट गरिएका ओपन-वेट मोडलहरूका लागि गणना गर्छ। Shannon id सँग यसले 400 ले जवाफ दिन्छ; Claude Code ले टोकन गणनालाई ऐच्छिक मान्छ र साइज आफैं अनुमान गर्छ। टोकन गणना

टुल सुरु गर्नु अघि ठेगाना, की र मोडल id जाँच्न एउटा अनुरोध हातैले पठाउनुहोस्:

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 सँग कुरा गर्छ। ~/.codex/config.toml मा Shannon लाई मोडल प्रोभाइडरका रूपमा वर्णन गर्नुहोस्, त्यहाँ एउटा Shannon मोडल id छान्नुहोस्, र आफ्नो API की प्रोभाइडरले नाम दिएको environment variable मा राख्नुहोस्।

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 कलमा होइन, तपाईंको ब्यालेन्सबाट टोकनमा गणना गरिन्छ।

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 टोकनको कन्टेक्स्ट विन्डो, टुल कल, रिजनिङ र टेक्स्ट इनपुटसहित रिपोर्ट गर्छ। टुलले प्रयोग गर्ने इन्डपोइन्ट अनुसार यसलाई दुई तरिकामध्ये एकले गणना गरिन्छ।

कल भनेको एउटा अनुरोध हो, यसको साइज जेसुकै होस्। अनुरोध स्वीकार हुँदा, मोडलले जवाफ दिनु अघि यसलाई गणना गरिन्छ। एजेन्ट सेसनले आफ्नो हरेक चरणका लागि एउटा अनुरोध पठाउँछ, त्यसैले लामो कामले धेरै कल प्रयोग गर्छ। भत्ता तपाईंको प्लानमा निर्भर हुन्छ र हरेक 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"}

एजेन्ट लुपले केमा भरोसा गर्न सक्छ

समस्या निवारण

तपाईंको की र ब्यालेन्स Keys & usage पेजमा छन्। की र प्रयोग