Код жазуу үчүн CLI куралдары

Коддоо куралы Shannon менен иштөө үчүн үч жөндөөнү талап кылат: API'нин негизги URL'и, API ачкычыңыз жана Shannon модель id'си. Бул бетте Claude Code жана Codex CLI үчүн так жөндөөлөр берилген, shannon-coder-1 коддоо модели кантип эсептелери түшүндүрүлөт жана бул куралдар кезиктирген каталар тизмеленет.

Ар бир курал кайсы endpoint'ти колдонот

Үч endpoint тең бир эле API ачкычты кабыл алат, Authorization: Bearer же x-api-key катары. Бул куралдар жөнөткөн anthropic-version, anthropic-beta жана openai-beta баштары кабыл алынат.

Shannon моделин тандоо

Ар бир сурамда Shannon жарыялаган модель id'си көрсөтүлүшү керек. Сиз башкача айтпасаңыз, коддоо куралы өзүнүн стандарттуу моделинин атын жөнөтөт, ал эми Shannon жарыялабаган ат 400 жана unknown model: <name> билдирүүсү менен жооп алат. Башка эч бир ат Shannon моделине байланыштырылбайт, ошондуктан биринчи сурамдан мурун моделди куралдын ичинде коюңуз.

GET /v1/models ар бир id'ни контекст терезеси менен бирге тизмелейт. Ачкыч талап кылынбайт. Моделдер жана баалар

Коддоо куралдары моделди узун системалык промпт менен башкарат. Системалык промпт shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro жана хостингдеги ачык салмактуу моделдерде колдонулат, андыктан коддоо куралы үчүн ушулардын бирин тандаңыз.

Claude Code

Claude Code туташуусун чөйрө өзгөрмөлөрүнөн окуйт. Аларды аны иштеткен shell'де коюңуз, же ар бир сессия үчүн сактоо үчүн ~/.claude/settings.json ичиндеги env блогуна жазыңыз.

# 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 өзгөрмөсүнүн баарын коюңуз. Субагенттер жана кээ бир командалар модельди анын камтылган аты менен сурайт, ал эми ар бир ат Shannon id'ге ылайык келиши керек.
• Үлгү фондук сурамдарды токендер менен эсептелген shannon-1.6-lite'ка багыттайт. Анда сессия аталыштары жана ушул сыяктуу сурамдар Coder чалууларын колдонбойт.
• Claude Code контекст өлчөмүн билүү үчүн POST /v1/messages/count_tokens суроосун берет. Endpoint хостингдеги ачык салмактуу моделдер үчүн санайт. Shannon id менен ал 400 менен жооп берет; Claude Code токен саноону милдеттүү эмес деп эсептейт жана өлчөмдү өзү болжолдойт. Токен саноо

Курал иштете электе дареги, ачкычы жана модель 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 ичинде модель провайдери катары сүрөттөңүз, ошол жерде Shannon модель id'син тандаңыз жана API ачкычыңызды провайдер атаган чөйрө өзгөрмөсүнө салыңыз.

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 серверде сүйлөшүүнү сактабайт: ар бир сурам сүйлөшүүнү input ичинде алып жүрөт. previous_response_id шайкештик үчүн кабыл алынат.
• Функция куралдары (type: "function") /v1/responses боюнча модельге сунушталат.
• /v1/responses боюнча shannon-coder-1 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 — коддоо агенттери үчүн Shannon модели. GET /v1/models аны 131,072 токендик контекст терезеси, курал чалуулары, reasoning жана текст кириши менен билдирет. Курал колдонгон endpoint'ке жараша ал эки жолдун бири менен эсептелет.

Чалуу — бир сурам, өлчөмүнө карабастан. Ал сурам кабыл алынганда, модель жооп бергенге чейин эсептелет. Агент сессиясы ар бир кадамы үчүн бир сурам жөнөтөт, ошондуктан узун тапшырма көп чалууну колдонот. Лимит планыңызга жараша болот жана ар 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"
  }
}

Контекстин ашып кетиши

Сүйлөшүү модельдин контекст терезесинен чоң болгондо, /v1/chat/completions жана /v1/messages 400, invalid_request_error түрү, context_length_exceeded коду жана prompt is too long менен башталган билдирүү менен жооп берет. Коддоо куралдары бул катаны окуп, сеансты кыскартып, сурамды кайра жөнөтөт. Аны 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.

Стримде статус буга чейин эле 200, ошондуктан ката окуя катары келет, андан кийин стрим кадимкидей жабылат:

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

Агент цикли эмнеге таяна алат

Көйгөйлөрдү чечүү

Ачкычыңыз жана балансыңыз Keys & usage бетинде. Ачкычтар жана колдонуу