Àwọn irinṣẹ́ CLI fún kíkọ code

Coding tool nílò ètò mẹ́ta láti ṣiṣẹ́ pẹ̀lú Shannon: base URL ti API, API key rẹ, àti id model Shannon. Ojú-ìwé yìí fún ọ ní àwọn ètò gan-an fún Claude Code àti Codex CLI, ó ṣàlàyé bí a ṣe ń ka model ìkọ̀wé code shannon-coder-1, ó sì ṣàkójọ àwọn àṣìṣe tí àwọn tool wọ̀nyí ń bá pàdé.

Endpoint tí tool kọ̀ọ̀kan ń lò

Gbogbo endpoint mẹ́tẹ̀ẹ̀ta ń gba API key kan náà, bí Authorization: Bearer tàbí bí x-api-key. A gba àwọn header anthropic-version, anthropic-beta àti openai-beta tí àwọn tool wọ̀nyí ń fi ránṣẹ́.

Yan model Shannon

Ìbéèrè kọ̀ọ̀kan gbọdọ̀ dárúkọ id model tí Shannon tẹ̀ jáde. Coding tool ń fi orúkọ model àìyípadà tirẹ̀ ránṣẹ́ àfi tí o bá sọ fún un ní òdì kejì, a sì ń fi 400 àti ìfiránṣẹ́ unknown model: <name> dá orúkọ tí Shannon kò tẹ̀ jáde lóhùn. A kò so orúkọ mìíràn mọ́ model Shannon kankan, nítorí náà ṣètò model nínú tool ṣáájú ìbéèrè àkọ́kọ́.

GET /v1/models ń ṣàkójọ gbogbo id pẹ̀lú context window wọn. Kò nílò key. Àwọn model àti iye owó

Àwọn coding tool ń darí model pẹ̀lú system prompt gígùn. shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro àti àwọn model open-weight tí a gbàlejò ń lo system prompt, nítorí náà yan ọ̀kan nínú wọn fún coding tool.

Claude Code

Claude Code ń ka asopọ̀ rẹ̀ láti àwọn environment variable. Ṣètò wọn nínú shell tó bẹ̀rẹ̀ rẹ̀, tàbí nínú block env ti ~/.claude/settings.json láti pa wọ́n mọ́ fún gbogbo session.

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

• Ṣètò gbogbo àwọn variable ANTHROPIC_DEFAULT_…_MODEL mẹ́tẹ̀ẹ̀ta. Àwọn subagent àti àwọn command kan ń béèrè model nípasẹ̀ orúkọ tí ó wà nínú rẹ̀, orúkọ kọ̀ọ̀kan sì gbọdọ̀ yanjú sí id Shannon.
• Àpẹẹrẹ náà darí àwọn ìbéèrè ẹ̀yìn sí shannon-1.6-lite, èyí tí a ń kà ní token. Nítorí náà àwọn àkọlé session àti àwọn ìbéèrè irú rẹ̀ kì í lo àwọn ìpè Coder.
• Claude Code ń béèrè POST /v1/messages/count_tokens fún ìwọ̀n context. Endpoint náà ń ka fún àwọn model open-weight tí a gbàlejò. Pẹ̀lú id Shannon, ó ń dáhùn 400; Claude Code kà ìkà token sí àṣàyàn, ó sì ń ṣírò ìwọ̀n náà fúnra rẹ̀. Kíka token

Láti ṣàyẹ̀wò àdírẹ́sì, key àti id model ṣáájú kí o tó bẹ̀rẹ̀ tool náà, fi ìbéèrè kan ránṣẹ́ pẹ̀lú ọwọ́:

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 ń bá Responses API sọ̀rọ̀. Ṣàpèjúwe Shannon bí provider model nínú ~/.codex/config.toml, yan id model Shannon níbẹ̀, kí o sì fi API key rẹ sínú environment variable tí provider dárúkọ.

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 kì í pa ìjíròrò mọ́ lórí server: ìbéèrè kọ̀ọ̀kan gbé ìjíròrò náà nínú input. A gba previous_response_id fún ìbáramu.
• A ń fi àwọn function tool (type: "function") sílẹ̀ fún model lórí /v1/responses.
• Lórí /v1/responses, a ń ka shannon-coder-1 ní token láti balance rẹ, kì í ṣe ní àwọn ìpè Coder.

Ìṣàyẹ̀wò kan náà fún endpoint 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 ìkọ̀wé code àti bí a ṣe ń kà á

shannon-coder-1 ni model Shannon fún àwọn coding agent. GET /v1/models ròyìn rẹ̀ pẹ̀lú context window ti token 131,072, àwọn ìpè tool, ìrònú àti input ọ̀rọ̀. A ń kà á lọ́nà méjì, ó dá lórí endpoint tí tool ń lò.

Ìpè kan jẹ́ ìbéèrè kan, ìwọ̀n yòówù kó jẹ́. A ń kà á nígbà tí a bá gba ìbéèrè náà, ṣáájú kí model tó dáhùn. Session agent ń fi ìbéèrè kan ránṣẹ́ fún ìgbésẹ̀ kọ̀ọ̀kan tó bá gbé, nítorí náà iṣẹ́ gígùn ń lo ọ̀pọ̀ ìpè. Allowance náà dá lórí plan rẹ, ó sì tún bẹ̀rẹ̀ ní wákàtí 4 kọ̀ọ̀kan, ní 00:00, 04:00, 08:00, 12:00, 16:00 àti 20:00 UTC.

Ojú-ìwé plan ń fi àwọn nọ́ńbà lọ́wọ́lọ́wọ́ hàn. Àwọn plan

Nígbà tí àwọn ìpè window kan bá tán, a ó fi 429 dá ìbéèrè náà lóhùn. Lórí /v1/messages àṣìṣe kan náà dé ní ìrísí 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 ń kún kọjá

Nígbà tí ìjíròrò bá tóbi ju context window ti model, /v1/chat/completions àti /v1/messages ń fi 400, irú invalid_request_error, code context_length_exceeded àti ìfiránṣẹ́ tó bẹ̀rẹ̀ pẹ̀lú prompt is too long dáhùn. Àwọn coding tool ń ka àṣìṣe yìí láti kó session pọ̀ kí wọ́n sì tún fi ìbéèrè náà ránṣẹ́. shannon-coder-1, shannon-1.6-lite àti shannon-1.6-pro ni ó ń mú un jáde.

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

Ìfiránṣẹ́ náà jẹ́ prompt is too long: <sent> tokens > <limit> maximum. Nígbà tí a kò mọ àwọn nọ́ńbà méjèèjì, ó jẹ́ prompt is too long. Please compact the conversation and try again.

Lórí stream, status ti jẹ́ 200 tẹ́lẹ̀, nítorí náà àṣìṣe náà dé bí event, stream náà sì tì ní ọ̀nà àtọwọ́dọ́wọ́:

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

Ohun tí agent loop lè gbẹ́kẹ̀lé

Ìyanjú ìṣòro

Key àti balance rẹ wà ní ojú-ìwé Àwọn key àti ìlò. Àwọn key àti ìlò