CLI kódoló eszközök

Egy kódoló eszköznek három beállítás kell, hogy a Shannonnal működjön: az API alap URL-je, az API-kulcsod és egy Shannon modellazonosító. Ez az oldal megadja a pontos beállításokat a Claude Code-hoz és a Codex CLI-hez, elmagyarázza, hogyan számít a shannon-coder-1 kódoló modell, és felsorolja azokat a hibákat, amelyekkel ezek az eszközök találkoznak.

Melyik eszköz melyik végpontot használja

Mindhárom végpont ugyanazt az API-kulcsot fogadja, Authorization: Bearer vagy x-api-key fejlécként. Az anthropic-version, anthropic-beta és openai-beta fejléceket, amelyeket ezek az eszközök küldenek, elfogadja a rendszer.

Shannon modell kiválasztása

Minden kérésnek meg kell neveznie egy olyan modellazonosítót, amelyet a Shannon közzétesz. A kódoló eszköz a saját alapértelmezett modelljének nevét küldi, hacsak nem mondod meg neki másképp, és a Shannon által nem közzétett névre 400 a válasz unknown model: <name> üzenettel. Más nevet nem képez le Shannon modellre, ezért az első kérés előtt állítsd be a modellt az eszközben.

A GET /v1/models minden azonosítót felsorol a kontextusablakával. Nem kell hozzá kulcs. Modellek és árak

A kódoló eszközök hosszú rendszerprompttal irányítják a modellt. A rendszerpromptot a shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro és a hosztolt nyílt súlyú modellek alkalmazzák, ezért kódoló eszközhöz ezek egyikét válaszd.

Claude Code

A Claude Code a kapcsolatát környezeti változókból olvassa. Állítsd be őket abban a shellben, amely elindítja, vagy a ~/.claude/settings.json env blokkjában, hogy minden munkamenetre megmaradjanak.

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

• Állítsd be mindhárom ANTHROPIC_DEFAULT_…_MODEL változót. A subagentek és egyes parancsok a beépített nevén kérnek modellt, és minden névnek Shannon azonosítóra kell feloldódnia.
• A minta a háttérkéréseket a shannon-1.6-lite modellre irányítja, amely tokenben számít. A munkamenetcímek és hasonló kérések így nem használnak Coder hívást.
• A Claude Code a POST /v1/messages/count_tokens végponttól kérdezi a kontextus méretét. A végpont a hosztolt nyílt súlyú modelleknél számol. Shannon azonosítóval 400 a válasz; a Claude Code a tokenszámlálást opcionálisnak tekinti, és maga becsüli a méretet. Tokenszámlálás

A cím, a kulcs és a modellazonosító ellenőrzéséhez az eszköz indítása előtt küldj egy kérést kézzel:

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

A Codex CLI a Responses API-val beszél. Írd le a Shannont modellszolgáltatóként a ~/.codex/config.toml fájlban, válassz ott egy Shannon modellazonosítót, és tedd az API-kulcsodat a szolgáltató által megnevezett környezeti változóba.

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

• A /v1/responses nem tart fenn beszélgetést a szerveren: minden kérés az input mezőben viszi a beszélgetést. A previous_response_id kompatibilitás miatt elfogadott.
• A függvényeszközöket (type: "function") a /v1/responses felkínálja a modellnek.
• A /v1/responses végponton a shannon-coder-1 az egyenlegedből tokenben számít, nem Coder hívásban.

Ugyanez az ellenőrzés a Responses végpontra:

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

A kódoló modell és számítása

A shannon-coder-1 a Shannon modell kódoló agentekhez. A GET /v1/models 131,072 tokenes kontextusablakkal, eszközhívásokkal, reasoninggel és szövegbemenettel jelzi. Kétféleképpen számít, attól függően, melyik végpontot használja az eszköz.

A hívás egy kérés, méretétől függetlenül. A kérés elfogadásakor számít, még a modell válasza előtt. Az agent munkamenet minden lépéshez egy kérést küld, ezért egy hosszú feladat sok hívást használ. A keret a csomagodtól függ, és 4 óránként újraindul: 00:00, 04:00, 08:00, 12:00, 16:00 és 20:00 UTC-kor.

A csomagok oldala mutatja az aktuális számokat. Csomagok

Ha egy ablak hívásai elfogytak, a kérésre 429 a válasz. A /v1/messages végponton ugyanez a hiba Anthropic alakban jön.

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

Kontextus-túlcsordulás

Ha a beszélgetés nagyobb a modell kontextusablakánál, a /v1/chat/completions és a /v1/messages 400 hibával válaszol, invalid_request_error típussal, context_length_exceeded kóddal és prompt is too long kezdetű üzenettel. A kódoló eszközök ebből a hibából tudják, hogy tömöríteniük kell a munkamenetet, és újra elküldik a kérést. A shannon-coder-1, shannon-1.6-lite és shannon-1.6-pro adja.

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

Az üzenet prompt is too long: <sent> tokens > <limit> maximum. Ha a két szám nem ismert, prompt is too long. Please compact the conversation and try again.

Streamnél a státusz már 200, ezért a hiba eseményként érkezik, majd a stream a szokásos módon lezárul:

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

Amire egy agent ciklus számíthat

Hibaelhárítás

A kulcsod és az egyenleged a Keys & usage oldalon van. Keys & usage