CLI-verktøy for koding

Et kodeverktøy trenger tre innstillinger for å fungere med Shannon: base-URL-en til API-et, API-nøkkelen din og en Shannon-modell-id. Denne siden gir de nøyaktige innstillingene for Claude Code og Codex CLI, forklarer hvordan kodemodellen shannon-coder-1 telles, og lister feilene disse verktøyene møter.

Hvilket endepunkt hvert verktøy bruker

Alle tre endepunktene tar samme API-nøkkel, som Authorization: Bearer eller som x-api-key. Headerne anthropic-version, anthropic-beta og openai-beta som disse verktøyene sender, godtas.

Velg en Shannon-modell

Hver forespørsel må oppgi en modell-id som Shannon publiserer. Et kodeverktøy sender navnet på sin egen standardmodell med mindre du sier noe annet, og et navn Shannon ikke publiserer, besvares med 400 og meldingen unknown model: <name>. Ingen andre navn kobles til en Shannon-modell, så sett modellen i verktøyet før den første forespørselen.

GET /v1/models lister hver id med kontekstvindu. Det trenger ingen nøkkel. Modeller og priser

Kodeverktøy styrer modellen med en lang systemprompt. Systemprompten brukes av shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro og de hostede åpne vektmodellene, så velg en av disse for et kodeverktøy.

Claude Code

Claude Code leser forbindelsen sin fra miljøvariabler. Sett dem i skallet som starter det, eller i env-blokken i ~/.claude/settings.json for å beholde dem for hver økt.

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

• Sett alle tre ANTHROPIC_DEFAULT_…_MODEL-variablene. Subagenter og noen kommandoer ber om en modell med det innebygde navnet, og hvert navn må løses til en Shannon-id.
• Eksempelet peker bakgrunnsforespørsler mot shannon-1.6-lite, som telles i tokens. Øktitler og lignende forespørsler bruker da ikke Coder-kall.
• Claude Code ber POST /v1/messages/count_tokens om størrelsen på konteksten. Endepunktet teller for de hostede åpne vektmodellene. Med en Shannon-id svarer det 400; Claude Code behandler token-telling som valgfritt og anslår størrelsen selv. Token-telling

For å sjekke adressen, nøkkelen og en modell-id før du starter verktøyet, send én forespørsel for hånd:

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 snakker med Responses API. Beskriv Shannon som en modellleverandør i ~/.codex/config.toml, velg en Shannon-modell-id der, og legg API-nøkkelen din i miljøvariabelen leverandøren oppgir.

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 lagrer ingen samtale på serveren: hver forespørsel har samtalen i input. previous_response_id godtas for kompatibilitet.
• Funksjonsverktøy (type: "function") tilbys modellen på /v1/responses.
• På /v1/responses telles shannon-coder-1 i tokens fra saldoen din, ikke i Coder-kall.

Den samme sjekken for Responses-endepunktet:

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

Kodemodellen og hvordan den telles

shannon-coder-1 er Shannon-modellen for kodeagenter. GET /v1/models rapporterer den med et kontekstvindu på 131,072 tokens, verktøykall, resonnering og tekst som input. Den telles på én av to måter, avhengig av endepunktet et verktøy bruker.

Et kall er én forespørsel, uansett størrelse. Det telles når forespørselen godtas, før modellen svarer. En agentøkt sender én forespørsel for hvert steg den tar, så en lang oppgave bruker mange kall. Kvoten avhenger av planen din og starter på nytt hver 4. time, kl. 00:00, 04:00, 08:00, 12:00, 16:00 og 20:00 UTC.

Planssiden viser de gjeldende tallene. Planer

Når kallene i et vindu er brukt opp, besvares forespørselen med 429. På /v1/messages kommer den samme feilen i Anthropic-formen.

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

Overskredet kontekst

Når en samtale er større enn kontekstvinduet til modellen, svarer /v1/chat/completions og /v1/messages med 400, typen invalid_request_error, koden context_length_exceeded og en melding som begynner med prompt is too long. Kodeverktøy leser denne feilen for å komprimere økten og sende forespørselen på nytt. Den produseres av shannon-coder-1, shannon-1.6-lite og 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
  }
}

Meldingen er prompt is too long: <sent> tokens > <limit> maximum. Når de to tallene ikke er kjent, er den prompt is too long. Please compact the conversation and try again.

På en strøm er statusen allerede 200, så feilen kommer som en hendelse, og strømmen lukkes deretter på vanlig måte:

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

Hva en agentsløyfe kan stole på

Feilsøking

Nøkkelen og saldoen din finner du på siden Nøkler og bruk. Nøkler og bruk