Orodja CLI za programiranje

Orodje za programiranje potrebuje tri nastavitve za delo s Shannon: osnovni URL API-ja, vaš API ključ in id modela Shannon. Ta stran navaja natančne nastavitve za Claude Code in Codex CLI, pojasnjuje, kako se šteje model za programiranje shannon-coder-1, in navaja napake, na katere ta orodja naletijo.

Kateri endpoint uporablja posamezno orodje

Vsi trije endpointi sprejmejo isti API ključ, kot Authorization: Bearer ali kot x-api-key. Glave anthropic-version, anthropic-beta in openai-beta, ki jih ta orodja pošiljajo, so sprejete.

Izberite model Shannon

Vsak zahtevek mora navesti id modela, ki ga Shannon objavlja. Orodje za programiranje pošlje ime svojega privzetega modela, razen če mu rečete drugače, na ime, ki ga Shannon ne objavlja, pa se odgovori s 400 in sporočilom unknown model: <name>. Nobeno drugo ime ni preslikano v model Shannon, zato model v orodju nastavite pred prvim zahtevkom.

GET /v1/models navede vsak id z njegovim kontekstnim oknom. Ključa ne potrebuje. Modeli in cene

Orodja za programiranje model usmerjajo z dolgim sistemskim promptom. Sistemski prompt upoštevajo shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro in gostovani modeli z odprtimi utežmi, zato za orodje za programiranje izberite enega od teh.

Claude Code

Claude Code prebere svojo povezavo iz spremenljivk okolja. Nastavite jih v lupini, ki ga zažene, ali v bloku env datoteke ~/.claude/settings.json, da veljajo za vsako sejo.

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

• Nastavite vse tri spremenljivke ANTHROPIC_DEFAULT_…_MODEL. Podagenti in nekateri ukazi zahtevajo model po vgrajenem imenu, vsako ime pa mora razrešiti v id Shannon.
• Vzorec usmeri zahtevke v ozadju na shannon-1.6-lite, ki se šteje v tokenih. Naslovi sej in podobni zahtevki tako ne porabljajo klicev Coder.
• Claude Code pri POST /v1/messages/count_tokens sprašuje po velikosti konteksta. Endpoint šteje za gostovane modele z odprtimi utežmi. Pri id-ju Shannon odgovori 400; Claude Code obravnava štetje tokenov kot neobvezno in velikost oceni sam. Štetje tokenov

Da naslov, ključ in id modela preverite, preden zaženete orodje, ročno pošljite en zahtevek:

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 komunicira z API-jem Responses. Shannon opišite kot ponudnika modelov v ~/.codex/config.toml, tam izberite id modela Shannon, API ključ pa postavite v spremenljivko okolja, ki jo ponudnik navaja.

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 na strežniku ne hrani pogovora: vsak zahtevek nosi pogovor v input. previous_response_id je sprejet zaradi združljivosti.
• Orodja tipa funkcija (type: "function") se modelu ponudijo na /v1/responses.
• Na /v1/responses se shannon-coder-1 šteje v tokenih z vašega stanja, ne v klicih Coder.

Isto preverjanje za 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."
  }'

Model za programiranje in kako se šteje

shannon-coder-1 je model Shannon za agente za programiranje. GET /v1/models ga sporoča s kontekstnim oknom 131,072 tokenov, klici orodij, razmišljanjem in vhodom z besedilom. Šteje se na enega od dveh načinov, odvisno od endpointa, ki ga uporablja orodje.

Klic je en zahtevek, ne glede na velikost. Šteje se, ko je zahtevek sprejet, preden model odgovori. Seja agenta pošlje en zahtevek za vsak korak, zato dolga naloga porabi veliko klicev. Kvota je odvisna od vašega paketa in se obnovi vsake 4 ure, ob 00:00, 04:00, 08:00, 12:00, 16:00 in 20:00 UTC.

Stran paketov prikazuje trenutna števila. Paketi

Ko so klici okna porabljeni, se na zahtevek odgovori s 429. Na /v1/messages pride ista napaka v obliki 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"
  }
}

Prekoračitev konteksta

Kadar je pogovor večji od kontekstnega okna modela, /v1/chat/completions in /v1/messages odgovorita s 400, tipom invalid_request_error, kodo context_length_exceeded in sporočilom, ki se začne s prompt is too long. Orodja za programiranje to napako preberejo, da sejo strnejo in zahtevek pošljejo znova. Ustvarijo jo shannon-coder-1, shannon-1.6-lite in 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
  }
}

Sporočilo je prompt is too long: <sent> tokens > <limit> maximum. Kadar obe števili nista znani, je prompt is too long. Please compact the conversation and try again.

V toku je status že 200, zato napaka prispe kot dogodek, tok pa se nato zapre na običajen način:

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 kaj se lahko zanese zanka agenta

Odpravljanje težav

Vaš ključ in stanje sta na strani Ključi in poraba. Ključi in poraba