CLI nástroje pro programování

Programovací nástroj potřebuje pro práci se Shannon tři nastavení: základní URL API, váš API klíč a id modelu Shannon. Tato stránka uvádí přesná nastavení pro Claude Code a Codex CLI, vysvětluje, jak se počítá programovací model shannon-coder-1, a vyjmenovává chyby, na které tyto nástroje narážejí.

Který endpoint který nástroj používá

Všechny tři endpointy přijímají stejný API klíč, jako Authorization: Bearer nebo jako x-api-key. Hlavičky anthropic-version, anthropic-beta a openai-beta, které tyto nástroje posílají, se přijímají.

Výběr modelu Shannon

Každý požadavek musí uvádět id modelu, které Shannon zveřejňuje. Programovací nástroj posílá název svého vlastního výchozího modelu, pokud mu neřeknete jinak, a na název, který Shannon nezveřejňuje, se odpoví 400 a zprávou unknown model: <name>. Žádný jiný název se nepřevádí na model Shannon, proto nastavte model v nástroji před prvním požadavkem.

GET /v1/models vypisuje každé id s jeho kontextovým oknem. Nepotřebuje klíč. Modely a ceny

Programovací nástroje řídí model dlouhým systémovým promptem. Systémový prompt uplatňují shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro a hostované modely s otevřenými váhami, proto pro programovací nástroj vyberte jeden z nich.

Claude Code

Claude Code čte své připojení z proměnných prostředí. Nastavte je v shellu, který jej spouští, nebo v bloku env souboru ~/.claude/settings.json, aby platily pro každou relaci.

# 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šechny tři proměnné ANTHROPIC_DEFAULT_…_MODEL. Subagenti a některé příkazy žádají o model jeho vestavěným názvem a každý název se musí převést na id Shannon.
• Ukázka směruje požadavky na pozadí na shannon-1.6-lite, který se počítá v tokenech. Názvy relací a podobné požadavky pak nespotřebovávají volání Coder.
• Claude Code se ptá POST /v1/messages/count_tokens na velikost kontextu. Endpoint počítá pro hostované modely s otevřenými váhami. U id Shannon odpoví 400; Claude Code považuje počítání tokenů za volitelné a velikost odhadne sám. Počítání tokenů

Chcete-li před spuštěním nástroje ověřit adresu, klíč a id modelu, pošlete ručně jeden požadavek:

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. Popište Shannon jako poskytovatele modelů v ~/.codex/config.toml, vyberte tam id modelu Shannon a svůj API klíč dejte do proměnné prostředí, kterou poskytovatel uvádí.

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ává na serveru žádnou konverzaci: každý požadavek nese konverzaci v input. previous_response_id se přijímá kvůli kompatibilitě.
• Nástroje typu funkce (type: "function") se modelu na /v1/responses nabízejí.
• Na /v1/responses se shannon-coder-1 počítá v tokenech z vašeho zůstatku, ne ve voláních Coder.

Stejná kontrola pro 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."
  }'

Programovací model a jak se počítá

shannon-coder-1 je model Shannon pro programovací agenty. GET /v1/models jej hlásí s kontextovým oknem 131,072 tokenů, voláním nástrojů, uvažováním a textovým vstupem. Počítá se jedním ze dvou způsobů, podle endpointu, který nástroj používá.

Volání je jeden požadavek, bez ohledu na jeho velikost. Počítá se, když je požadavek přijat, dřív než model odpoví. Relace agenta posílá jeden požadavek na každý krok, který udělá, takže dlouhý úkol spotřebuje mnoho volání. Limit závisí na vašem plánu a začíná znovu každé 4 hodiny, v 00:00, 04:00, 08:00, 12:00, 16:00 a 20:00 UTC.

Aktuální čísla ukazuje stránka plánu. Plány

Když jsou volání okna vyčerpána, na požadavek se odpoví 429. Na /v1/messages přichází stejná chyba ve tvaru 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"
  }
}

Přetečení kontextu

Když je konverzace větší než kontextové okno modelu, /v1/chat/completions a /v1/messages odpoví 400, typem invalid_request_error, kódem context_length_exceeded a zprávou, která začíná prompt is too long. Programovací nástroje tuto chybu čtou, aby relaci zhušťily a požadavek poslaly znovu. Vytvářejí ji 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
  }
}

Zpráva je prompt is too long: <sent> tokens > <limit> maximum. Když obě čísla nejsou známa, je to prompt is too long. Please compact the conversation and try again.

Ve streamu je stav už 200, takže chyba přichází jako událost a stream se pak zavře běžným způsobem:

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 co se může smyčka agenta spolehnout

Řešení potíží

Váš klíč a váš zůstatek najdete na stránce Klíče a využití. Klíče a využití