CLI-verktyg för kodning

Ett kodningsverktyg behöver tre inställningar för att fungera med Shannon: API:ets bas-URL, din API-nyckel och ett Shannon-modell-id. Den här sidan ger de exakta inställningarna för Claude Code och Codex CLI, förklarar hur kodningsmodellen shannon-coder-1 räknas och listar de fel som verktygen möter.

Vilken endpoint varje verktyg använder

Alla tre endpoints tar samma API-nyckel, som Authorization: Bearer eller som x-api-key. Headrarna anthropic-version, anthropic-beta och openai-beta som de här verktygen skickar accepteras.

Välj en Shannon-modell

Varje begäran måste ange ett modell-id som Shannon publicerar. Ett kodningsverktyg skickar namnet på sin egen standardmodell om du inte säger något annat, och ett namn som Shannon inte publicerar besvaras med 400 och meddelandet unknown model: <name>. Inget annat namn mappas till en Shannon-modell, så ange modellen i verktyget före den första begäran.

GET /v1/models listar varje id med dess kontextfönster. Den kräver ingen nyckel. Modeller och priser

Kodningsverktyg styr modellen med en lång systemprompt. Systemprompten tillämpas av shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro och de hostade open-weight-modellerna, så välj en av dessa för ett kodningsverktyg.

Claude Code

Claude Code läser sin anslutning från miljövariabler. Ange dem i det skal som startar det, eller i env-blocket i ~/.claude/settings.json för att behålla dem i varje session.

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

• Ange alla tre variablerna ANTHROPIC_DEFAULT_…_MODEL. Subagenter och vissa kommandon ber om en modell med dess inbyggda namn, och varje namn måste peka på ett Shannon-id.
• Exemplet pekar bakgrundsbegäranden mot shannon-1.6-lite, som räknas i tokens. Sessionstitlar och liknande begäranden använder då inga Coder-anrop.
• Claude Code frågar POST /v1/messages/count_tokens om kontextens storlek. Endpointen räknar för de hostade open-weight-modellerna. Med ett Shannon-id svarar den 400; Claude Code behandlar tokenräkning som valfri och uppskattar storleken själv. Tokenräkning

För att kontrollera adressen, nyckeln och ett modell-id innan du startar verktyget, skicka en begäran för 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 pratar med Responses API. Beskriv Shannon som modellleverantör i ~/.codex/config.toml, välj ett Shannon-modell-id där och lägg din API-nyckel i den miljövariabel som leverantören anger.

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 sparar ingen konversation på servern: varje begäran bär konversationen i input. previous_response_id accepteras för kompatibilitet.
• Funktionsverktyg (type: "function") erbjuds modellen på /v1/responses.
• På /v1/responses räknas shannon-coder-1 i tokens från din balans, inte i Coder-anrop.

Samma kontroll för Responses-endpointen:

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

Kodningsmodellen och hur den räknas

shannon-coder-1 är Shannon-modellen för kodningsagenter. GET /v1/models anger den med ett kontextfönster på 131,072 tokens, verktygsanrop, resonemang och textinput. Den räknas på ett av två sätt, beroende på vilken endpoint ett verktyg använder.

Ett anrop är en begäran, oavsett storlek. Det räknas när begäran accepteras, innan modellen svarar. En agentsession skickar en begäran för varje steg den tar, så en lång uppgift förbrukar många anrop. Kvoten beror på din plan och börjar om var 4:e timme, kl. 00:00, 04:00, 08:00, 12:00, 16:00 och 20:00 UTC.

Plansidan visar de aktuella talen. Planer

När ett fönsters anrop är förbrukade besvaras begäran med 429. På /v1/messages kommer samma fel i Anthropics 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överskridande

När en konversation är större än modellens kontextfönster svarar /v1/chat/completions och /v1/messages med 400, typen invalid_request_error, koden context_length_exceeded och ett meddelande som börjar med prompt is too long. Kodningsverktyg läser det här felet för att komprimera sessionen och skicka begäran igen. Det skapas av shannon-coder-1, shannon-1.6-lite och 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
  }
}

Meddelandet är prompt is too long: <sent> tokens > <limit> maximum. När de två talen inte är kända är det prompt is too long. Please compact the conversation and try again.

På en ström är statusen redan 200, så felet kommer som en händelse och strömmen stängs sedan på normalt sätt:

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

Vad en agentloop kan lita på

Felsökning

Din nyckel och din balans finns på sidan Nycklar och användning. Nycklar och användning