CLI-codeertools

Een codeertool heeft drie instellingen nodig om met Shannon te werken: de basis-URL van de API, je API-sleutel en een Shannon model-id. Deze pagina geeft de exacte instellingen voor Claude Code en Codex CLI, legt uit hoe het codeermodel shannon-coder-1 wordt geteld en toont de fouten die deze tools tegenkomen.

Welk endpoint elke tool gebruikt

Alle drie de endpoints accepteren dezelfde API-sleutel, als Authorization: Bearer of als x-api-key. De headers anthropic-version, anthropic-beta en openai-beta die deze tools versturen, worden geaccepteerd.

Een Shannon-model kiezen

Elke aanvraag moet een model-id noemen dat Shannon publiceert. Een codeertool stuurt de naam van zijn eigen standaardmodel mee, tenzij je hem iets anders opgeeft, en een naam die Shannon niet publiceert, wordt beantwoord met 400 en het bericht unknown model: <name>. Geen enkele andere naam wordt aan een Shannon-model gekoppeld, dus stel het model in de tool in vóór de eerste aanvraag.

GET /v1/models toont elk id met zijn contextvenster. Er is geen sleutel voor nodig. Modellen en prijzen

Codeertools sturen het model aan met een lange systeemprompt. De systeemprompt wordt toegepast door shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro en de gehoste open-weight modellen, dus kies voor een codeertool een van deze.

Claude Code

Claude Code leest zijn verbinding uit omgevingsvariabelen. Stel ze in de shell in waarmee je het start, of in het env-blok van ~/.claude/settings.json om ze voor elke sessie te behouden.

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

• Stel alle drie de ANTHROPIC_DEFAULT_…_MODEL-variabelen in. Subagents en sommige commando's vragen om een model met zijn ingebouwde naam, en elke naam moet naar een Shannon-id verwijzen.
• Het voorbeeld richt achtergrondaanvragen op shannon-1.6-lite, dat in tokens wordt geteld. Sessietitels en vergelijkbare aanvragen gebruiken dan geen Coder-calls.
• Claude Code vraagt via POST /v1/messages/count_tokens naar de grootte van de context. Het endpoint telt voor de gehoste open-weight modellen. Met een Shannon-id antwoordt het 400; Claude Code behandelt tokentelling als optioneel en schat de grootte zelf. Tokens tellen

Om het adres, de sleutel en een model-id te controleren voordat je de tool start, stuur je met de hand één aanvraag:

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 praat met de Responses API. Beschrijf Shannon als modelprovider in ~/.codex/config.toml, kies daar een Shannon model-id en zet je API-sleutel in de omgevingsvariabele die de provider noemt.

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 bewaart geen gesprek op de server: elke aanvraag bevat het gesprek in input. previous_response_id wordt voor compatibiliteit geaccepteerd.
• Functietools (type: "function") worden op /v1/responses aan het model aangeboden.
• Op /v1/responses wordt shannon-coder-1 in tokens van je saldo geteld, niet in Coder-calls.

Dezelfde controle voor het 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."
  }'

Het codeermodel en hoe het wordt geteld

shannon-coder-1 is het Shannon-model voor codeeragents. GET /v1/models meldt het met een contextvenster van 131,072 tokens, toolcalls, reasoning en tekst als input. Het wordt op een van twee manieren geteld, afhankelijk van het endpoint dat een tool gebruikt.

Een call is één aanvraag, ongeacht de grootte. Ze wordt geteld op het moment dat de aanvraag wordt geaccepteerd, voordat het model antwoordt. Een agentsessie stuurt voor elke stap één aanvraag, dus een lange taak gebruikt veel calls. De limiet hangt af van je plan en begint elke 4 uur opnieuw, om 00:00, 04:00, 08:00, 12:00, 16:00 en 20:00 UTC.

De planpagina toont de huidige aantallen. Plannen

Als de calls van een venster op zijn, wordt de aanvraag beantwoord met 429. Op /v1/messages komt dezelfde fout in de Anthropic-vorm.

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

Contextoverloop

Als een gesprek groter is dan het contextvenster van het model, antwoorden /v1/chat/completions en /v1/messages met 400, het type invalid_request_error, de code context_length_exceeded en een bericht dat met prompt is too long begint. Codeertools lezen deze fout om de sessie te comprimeren en de aanvraag opnieuw te versturen. Ze wordt geleverd door shannon-coder-1, shannon-1.6-lite en 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
  }
}

Het bericht is prompt is too long: <sent> tokens > <limit> maximum. Als de twee getallen niet bekend zijn, is het prompt is too long. Please compact the conversation and try again.

Bij een stream is de status al 200, dus de fout komt binnen als event en de stream sluit daarna op de normale manier:

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

Waar een agentloop op kan rekenen

Probleemoplossing

Je sleutel en je saldo staan op de pagina Sleutels en gebruik. Sleutels en gebruik