CLI कोडिंग टूल्स

Shannon के साथ काम करने के लिए कोडिंग टूल को तीन सेटिंग चाहिए: API का बेस URL, आपकी API key और एक Shannon मॉडल id। यह पेज Claude Code और Codex CLI की सटीक सेटिंग देता है, बताता है कि कोडिंग मॉडल shannon-coder-1 कैसे गिना जाता है, और वे त्रुटियाँ सूचीबद्ध करता है जो इन टूल को मिलती हैं।

कौन सा टूल कौन सा endpoint उपयोग करता है

तीनों endpoints एक ही API key लेते हैं, Authorization: Bearer के रूप में या x-api-key के रूप में। ये टूल जो हेडर anthropic-version, anthropic-beta और openai-beta भेजते हैं वे स्वीकार किए जाते हैं।

Shannon मॉडल चुनें

हर अनुरोध में ऐसा मॉडल id होना चाहिए जिसे Shannon प्रकाशित करता है। कोडिंग टूल अपने डिफ़ॉल्ट मॉडल का नाम भेजता है जब तक आप उसे कुछ और न बताएँ, और जो नाम Shannon प्रकाशित नहीं करता उसका उत्तर 400 और संदेश unknown model: <name> से दिया जाता है। किसी और नाम को Shannon मॉडल से मैप नहीं किया जाता, इसलिए पहले अनुरोध से पहले टूल में मॉडल सेट करें।

GET /v1/models हर id को उसकी कॉन्टेक्स्ट विंडो के साथ सूचीबद्ध करता है। इसे key की ज़रूरत नहीं। मॉडल और कीमतें

कोडिंग टूल लंबे सिस्टम प्रॉम्प्ट से मॉडल को दिशा देते हैं। सिस्टम प्रॉम्प्ट को shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro और होस्टेड ओपन-वेट मॉडल लागू करते हैं, इसलिए कोडिंग टूल के लिए इनमें से कोई एक चुनें।

Claude Code

Claude Code अपना कनेक्शन environment variables से पढ़ता है। उन्हें उस शेल में सेट करें जो इसे शुरू करता है, या हर सेशन के लिए रखने हेतु ~/.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 से पूछता है। यह endpoint होस्टेड ओपन-वेट मॉडल के लिए गिनता है। Shannon id के साथ यह 400 देता है; Claude Code टोकन गिनती को वैकल्पिक मानता है और आकार का अनुमान खुद लगा लेता है। टोकन गिनती

टूल शुरू करने से पहले पता, key और मॉडल 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 key उस 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 endpoint के लिए भी यही जाँच हाथ से करें:

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 टोकन की कॉन्टेक्स्ट विंडो, टूल कॉल, रीज़निंग और टेक्स्ट इनपुट के साथ बताता है। यह दो में से एक तरीके से गिना जाता है, इस पर निर्भर करता है कि टूल कौन सा 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. होता है।

स्ट्रीम पर स्टेटस पहले से 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"}

एजेंट लूप किन बातों पर भरोसा कर सकता है

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

आपकी key और आपका बैलेंस Keys & usage पेज पर हैं। Keys और उपयोग