CLI-Coding-Tools

Ein Coding-Tool braucht drei Einstellungen, um mit Shannon zu arbeiten: die Base-URL der API, Ihren API-Key und eine Shannon-Modell-ID. Diese Seite nennt die genauen Einstellungen für Claude Code und Codex CLI, erklärt, wie das Coding-Modell shannon-coder-1 gezählt wird, und listet die Fehler auf, auf die diese Tools stoßen.

Welchen Endpunkt jedes Tool verwendet

Alle drei Endpunkte nehmen denselben API-Key an, als Authorization: Bearer oder als x-api-key. Die Header anthropic-version, anthropic-beta und openai-beta, die diese Tools senden, werden akzeptiert.

Ein Shannon-Modell auswählen

Jede Anfrage muss eine Modell-ID nennen, die Shannon veröffentlicht. Ein Coding-Tool sendet den Namen seines eigenen Standardmodells, wenn Sie nichts anderes festlegen, und ein Name, den Shannon nicht veröffentlicht, wird mit 400 und der Nachricht unknown model: <name> beantwortet. Kein anderer Name wird auf ein Shannon-Modell abgebildet, setzen Sie das Modell daher im Tool, bevor Sie die erste Anfrage senden.

GET /v1/models listet jede ID mit ihrem Kontextfenster auf. Es braucht keinen Key. Modelle & Preise

Coding-Tools steuern das Modell mit einem langen System-Prompt. Der System-Prompt wird von shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro und den gehosteten Open-Weight-Modellen angewendet, wählen Sie daher für ein Coding-Tool eines davon.

Claude Code

Claude Code liest seine Verbindung aus Umgebungsvariablen. Setzen Sie sie in der Shell, die es startet, oder im Block env von ~/.claude/settings.json, um sie für jede Sitzung zu behalten.

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

• Setzen Sie alle drei Variablen ANTHROPIC_DEFAULT_…_MODEL. Subagenten und einige Befehle fordern ein Modell unter seinem eingebauten Namen an, und jeder Name muss auf eine Shannon-ID aufgelöst werden.
• Das Beispiel richtet Hintergrundanfragen auf shannon-1.6-lite, das in Tokens gezählt wird. Sitzungstitel und ähnliche Anfragen verbrauchen dann keine Coder-Aufrufe.
• Claude Code fragt bei POST /v1/messages/count_tokens nach der Größe des Kontexts. Der Endpunkt zählt für die gehosteten Open-Weight-Modelle. Bei einer Shannon-ID antwortet er mit 400; Claude Code behandelt das Token-Zählen als optional und schätzt die Größe selbst. Token zählen

Um Adresse, Key und Modell-ID zu prüfen, bevor Sie das Tool starten, senden Sie eine Anfrage von Hand:

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 spricht mit der Responses API. Beschreiben Sie Shannon als Modell-Provider in ~/.codex/config.toml, wählen Sie dort eine Shannon-Modell-ID und tragen Sie Ihren API-Key in die Umgebungsvariable ein, die der Provider nennt.

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 speichert keine Konversation auf dem Server: Jede Anfrage trägt die Konversation in input. previous_response_id wird aus Kompatibilitätsgründen akzeptiert.
• Funktions-Tools (type: "function") werden dem Modell bei /v1/responses angeboten.
• Bei /v1/responses wird shannon-coder-1 in Tokens von Ihrem Guthaben gezählt, nicht in Coder-Aufrufen.

Dieselbe Prüfung für den Responses-Endpunkt:

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

Das Coding-Modell und wie es gezählt wird

shannon-coder-1 ist das Shannon-Modell für Coding-Agenten. GET /v1/models meldet es mit einem Kontextfenster von 131,072 Tokens, Tool-Aufrufen, Reasoning und Text-Input. Es wird auf eine von zwei Arten gezählt, je nach Endpunkt, den ein Tool verwendet.

Ein Aufruf ist eine Anfrage, unabhängig von ihrer Größe. Er wird gezählt, wenn die Anfrage angenommen wird, bevor das Modell antwortet. Eine Agent-Sitzung sendet für jeden Schritt eine Anfrage, daher verbraucht eine lange Aufgabe viele Aufrufe. Das Kontingent hängt von Ihrem Plan ab und beginnt alle 4 Stunden neu, um 00:00, 04:00, 08:00, 12:00, 16:00 und 20:00 UTC.

Die Plan-Seite zeigt die aktuellen Zahlen. Pläne

Sind die Aufrufe eines Fensters aufgebraucht, wird die Anfrage mit 429 beantwortet. Bei /v1/messages kommt derselbe Fehler in der Anthropic-Form.

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

Kontextüberlauf

Ist eine Konversation größer als das Kontextfenster des Modells, antworten /v1/chat/completions und /v1/messages mit 400, dem Typ invalid_request_error, dem Code context_length_exceeded und einer Nachricht, die mit prompt is too long beginnt. Coding-Tools lesen diesen Fehler, um die Sitzung zu kompaktieren und die Anfrage erneut zu senden. Er wird von shannon-coder-1, shannon-1.6-lite und shannon-1.6-pro erzeugt.

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

Die Nachricht lautet prompt is too long: <sent> tokens > <limit> maximum. Sind die beiden Zahlen nicht bekannt, lautet sie prompt is too long. Please compact the conversation and try again.

Bei einem Stream ist der Status bereits 200, daher trifft der Fehler als Event ein, und der Stream wird danach normal geschlossen:

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

Worauf sich eine Agent-Schleife verlassen kann

Fehlerbehebung

Ihren Key und Ihr Guthaben finden Sie auf der Seite Keys & Nutzung. Keys & Nutzung