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 ని దాని కాంటెక్స్ట్ విండోతో జాబితా చేస్తుంది. దీనికి కీ అవసరం లేదు. మోడల్స్ & ధరలు

కోడింగ్ టూల్స్ పొడవైన system prompt తో మోడల్‌ను నడిపిస్తాయి. system prompt ను shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro మరియు హోస్ట్ చేసిన ఓపెన్-వెయిట్ మోడల్స్ వర్తింపజేస్తాయి, కాబట్టి కోడింగ్ టూల్ కోసం వీటిలో ఒకదాన్ని ఎంచుకోండి.

Claude Code

Claude Code తన కనెక్షన్‌ను ఎన్విరాన్‌మెంట్ వేరియబుల్స్ నుండి చదువుతుంది. వాటిని దాన్ని ప్రారంభించే షెల్‌లో సెట్ చేయండి, లేదా ప్రతి సెషన్‌కు ఉంచడానికి ~/.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 వైపు చూపిస్తుంది, అది tokens లో లెక్కించబడుతుంది. అప్పుడు సెషన్ శీర్షికలు మరియు అలాంటి రిక్వెస్ట్‌లు Coder కాల్స్‌ను ఉపయోగించవు.
• Claude Code కాంటెక్స్ట్ పరిమాణం కోసం POST /v1/messages/count_tokens ను అడుగుతుంది. ఈ ఎండ్‌పాయింట్ హోస్ట్ చేసిన ఓపెన్-వెయిట్ మోడల్స్‌కు లెక్కిస్తుంది. Shannon id తో ఇది 400 తో సమాధానం ఇస్తుంది; Claude Code tokens లెక్కింపును ఐచ్ఛికంగా పరిగణించి పరిమాణాన్ని తానే అంచనా వేసుకుంటుంది. Token లెక్కింపు

టూల్‌ను ప్రారంభించే ముందు చిరునామా, కీ మరియు మోడల్ 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 కీని ఉంచండి.

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 కాల్స్‌లో కాకుండా మీ బ్యాలెన్స్ నుండి tokens లో లెక్కించబడుతుంది.

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 tokens కాంటెక్స్ట్ విండో, టూల్ కాల్స్, రీజనింగ్ మరియు టెక్స్ట్ ఇన్‌పుట్‌తో నివేదిస్తుంది. టూల్ ఉపయోగించే ఎండ్‌పాయింట్‌ను బట్టి ఇది రెండు విధాలలో ఒకదానిలో లెక్కించబడుతుంది.

కాల్ అంటే ఒక రిక్వెస్ట్, దాని పరిమాణం ఏదైనా. రిక్వెస్ట్ అంగీకరించబడినప్పుడు, మోడల్ సమాధానం ఇచ్చే ముందే, అది లెక్కించబడుతుంది. ఏజెంట్ సెషన్ తీసుకునే ప్రతి అడుగుకు ఒక రిక్వెస్ట్ పంపుతుంది, కాబట్టి సుదీర్ఘ పని చాలా కాల్స్‌ను వాడుకుంటుంది. అలౌన్స్ మీ ప్లాన్‌ను బట్టి ఉంటుంది మరియు ప్రతి 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, type invalid_request_error, code 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 పేజీలో ఉన్నాయి. Keys & usage