CLI алатки за програмирање

Алатка за програмирање има потреба од три поставки за да работи со Shannon: основниот URL на API-то, вашиот API клуч и ид на Shannon модел. Оваа страница ги дава точните поставки за Claude Code и Codex CLI, објаснува како се брои моделот за програмирање shannon-coder-1 и ги наведува грешките што ги среќаваат овие алатки.

Кој endpoint го користи секоја алатка

Сите три endpoint-и го примаат истиот API клуч, како Authorization: Bearer или како x-api-key. Заглавијата anthropic-version, anthropic-beta и openai-beta што ги испраќаат овие алатки се прифаќаат.

Изберете Shannon модел

Секое барање мора да именува ид на модел што Shannon го објавува. Алатката за програмирање го испраќа името на својот стандарден модел освен ако не ѝ кажете поинаку, а на име што Shannon не го објавува се одговара со 400 и порака unknown model: <name>. Ниедно друго име не се мапира во Shannon модел, затоа поставете го моделот во алатката пред првото барање.

GET /v1/models го наведува секој ид со неговиот контекстен прозорец. Не бара клуч. Модели и цени

Алатките за програмирање го насочуваат моделот со долг system prompt. System prompt-от го применуваат shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro и хостираните open-weight модели, затоа за алатка за програмирање изберете еден од нив.

Claude Code

Claude Code ја чита својата врска од променливи на околината. Поставете ги во школката што го стартува, или во блокот env на ~/.claude/settings.json за да ги задржите за секоја сесија.

# 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. Subagent-ите и некои команди бараат модел по неговото вградено име, а секое име мора да се разреши во Shannon ид.
• Примерот ги насочува барањата во позадина кон shannon-1.6-lite, кој се брои во токени. Насловите на сесии и слични барања тогаш не користат Coder повици.
• Claude Code бара од POST /v1/messages/count_tokens големината на контекстот. Endpoint-от брои за хостираните open-weight модели. Со Shannon ид одговара 400; Claude Code го смета броењето токени за опционално и самиот ја проценува големината. Броење токени

За да ги проверите адресата, клучот и ид-то на моделот пред да ја стартувате алатката, испратете едно барање рачно:

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 како provider на модели во ~/.codex/config.toml, изберете таму ид на Shannon модел и ставете го вашиот API клуч во променливата на околината што ја именува provider-от.

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.

Во streaming статусот е веќе 200, па грешката пристигнува како настан, а streaming-от потоа се затвора на нормален начин:

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

На што може да се потпре циклусот на агент

Решавање проблеми

Вашиот клуч и вашето салдо се на страницата Клучеви и употреба. Клучеви и употреба