Qalabka CLI ee coding-ka

Qalabka coding-ku wuxuu u baahan yahay saddex dejin si uu ula shaqeeyo Shannon: base URL-ka API-ga, furahaaga API, iyo id model Shannon ah. Boggani wuxuu bixiyaa dejinta saxda ah ee Claude Code iyo Codex CLI, wuxuu sharxayaa sida model-ka coding-ka shannon-coder-1 loo tiriyo, wuxuuna liis garaynayaa khaladaadka tools-kani la kulmaan.

Endpoint-ka tool kasta isticmaalo

Saddexda endpoint dhammaantood waxay qaataan isla furaha API, sida Authorization: Bearer ama sida x-api-key. Header-yada anthropic-version, anthropic-beta iyo openai-beta ee tools-kani diraan waa la aqbalaa.

Dooro model Shannon ah

Codsi kasta waa inuu magacaabaa id model oo Shannon daabacdo. Qalabka coding-ku wuxuu diraa magaca model-kiisa default-ka ah haddii aadan u sheegin si kale, magac Shannon aan daabacinna waxaa lagu jawaabaa 400 iyo fariinta unknown model: <name>. Magac kale lagu ma khariidadayn model Shannon ah, sidaas darteed model-ka ku deji tool-ka ka hor codsiga ugu horreeya.

GET /v1/models wuxuu liis garaynayaa id kasta iyo context window-kiisa. Fure looma baahna. Model-yo & qiimo

Qalabka coding-ku wuxuu model-ka ku hagaa system prompt dheer. System prompt-ka waxaa dabaqa shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro iyo model-yada open-weight ee la martigeliyo, sidaas darteed qalabka coding-ka mid ka mid ah kuwan dooro.

Claude Code

Claude Code wuxuu isku xirka ka akhriyaa environment variables. Ku deji shell-ka bilaabaya, ama block-ga env ee ~/.claude/settings.json si aad ugu haysato fadhi kasta.

# 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"
  }
}

• Deji saddexda variable ee ANTHROPIC_DEFAULT_…_MODEL. Subagents iyo amarro qaar waxay model ku codsadaan magaciisa dhex-dhisan, magac kastana waa inuu u furmaa id Shannon ah.
• Tusaalaha wuxuu codsiyada gadaal ku jiheeyaa shannon-1.6-lite, kaas oo lagu tiriyo token-yo. Cinwaannada fadhiga iyo codsiyo la mid ah kaddib wicitaannada Coder ma isticmaalaan.
• Claude Code wuxuu weydiiyaa POST /v1/messages/count_tokens cabbirka context-ka. Endpoint-ku wuxuu tiriyaa model-yada open-weight ee la martigeliyo. Id Shannon ah wuxuu ku jawaabaa 400; Claude Code tirinta token-yada wuxuu u aqoonsadaa ikhtiyaari wuxuuna cabbirka laftiisa qiyaasaa. Tirinta token-yada

Si aad u hubiso cinwaanka, furaha iyo id model ka hor inta aadan tool-ka bilaabin, hal codsi gacanta u dir:

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 wuxuu la hadlaa Responses API. U sharax Shannon sida model provider ~/.codex/config.toml, halkaas ka dooro id model Shannon ah, oo furahaaga API geli environment variable-ka provider-ku magacaabo.

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 wada-hadal server-ka kuma hayo: codsi kastaa wuxuu wada-hadalka ku sidaa input. previous_response_id waa la aqbalaa u waafaqsanaan.
• Function tools (type: "function") waxaa model-ka loo soo bandhigaa /v1/responses.
• /v1/responses, shannon-coder-1 waxaa lagu tiriyaa token-yo haraaggaaga, ma aha wicitaannada Coder.

Isla hubinta endpoint-ka 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."
  }'

Model-ka coding-ka iyo sida loo tiriyo

shannon-coder-1 waa model-ka Shannon ee wakiillada coding-ka. GET /v1/models wuxuu sheegaa context window oo ah 131,072 token, wicitaannada tool, reasoning iyo gelinta qoraalka. Waxaa lagu tiriyaa mid ka mid ah laba hab, iyadoo ku xiran endpoint-ka tool-ku isticmaalo.

Wicitaan waa hal codsi, cabbir kasta ha ahaadee. Waxaa la tiriyaa marka codsiga la aqbalo, ka hor inta model-ku jawaabin. Fadhiga wakiilku wuxuu diraa hal codsi tallaabo kasta oo uu qaado, sidaas darteed hawl dheer waxay isticmaashaa wicitaanno badan. Allowance-ku wuxuu ku xiran yahay qorshahaaga wuxuuna dib u bilaabmaa 4 saac kasta, 00:00, 04:00, 08:00, 12:00, 16:00 iyo 20:00 UTC.

Bogga qorshaha wuxuu muujiyaa tirooyinka hadda. Qorshayaal

Marka wicitaannada daaqad la isticmaalo, codsiga waxaa lagu jawaabaa 429. /v1/messages isla khaladkaas wuxuu u yimaadaa qaabka 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 ka buuxsamay

Marka wada-hadal ka weyn yahay context window-ka model-ka, /v1/chat/completions iyo /v1/messages waxay ku jawaabaan 400, nooca invalid_request_error, code-ka context_length_exceeded iyo fariin ku bilaabata prompt is too long. Qalabka coding-ku wuxuu akhriyaa khaladkan si uu fadhiga u soo koobo oo mar kale u diro codsiga. Waxaa soo saara shannon-coder-1, shannon-1.6-lite iyo 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
  }
}

Fariintu waa prompt is too long: <sent> tokens > <limit> maximum. Marka labada lambar la ogayn, waa prompt is too long. Please compact the conversation and try again.

Stream-ka xaaladdu horeba waa 200, sidaas darteed khaladku wuxuu u yimaadaa sida event, stream-kuna kaddib wuxuu xirmaa si caadi ah:

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"}

Waxa wareegga wakiilku ku tiirsanaan karo

Xalinta dhibaatooyinka

Furahaaga iyo haraaggaaga waxay ku yaalliin bogga Fure & isticmaal. Fure & isticmaal