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-ді контекст терезесімен тізімдейді. Ол кілтті қажет етпейді. Модельдер және бағалар

Кодтау құралдары модельді ұзын system prompt арқылы бағыттайды. System prompt-ты shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro және hosted open-weight модельдер қолданады, сондықтан кодтау құралы үшін осылардың бірін таңдаңыз.

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 hosted open-weight модельдер үшін есептейді. 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 токендік контекст терезесімен, құрал шақырулармен, пайымдаумен және мәтін кірісімен хабарлайды. Құрал қолданатын 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 бетінде. Keys & usage