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 आणि होस्ट केलेली open-weight मॉडेल्स लागू करतात, म्हणून कोडिंग टूलसाठी यांपैकी एक निवडा.

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 ला विचारतो. हा एंडपॉइंट होस्ट केलेल्या open-weight मॉडेल्ससाठी मोजतो. 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 पानावर आहेत. की आणि वापर