د CLI کوډ لیکلو وسیلې

کوډ لیکلو tool د Shannon سره د کار لپاره درې تنظیمات غواړي: د API base URL، ستاسو API کیلي، او د Shannon ماډل id. دا پاڼه د Claude Code او Codex CLI لپاره دقیق تنظیمات ورکوي، تشریح کوي چې د coding ماډل shannon-coder-1 څنګه شمیرل کیږي، او هغه تېروتنې لیست کوي چې دا tools ورسره مخ کیږي.

هر tool کوم endpoint کاروي

ټول درې endpoints هماغه API کیلي مني، د Authorization: Bearer یا x-api-key په توګه. هغه headers anthropic-version، anthropic-beta او openai-beta چې دا tools یې لیږي منل کیږي.

د Shannon ماډل وټاکئ

هره غوښتنه باید د ماډل id نوموي چې Shannon یې خپروي. د کوډ لیکلو tool خپل ډیفالټ ماډل نوم لیږي مګر دا چې تاسو ورته بل ووایئ، او هغه نوم چې Shannon یې نه خپروي په 400 او پیغام unknown model: <name> ځواب کیږي. هیڅ بل نوم د Shannon ماډل ته نه نقشه کیږي، نو مخکې له لومړۍ غوښتنې په tool کې ماډل وټاکئ.

GET /v1/models هر id د خپل context window سره لیست کوي. کیلي ته اړتیا نه لري. ماډلونه او بیې

د کوډ لیکلو tools ماډل په اوږد system prompt لارښوونه کوي. system prompt د shannon-coder-1، shannon-1.6-lite، shannon-1.6-pro، shannon-2-lite، shannon-2-pro او کوربه شوو open-weight ماډلونو لخوا پلي کیږي، نو د کوډ لیکلو tool لپاره له دې څخه یو وټاکئ.

Claude Code

Claude Code خپل اړیکه له environment variables څخه لولي. هغه په هغه shell کې وټاکئ چې دا پیلوي، یا په ~/.claude/settings.json کې د env block کې ترڅو د هر session لپاره پاتې شي.

# 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 id ته حل شي.
• نمونه د شالید غوښتنې shannon-1.6-lite ته اړوي، چې په ټوکنونو شمیرل کیږي. د session سرلیکونه او ورته غوښتنې بیا Coder calls نه کاروي.
• Claude Code د context د اندازې لپاره POST /v1/messages/count_tokens پوښتي. endpoint د کوربه شوو open-weight ماډلونو لپاره شمیري. د Shannon id سره دا 400 ځواب ورکوي؛ Claude Code د ټوکنونو شمېرنه اختیاري ګڼي او اندازه پخپله اټکل کوي. د ټوکنونو شمېرنه

د دې لپاره چې مخکې له tool پیلولو پته، کیلي او د ماډل 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 سره خبرې کوي. Shannon په ~/.codex/config.toml کې د model provider په توګه بیان کړئ، هلته د Shannon ماډل id وټاکئ، او خپله API کیلي په هغه environment variable کې ږدئ چې provider یې نوموي.

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 په server کې هیڅ ګفتګه نه ساتي: هره غوښتنه ګفتګه په input کې لیږدوي. previous_response_id د مطابقت لپاره منل کیږي.
• Function tools (type: "function") په /v1/responses کې ماډل ته وړاندې کیږي.
• په /v1/responses کې، shannon-coder-1 ستاسو له بیلانس څخه په ټوکنونو شمیرل کیږي، نه په Coder calls.

د 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."
  }'

د coding ماډل او دا څنګه شمیرل کیږي

shannon-coder-1 د coding agents لپاره د Shannon ماډل دی. GET /v1/models یې د 131,072 ټوکنونو context window، tool calls، reasoning او متن input سره راپور کوي. دا په یوه له دوو ډولونو شمیرل کیږي، د هغه endpoint پورې اړه لري چې tool یې کاروي.

Call یوه غوښتنه ده، هر اندازه چې وي. دا هغه وخت شمیرل کیږي کله چې غوښتنه ومنل شي، مخکې له دې چې ماډل ځواب ورکړي. د agent session د هر ګام لپاره یوه غوښتنه لیږي، نو اوږد کار ډیر calls کاروي. اجازه ستاسو د پلان پورې اړه لري او هر 4 ساعته بیا پیلیږي، په 00:00، 04:00، 08:00، 12:00، 16:00 او 20:00 UTC کې.

د پلان پاڼه اوسني شمیرې ښيي. پلانونه

کله چې د یوې کړکۍ calls ختم شي، غوښتنه په 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"
  }
}

د context ډیریدل

کله چې ګفتګه د ماډل له context window څخه لویه وي، /v1/chat/completions او /v1/messages په 400، ډول invalid_request_error، کوډ context_length_exceeded او هغه پیغام ځواب ورکوي چې په prompt is too long پیلیږي. د کوډ لیکلو tools دا تېروتنه لولي ترڅو session فشرده کړي او غوښتنه بیا ولیږي. دا د 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"}

هغه څه چې د agent loop پرې تکیه کولی شي

ستونزې حلول

ستاسو کیلي او بیلانس د Keys & usage په پاڼه کې دي. کیلي او کارونه