Izixhobo zekhowudi ze-CLI

I-tool yekhowudi ifuna useto ezintathu ukuze isebenze neShannon: i-base URL ye-API, i-API key yakho, kunye ne-id yemodeli yeShannon. Eli phepha libonisa useto oluchanekileyo lweClaude Code neCodex CLI, licacisa indlela imodeli yekhowudi i-shannon-coder-1 ebalwa ngayo, kwaye lidwelisa iimpazamo ezidibana nazo ezi tool.

Yeyiphi i-endpoint esetyenziswa yi-tool nganye

Zontathu ii-endpoint zamkela i-API key enye, njenge-Authorization: Bearer okanye njenge-x-api-key. Ii-header ze-anthropic-version, anthropic-beta ne-openai-beta ezithunyelwa zezi tool ziyamkelwa.

Khetha imodeli yeShannon

Isicelo ngasinye kufuneka sibize i-id yemodeli ekhutshwa yiShannon. I-tool yekhowudi ithumela igama lemodeli yayo engagqibekanga ngaphandle kokuba uyixelele ngenye indlela, kwaye igama elingakhutshwa yiShannon liphendulwa nge-400 nomyalezo othi unknown model: <name>. Akukho gama lilodwa litshintshelwa kwimodeli yeShannon, ngoko seta imodeli kwi-tool phambi kwesicelo sokuqala.

I-GET /v1/models idwelisa yonke i-id kunye nefestile yomxholo wayo. Ayifuni sitshixo. Iimodeli namaxabiso

Ii-tool zekhowudi ziqhuba imodeli nge-system prompt ende. I-system prompt isetyenziswa yi-shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro neemodeli ze-open-weight ezisingathiweyo, ngoko khetha enye yazo kwi-tool yekhowudi.

Claude Code

IClaude Code ifunda uxhulumano lwayo kwii-environment variable. Zisete kwi-shell eyiqalisayo, okanye kwi-block ye-env ye-~/.claude/settings.json ukuze uzigcine kuzo zonke iiseshoni.

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

• Seta zontathu ii-variable ze-ANTHROPIC_DEFAULT_…_MODEL. Ii-subagent nemiyalelo ethile icela imodeli ngegama layo elakhelwe ngaphakathi, kwaye igama ngalinye kufuneka lifumane i-id yeShannon.
• Umzekelo uthumela izicelo zasemva kwesiza kwi-shannon-1.6-lite, ebalwa ngee-token. Izihloko zeseshoni nezicelo ezifanayo ngoko azisebenzisi bizo lweCoder.
• IClaude Code ibuza i-POST /v1/messages/count_tokens ubungakanani bomxholo. I-endpoint ibala iimodeli ze-open-weight ezisingathiweyo. Nge-id yeShannon iphendula nge-400; iClaude Code ithatha ukubala ii-token njengokungenyanzelekanga kwaye iqikelela ubungakanani ngokwayo. Ukubala ii-token

Ukuhlola idilesi, isitshixo ne-id yemodeli phambi kokuqalisa i-tool, thumela isicelo esinye ngesandla:

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

ICodex CLI ithetha ne-Responses API. Chaza iShannon njengomboneleli wemodeli kwi-~/.codex/config.toml, khetha i-id yemodeli yeShannon apho, kwaye ubeke i-API key yakho kwi-environment variable ebizwa ngomboneleli.

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

• I-/v1/responses ayigcini ncoko kwi-server: isicelo ngasinye sithwala incoko kwi-input. I-previous_response_id iyamkelwa ngenxa yokuhambelana.
• Ii-tool zemisebenzi (type: "function") zibonelelwa imodeli kwi-/v1/responses.
• Kwi-/v1/responses, i-shannon-coder-1 ibalwa ngee-token ezisuka kwibhalansi yakho, hayi ngobizo lweCoder.

Uhlolo olufanayo lwe-endpoint ye-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."
  }'

Imodeli yekhowudi nendlela ebalwa ngayo

I-shannon-coder-1 yimodeli yeShannon yee-agent zekhowudi. I-GET /v1/models iyixela ngefestile yomxholo ye-131,072 yee-token, ubizo lwee-tool, ukuqiqa ne-text input. Ibalwa ngezi ndlela zimbini, kuxhomekeke kwi-endpoint esetyenziswa yi-tool.

Ubizo yisicelo esinye, nokuba sikhulu kangakanani. Lubalwa xa isicelo samkelwa, phambi kokuba imodeli iphendule. Iseshoni ye-agent ithumela isicelo esinye kwinyathelo ngalinye eliyithathayo, ngoko umsebenzi omde usebenzisa ubizo oluninzi. Isabelo sixhomekeke kwiplani yakho kwaye siqala kwakhona rhoqo emva kweeyure ezi-4, ngentsimbi ye-00:00, 04:00, 08:00, 12:00, 16:00 ne-20:00 UTC.

Iphepha leeplani libonisa amanani akhoyo. Iiplani

Xa ubizo lwefestile lugqityiwe, isicelo siphendulwa nge-429. Kwi-/v1/messages impazamo enye ifika ngemo ye-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"
  }
}

Ukuphuphuma komxholo

Xa incoko inkulu kunefestile yomxholo yemodeli, i-/v1/chat/completions ne-/v1/messages ziphendula nge-400, uhlobo invalid_request_error, ikhowudi context_length_exceeded nomyalezo oqala nge-prompt is too long. Ii-tool zekhowudi zifunda le mpazamo ukuze zifinyeze iseshoni kwaye zithumele isicelo kwakhona. Ivelisa yi-shannon-coder-1, shannon-1.6-lite kunye ne-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
  }
}

Umyalezo ngu-prompt is too long: <sent> tokens > <limit> maximum. Xa amanani omabini engaziwa ngu-prompt is too long. Please compact the conversation and try again.

Kwi-stream isimo sele sisi-200, ngoko impazamo ifika njengesiganeko kwaye emva koko i-stream ivalwa ngendlela eqhelekileyo:

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

Oko umjikelo we-agent ungaxhomekeka kuko

Ukusombulula iingxaki

Isitshixo sakho nebhalansi yakho zikwiphepha leZitshixo nokusetyenziswa. Izitshixo nokusetyenziswa