Zida za CLI zolembera code

Tool ya coding imafuna ma setting atatu kuti igwire ntchito ndi Shannon: base URL ya API, API key yanu, ndi model id ya Shannon. Tsamba ili limapereka ma setting enieni a Claude Code ndi Codex CLI, limafotokoza momwe model ya coding shannon-coder-1 imawerengedwera, ndipo limalemba zolakwika zomwe ma tool awa amakumana nazo.

Endpoint yomwe tool iliyonse imagwiritsa ntchito

Ma endpoint onse atatu amalandira API key imodzi, ngati Authorization: Bearer kapena ngati x-api-key. Ma header anthropic-version, anthropic-beta ndi openai-beta omwe ma tool awa amatumiza amalandiridwa.

Sankhani model ya Shannon

Pempho lililonse liyenera kutchula model id yomwe Shannon imafalitsa. Tool ya coding imatumiza dzina la model yake yokhazikika pokhapokha mutaiuza zina, ndipo dzina limene Shannon siifalitsa limayankhidwa ndi 400 ndi message unknown model: <name>. Palibe dzina lina lomwe limalumikizidwa ku model ya Shannon, choncho khazikitsani model mu tool pempho loyamba lisanatumizidwe.

GET /v1/models imalemba id iliyonse ndi context window yake. Siifuna kiyi. Ma model ndi mitengo

Ma tool a coding amatsogolera model ndi system prompt yayitali. System prompt imagwiritsidwa ntchito ndi shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro ndi hosted open-weight model, choncho sankhani imodzi mwa izi pa tool ya coding.

Claude Code

Claude Code imawerenga connection yake kuchokera ku environment variable. Zikhazikitseni mu shell yomwe imayiyambitsa, kapena mu block ya env ya ~/.claude/settings.json kuti zikhale pa session iliyonse.

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

• Khazikitsani ma variable onse atatu a ANTHROPIC_DEFAULT_…_MODEL. Ma subagent ndi ma command ena amapempha model ndi dzina lake lomangidwa, ndipo dzina lililonse liyenera kufika ku id ya Shannon.
• Chitsanzo chimalozera ma pempho akumbuyo ku shannon-1.6-lite, yomwe imawerengedwa mu ma token. Ma title a session ndi ma pempho ofanana sagwiritsa ntchito ma call a Coder.
• Claude Code imapempha POST /v1/messages/count_tokens kuti idziwe kukula kwa context. Endpoint imawerenga pa hosted open-weight model. Ndi id ya Shannon imayankha 400; Claude Code imaona kuwerenga ma token ngati kosafunika ndipo imayerekezera kukula yokha. Kuwerenga ma token

Kuti muyang'ane adilesi, kiyi ndi model id musanayambe tool, tumizani pempho limodzi pamanja:

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 imalankhula ndi Responses API. Fotokozani Shannon ngati model provider mu ~/.codex/config.toml, sankhani model id ya Shannon kumeneko, ndipo ikani API key yanu mu environment variable yomwe provider imatchula.

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 siisunga zokambirana pa server: pempho lililonse limanyamula zokambirana mu input. previous_response_id imalandiridwa pofuna kugwirizana.
• Ma function tool (type: "function") amaperekedwa kwa model pa /v1/responses.
• Pa /v1/responses, shannon-coder-1 imawerengedwa mu ma token kuchokera ku balance yanu, osati mu ma call a Coder.

Kuyang'ana komweko pa endpoint ya 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 ya coding ndi momwe imawerengedwera

shannon-coder-1 ndi model ya Shannon ya ma coding agent. GET /v1/models imaitchula ndi context window ya ma token 131,072, ma call a tool, reasoning ndi input ya text. Imawerengedwa m'njira imodzi mwa ziwiri, kutengera endpoint yomwe tool imagwiritsa ntchito.

Call ndi pempho limodzi, mosasamala kukula kwake. Imawerengedwa pempho likalandiridwa, model isanayankhe. Session ya agent imatumiza pempho limodzi pa sitepe iliyonse yomwe imachita, choncho ntchito yayitali imagwiritsa ntchito ma call ambiri. Allowance imadalira plan yanu ndipo imayamba kachiwiri maola 4 aliwonse, pa 00:00, 04:00, 08:00, 12:00, 16:00 ndi 20:00 UTC.

Tsamba la plan limaonetsa manambala amakono. Ma plan

Ma call a window akatha, pempho limayankhidwa ndi 429. Pa /v1/messages cholakwika chomwecho chimabwera mu mawonekedwe a 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 overflow

Zokambirana zikakhala zazikulu kuposa context window ya model, /v1/chat/completions ndi /v1/messages zimayankha ndi 400, type invalid_request_error, code context_length_exceeded ndi message yoyambira ndi prompt is too long. Ma tool a coding amawerenga cholakwika ichi kuti achepetse session ndi kutumizanso pempho. Chimapangidwa ndi shannon-coder-1, shannon-1.6-lite ndi 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
  }
}

Message ndi prompt is too long: <sent> tokens > <limit> maximum. Ngati manambala awiriwo sakudziwika ndi prompt is too long. Please compact the conversation and try again.

Pa stream status yakhala kale 200, choncho cholakwika chimafika ngati event ndipo stream imatseka mwachizolowezi:

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

Zomwe agent loop ingadalire

Kuthetsa mavuto

Kiyi yanu ndi balance yanu zili patsamba la Keys & usage. Keys & usage