CLI ናይ ኮዲንግ መሳለጥያታት

ናይ ኮዲንግ መሳለጥያ ምስ Shannon ንክሰርሕ ሰለስተ ቅጥዒታት የድልዮ፦ base URL ናይ API፣ API ቁልፍኻ፣ ከምኡውን Shannon ሞዴል id። እዚ ገጽ ንClaude Code ከምኡውን Codex CLI ልክዕ ቅጥዒታት ይህብ፣ እቲ ናይ ኮዲንግ ሞዴል shannon-coder-1 ከመይ ከም ዝቝጸር የረድእ፣ ከምኡውን እዞም መሳለጥያታት ዝርከብዎም ጌጋታት ይዝርዝር።

ነፍሲ ወከፍ መሳለጥያ ኣየነይቲ endpoint ይጥቀም

ኩሎም ሰለስተ endpoints ተመሳሳሊ API ቁልፊ ይቕበሉ፣ ከም Authorization: Bearer ወይ ከም x-api-key። እዞም መሳለጥያታት ዝልእክዎም headers anthropic-version፣ anthropic-beta ከምኡውን openai-beta ይቕበሉ።

Shannon ሞዴል ምረጽ

ነፍሲ ወከፍ ጠለብ Shannon ዘወጅኦ ሞዴል id ክሰምይ ኣለዎ። ናይ ኮዲንግ መሳለጥያ ካብ ዘይነገርካዮ ናይ ርእሱ ነባሪ ሞዴል ስም ይልእኽ፣ Shannon ዘየወጅኦ ስም ድማ ብ 400 ከምኡውን መልእኽቲ unknown model: <name> ይምለስ። ዝኾነ ካልእ ስም ናብ Shannon ሞዴል ኣይምዕቀንን፣ ስለዚ ቅድሚ ቀዳማይ ጠለብ ሞዴል ኣብ መሳለጥያ ኣዘጋጅ።

GET /v1/models ነፍሲ ወከፍ id ምስ context window ናቱ ይዝርዝር። ቁልፊ ኣየድልዮን። ሞዴላትን ዋጋን

ናይ ኮዲንግ መሳለጥያታት ንሞዴል ብነዊሕ system prompt የመርሕዎ። እቲ system prompt ብ shannon-coder-1፣ shannon-1.6-lite፣ shannon-1.6-pro፣ shannon-2-lite፣ shannon-2-pro ከምኡውን ዝተሃንደሱ open-weight ሞዴላት ይትግበር፣ ስለዚ ንናይ ኮዲንግ መሳለጥያ ሓደ ካብዚኣቶም ምረጽ።

Claude Code

Claude Code connection ናቱ ካብ environment variables የንብብ። ኣብ እቲ ዝጅምሮ shell ኣዘጋጆም፣ ወይ ንነፍሲ ወከፍ session ንምሕዛ ኣብ env block ናይ ~/.claude/settings.json።

# 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 variables ኣዘጋጅ። Subagents ከምኡውን ገለ commands ሞዴል ብውሽጣዊ ስሙ ይሓትቱ፣ ነፍሲ ወከፍ ስም ድማ ናብ Shannon id ክፍታሕ ኣለዎ።
• እቲ ኣብነት ድሕረ-ባይታ ጠለባት ናብ shannon-1.6-lite የመልክት፣ ብ tokens ዝቝጸር። Titles ናይ session ከምኡውን ተመሳሳሊ ጠለባት ሽዑ 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 ምረጽ፣ ቁልፍኻ ድማ ኣብ 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 ብ tokens ካብ ሚዛንካ ይቝጸር እምበር ብ 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 ንcoding agents ዝኸውን ሞዴል Shannon እዩ። GET /v1/models ብ context window ናይ 131,072 tokens፣ tool ጥሪታት፣ reasoning ከምኡውን ጽሑፍ ኣተዋዕዎ ይሕብሮ። መሳለጥያ ዝጥቀመሉ endpoint ተመርኲሱ ብሓደ ካብ ክልተ ኣገባባት ይቝጸር።

ሓደ ጥሪ ሓደ ጠለብ እዩ፣ ዓቐኑ ዝኾነ ይኹን። እቲ ጠለብ ምስ ተቐበለ፣ ቅድሚ እቲ ሞዴል ምምላሱ ይቝጸር። ሓደ agent session ንነፍሲ ወከፍ ዝወሰዶ ስጉምቲ ሓደ ጠለብ ይልእኽ፣ ስለዚ ነዊሕ ስራሕ ብዙሕ ጥሪታት ይጥቀም። እቲ allowance ኣብ ፕላንካ ይምርኰስ ከምኡውን ኣብ ነፍሲ ወከፍ 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፣ code context_length_exceeded ከምኡውን ብ prompt is too long ዝጅምር መልእኽቲ ይምልሱ። ናይ ኮዲንግ መሳለጥያታት 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 እዩ፣ ስለዚ እቲ ጌጋ ከም 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"}

ኣብ agent loop እንታይ ክእመን ይኽእል

ጸገማት ምፍታሕ

ቁልፍኻን ሚዛንካን ኣብ ገጽ ቁልፍታትን ኣጠቓቕማን ኣለዉ። ቁልፍታትን ኣጠቓቕማን