የCLI ኮዲንግ መሣሪያዎች

አንድ coding tool ከShannon ጋር ለመስራት ሦስት ቅንብሮች ያስፈልጉታል፦ የAPI base URL፣ የAPI ቁልፍዎ እና የShannon ሞዴል id። ይህ ገጽ ለClaude Code እና ለCodex CLI ትክክለኛ ቅንብሮችን ይሰጣል፣ የኮዲንግ ሞዴሉ shannon-coder-1 እንዴት እንደሚቆጠር ያብራራል፣ እና እነዚህ tools የሚያጋጥሟቸውን ስህተቶች ይዘረዝራል።

እያንዳንዱ መሣሪያ የትኛውን endpoint ይጠቀማል

ሦስቱም endpoints ተመሳሳዩን API ቁልፍ ይቀበላሉ፣ እንደ Authorization: Bearer ወይም እንደ x-api-key። እነዚህ መሣሪያዎች የሚልኳቸው anthropic-version, anthropic-beta እና openai-beta headers ተቀባይነት አላቸው።

የShannon ሞዴል ይምረጡ

እያንዳንዱ ጥያቄ Shannon የሚያትመውን የሞዴል id መጥቀስ አለበት። coding tool ካልነገሩት የራሱን default ሞዴል ስም ይልካል፣ Shannon የማያትመው ስም ደግሞ በ400 እና በunknown model: <name> መልእክት ይመለሳል። ሌላ ማንኛውም ስም ወደ Shannon ሞዴል አይቀየርም፣ ስለዚህ ከመጀመሪያው ጥያቄ በፊት ሞዴሉን በtool ውስጥ ያዋቅሩ።

GET /v1/models ሁሉንም id ከcontext window ጋር ይዘረዝራል። ቁልፍ አያስፈልገውም። ሞዴሎችና ዋጋ

Coding tools ሞዴሉን በረጅም system prompt ይመራሉ። system prompt የሚተገበረው በshannon-coder-1፣ shannon-1.6-lite፣ shannon-1.6-pro፣ shannon-2-lite፣ shannon-2-pro እና በተስተናገዱት open-weight ሞዴሎች ነው፣ ስለዚህ ለcoding tool ከእነዚህ አንዱን ይምረጡ።

Claude Code

Claude Code ግንኙነቱን ከenvironment variables ያነባል። የሚጀምረው shell ውስጥ ያዘጋጁዋቸው፣ ወይም ለእያንዳንዱ ክፍለ ጊዜ ለማቆየት በ~/.claude/settings.json የenv block ውስጥ።

# 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 ያመለክታል፣ ይህም በtokens ይቆጠራል። የክፍለ ጊዜ ርዕሶችና ተመሳሳይ ጥያቄዎች ከዚያ የCoder ጥሪዎችን አይጠቀሙም።
• Claude Code የcontextውን መጠን ለማወቅ POST /v1/messages/count_tokens ይጠይቃል። Endpointው ለሆስት open-weight ሞዴሎች ይቆጥራል። በShannon id 400 ይመልሳል፤ Claude Code የtoken ቆጠራን እንደ አማራጭ ይቆጥረዋል እና መጠኑን ራሱ ይገምታል። የ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 ጋር ይነጋገራል። Shannonን በ~/.codex/config.toml ውስጥ እንደ model provider ይግለጹ፣ እዚያ የShannon ሞዴል id ይምረጡ፣ እና የAPI ቁልፍዎን providerው በሰየመው 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 ለተኳሃኝነት ይቀበላል።
• የፋንክሽን tools (type: "function") በ/v1/responses ላይ ለሞዴሉ ይቀርባሉ።
• በ/v1/responses ላይ shannon-coder-1 በCoder ጥሪዎች ሳይሆን ከቀሪ ሂሳብዎ በtokens ይቆጠራል።

ለ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 tokens context መስኮት፣ በtool ጥሪዎች፣ በreasoning እና በጽሑፍ input ያሳውቀዋል። መሣሪያው በሚጠቀምበት 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"
  }
}

የcontext መሞላት

ውይይቱ ከሞዴሉ context window ሲበልጥ /v1/chat/completions እና /v1/messages በ400፣ በinvalid_request_error አይነት፣ በcontext_length_exceeded ኮድ እና በprompt is too long በሚጀምር መልእክት ይመልሳሉ። Coding tools ይህን ስህተት አንብበው ክፍለ ጊዜውን ያሳጥሩና ጥያቄውን እንደገና ይልካሉ። ይህን የሚያመነጩት 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 ላይ status አስቀድሞ 200 ነው፣ ስለዚህ ስህተቱ እንደ event ይመጣል፣ ከዚያም 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"}

የኤጀንት ዑደት ሊተማመንበት የሚችለው

ችግር ፈቺ

ቁልፍዎና ቀሪ ሂሳብዎ በKeys & usage ገጽ ላይ ናቸው። Keys & usage