CLI-Coding-Tools

En Coding-Tool brauch dräi Astellungen, fir mat Shannon ze schaffen: d'Basis-URL vun der API, Ären API-Schlëssel an eng Shannon-Modell-ID. Dës Säit weist déi exakt Astellunge fir Claude Code a Codex CLI, erkläert, wéi de Coding-Modell shannon-coder-1 gezielt gëtt, a lëscht d'Feeler op, déi dës Tools begéinen.

Wéi en Endpoint jiddereng Tool benotzt

All dräi Endpoints huelen deeselwechte API-Schlëssel un, als Authorization: Bearer oder als x-api-key. D'Headers anthropic-version, anthropic-beta an openai-beta, déi dës Tools schécken, ginn akzeptéiert.

Ee Shannon-Modell auswielen

All Ufro muss eng Modell-ID nennen, déi Shannon publizéiert. E Coding-Tool schéckt den Numm vu sengem eegene Standardmodell, wann Dir him näischt anescht soot, an e Numm, deen Shannon net publizéiert, gëtt mat 400 a mat der Message unknown model: <name> beäntwert. Kee ale Numm gëtt op e Shannon-Modell ofgebilt, setzt de Modell dofir am Tool, ier déi éischt Ufro geschéckt gëtt.

GET /v1/models lëscht all ID mat hirem Kontextfënster op. Et brauch kee Schlëssel. Modeller a Präisser

Coding-Tools steieren de Modell mat engem laange System-Prompt. De System-Prompt gëtt vu shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro an de Hosted Open-Weight-Modeller ugewannt, wielt dofir eng vun dësen aus fir e Coding-Tool.

Claude Code

Claude Code liest seng Verbindung aus Ëmgebungsvariabelen. Setzt se an der Shell, déi et start, oder am env-Block vun ~/.claude/settings.json, fir se fir all Sessioun ze behalen.

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

• Setzt all dräi ANTHROPIC_DEFAULT_…_MODEL-Variabelen. Subagenten an e puer Kommandoen froen no engem Modell mat sengem agebaute Numm, an all Numm muss op eng Shannon-ID opgeléist ginn.
• Am Beispill ginn Hannergrondufroen op shannon-1.6-lite geriicht, dat a Tokens gezielt gëtt. Sessiounstitelen an ähnlech Ufroen benotzen dann keng Coder-Ufruffer.
• Claude Code freet POST /v1/messages/count_tokens no der Gréisst vum Kontext. Den Endpoint zielt fir d'Hosted Open-Weight-Modeller. Bei enger Shannon-ID äntwert hien mat 400; Claude Code behandelt d'Token-Zielung als optional a schätzt d'Gréisst selwer. Tokenzielung

Fir d'Adress, de Schlëssel an eng Modell-ID ze préifen, éier Dir d'Tool start, schéckt eng Ufro vun 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 schwätzt mat der Responses-API. Beschreift Shannon als Modell-Provider an ~/.codex/config.toml, wielt do eng Shannon-Modell-ID aus, a setzt Ären API-Schlëssel an déi Ëmgebungsvariabel, déi de 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 behält kee Gespréich um Server: all Ufro dréit d'Gespréich an input. previous_response_id gëtt fir Kompatibilitéit akzeptéiert.
• Funktiouns-Tools (type: "function") ginn dem Modell op /v1/responses ugebueden.
• Op /v1/responses gëtt shannon-coder-1 a Tokens vun Ärem Solde gezielt, net a Coder-Ufruffer.

Déiselwecht Kontroll fir den Responses-Endpoint:

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

Dat Coding-Modell a wéi et gezielt gëtt

shannon-coder-1 ass dat Shannon-Modell fir Coding-Agenten. GET /v1/models mellt et mat enger Kontextfënster vun 131,072 Tokens, Tool-Ufruffer, Reasoning an Text-Input. Et gëtt op eng vun zwou Manéieren gezielt, jee no Endpoint, deen eng Tool benotzt.

Ee Opruff ass eng Ufro, egal wéi grouss. Hie gëtt gezielt, wann d'Ufro ugeholl gëtt, éier de Modell äntwert. Eng Agent-Sessioun schéckt eng Ufro fir all Schrëtt, deen si mécht, dofir verbraucht eng laang Aufgab vill Ufruffer. D'Zuelung hänkt vun Ärem Plan of a fänkt all 4 Stonnen nei un, um 00:00, 04:00, 08:00, 12:00, 16:00 an 20:00 UTC.

D'Plan-Säit weist déi aktuell Zuelen. Pläng

Wann d'Ufruffer vun engem Fënster opgebraucht sinn, gëtt d'Ufro mat 429 beäntwert. Op /v1/messages kënnt dee selwechte Feeler an 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-Iwwerlaf

Wann eng Konversatioun méi grouss ass wéi d'Kontextfënster vum Modell, äntwerte /v1/chat/completions an /v1/messages mat 400, dem Typ invalid_request_error, dem Code context_length_exceeded an enger Message, déi mat prompt is too long ufänkt. Coding-Tools liesen dëse Feeler, fir d'Sessioun ze kompaktéieren an d'Ufro nach eng Kéier ze schécken. Hie gëtt vu shannon-coder-1, shannon-1.6-lite a shannon-1.6-pro produzéiert.

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

D'Message ass prompt is too long: <sent> tokens > <limit> maximum. Wann déi zwou Zuelen net bekannt sinn, ass et prompt is too long. Please compact the conversation and try again.

Bei engem Stream ass de Status schonn 200, dofir kënnt de Feeler als Event an de Stream gëtt dono normal zougemaach:

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

Wuerop sech eng Agent-Loop kann verloossen

Problemléisung

Äre Schlëssel an Äre Solde stinn op der Säit Schlësselen & Notzung. Schlësselen & Notzung