CLI nástroje na programovanie

Nástroj na programovanie potrebuje na prácu so Shannon tri nastavenia: základnú URL API, váš API kľúč a id modelu Shannon. Táto stránka uvádza presné nastavenia pre Claude Code a Codex CLI, vysvetľuje, ako sa počíta kódovací model shannon-coder-1, a vymenúva chyby, na ktoré tieto nástroje narážajú.

Ktorý endpoint používa ktorý nástroj

Všetky tri endpointy berú rovnaký API kľúč, ako Authorization: Bearer alebo ako x-api-key. Hlavičky anthropic-version, anthropic-beta a openai-beta, ktoré tieto nástroje posielajú, sa prijímajú.

Výber modelu Shannon

Každý request musí uvádzať id modelu, ktoré Shannon zverejňuje. Nástroj na programovanie posiela názov vlastného predvoleného modelu, kým mu nepoviete inak, a na názov, ktorý Shannon nezverejňuje, sa odpovie 400 a správou unknown model: <name>. Žiadny iný názov sa nemapuje na model Shannon, preto model nastavte v nástroji pred prvým requestom.

GET /v1/models vypíše každé id s jeho kontextovým oknom. Nepotrebuje kľúč. Modely a ceny

Nástroje na programovanie riadia model dlhým systémovým promptom. Systémový prompt uplatňujú shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro a hostované open-weight modely, preto pre nástroj na programovanie vyberte jeden z nich.

Claude Code

Claude Code číta svoje pripojenie z premenných prostredia. Nastavte ich v shelli, ktorý ho spúšťa, alebo v bloku env súboru ~/.claude/settings.json, aby platili pre každú reláciu.

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

• Nastavte všetky tri premenné ANTHROPIC_DEFAULT_…_MODEL. Subagenti a niektoré príkazy žiadajú model jeho vstavaným názvom a každý názov sa musí previesť na id Shannon.
• Ukážka smeruje requesty na pozadí na shannon-1.6-lite, ktorý sa počíta v tokenoch. Názvy relácií a podobné requesty tak nespotrebúvajú volania Coder.
• Claude Code žiada POST /v1/messages/count_tokens o veľkosť kontextu. Endpoint počíta pre hostované open-weight modely. S id Shannon odpovie 400; Claude Code považuje počítanie tokenov za nepovinné a veľkosť si odhadne sám. Počítanie tokenov

Ak chcete adresu, kľúč a id modelu overiť pred spustením nástroja, pošlite jeden request ručne:

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 komunikuje s Responses API. Popíšte Shannon ako poskytovateľa modelov v ~/.codex/config.toml, vyberte tam id modelu Shannon a svoj API kľúč dajte do premennej prostredia, ktorú poskytovateľ uvádza.

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 neuchováva na serveri žiadnu konverzáciu: každý request nesie konverzáciu v input. previous_response_id sa prijíma kvôli kompatibilite.
• Nástroje typu funkcia (type: "function") sa na /v1/responses ponúkajú modelu.
• Na /v1/responses sa shannon-coder-1 počíta v tokenoch z vášho zostatku, nie vo volaniach Coder.

Rovnaká kontrola pre 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."
  }'

Kódovací model a ako sa počíta

shannon-coder-1 je model Shannon pre kódovacích agentov. GET /v1/models ho hlási s kontextovým oknom 131,072 tokenov, volaniami nástrojov, uvažovaním a textovým vstupom. Počíta sa jedným z dvoch spôsobov, podľa endpointu, ktorý nástroj používa.

Volanie je jeden request, nech je akokoľvek veľký. Počíta sa pri prijatí requestu, ešte pred odpoveďou modelu. Relácia agenta pošle jeden request na každý krok, takže dlhá úloha spotrebuje veľa volaní. Limit závisí od vášho plánu a obnovuje sa každé 4 hodiny, o 00:00, 04:00, 08:00, 12:00, 16:00 a 20:00 UTC.

Stránka plánov ukazuje aktuálne čísla. Plány

Keď sa volania okna vyčerpajú, na request sa odpovie 429. Na /v1/messages príde rovnaká chyba v tvare 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"
  }
}

Pretečenie kontextu

Keď je konverzácia väčšia než kontextové okno modelu, /v1/chat/completions a /v1/messages odpovedia 400, typom invalid_request_error, kódom context_length_exceeded a správou, ktorá začína prompt is too long. Nástroje na programovanie túto chybu čítajú, aby reláciu zhutnili a poslali request znova. Vytvárajú ju shannon-coder-1, shannon-1.6-lite a 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
  }
}

Správa je prompt is too long: <sent> tokens > <limit> maximum. Keď obe čísla nie sú známe, je to prompt is too long. Please compact the conversation and try again.

V streame je stav už 200, takže chyba príde ako udalosť a stream sa potom zatvorí normálne:

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

Na čo sa môže slučka agenta spoľahnúť

Riešenie problémov

Váš kľúč a zostatok sú na stránke Kľúče a využitie. Kľúče a využitie