CLI-kodeværktøjer

Et kodeværktøj skal bruge tre indstillinger for at virke med Shannon: API'ets base-URL, din API-nøgle og et Shannon-model-id. Denne side giver de præcise indstillinger for Claude Code og Codex CLI, forklarer, hvordan kodemodellen shannon-coder-1 tælles, og opregner de fejl, disse værktøjer møder.

Hvilket endpoint hvert værktøj bruger

Alle tre endpoints tager den samme API-nøgle, som Authorization: Bearer eller som x-api-key. Headerne anthropic-version, anthropic-beta og openai-beta, som disse værktøjer sender, accepteres.

Vælg en Shannon-model

Hver anmodning skal angive et model-id, som Shannon udgiver. Et kodeværktøj sender navnet på sin egen standardmodel, medmindre du siger andet, og et navn, som Shannon ikke udgiver, besvares med 400 og beskeden unknown model: <name>. Intet andet navn afbildes på en Shannon-model, så angiv modellen i værktøjet før den første anmodning.

GET /v1/models viser hvert id med dets kontekstvindue. Det kræver ingen nøgle. Modeller og priser

Kodeværktøjer styrer modellen med en lang system prompt. System prompten anvendes af shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro og de hostede open-weight-modeller, så vælg en af disse til et kodeværktøj.

Claude Code

Claude Code læser sin forbindelse fra miljøvariabler. Angiv dem i den shell, der starter den, eller i env-blokken i ~/.claude/settings.json for at beholde dem til hver 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"
  }
}

• Angiv alle tre ANTHROPIC_DEFAULT_…_MODEL-variabler. Subagenter og nogle kommandoer beder om en model ved dens indbyggede navn, og hvert navn skal oversættes til et Shannon-id.
• Eksemplet peger baggrundsanmodninger på shannon-1.6-lite, som tælles i tokens. Sessionstitler og lignende anmodninger bruger så ikke Coder-kald.
• Claude Code beder POST /v1/messages/count_tokens om kontekstens størrelse. Endpointet tæller for de hostede open-weight-modeller. Med et Shannon-id svarer det 400; Claude Code behandler tokentælling som valgfri og vurderer størrelsen selv. Tælling af tokens

For at kontrollere adressen, nøglen og et model-id, før du starter værktøjet, kan du sende en anmodning i hånden:

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 taler med Responses API'et. Beskriv Shannon som en modeludbyder i ~/.codex/config.toml, vælg dér et Shannon-model-id, og læg din API-nøgle i den miljøvariabel, udbyderen angiver.

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 gemmer ingen samtale på serveren: hver anmodning bærer samtalen i input. previous_response_id accepteres af hensyn til kompatibilitet.
• Funktionsværktøjer (type: "function") tilbydes modellen på /v1/responses.
• På /v1/responses tælles shannon-coder-1 i tokens fra din saldo, ikke i Coder-kald.

Den samme kontrol for Responses-endpointet:

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 tælles

shannon-coder-1 er Shannon-modellen til kodeagenter. GET /v1/models rapporterer den med et kontekstvindue på 131,072 tokens, værktøjskald, reasoning og tekstinput. Den tælles på en af to måder, afhængigt af hvilket endpoint et værktøj bruger.

Et kald er én anmodning, uanset størrelse. Det tælles, når anmodningen accepteres, før modellen svarer. En agentsession sender én anmodning for hvert trin, den tager, så en lang opgave bruger mange kald. Kvoten afhænger af din plan og starter forfra hver 4. time, kl. 00:00, 04:00, 08:00, 12:00, 16:00 og 20:00 UTC.

Plansiden viser de aktuelle tal. Planer

Når et vindues kald er brugt op, besvares anmodningen med 429. På /v1/messages kommer den samme fejl 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"
  }
}

Overskridelse af konteksten

Når en samtale er større end modellens kontekstvindue, svarer /v1/chat/completions og /v1/messages med 400, typen invalid_request_error, koden context_length_exceeded og en besked, der begynder med prompt is too long. Kodeværktøjer læser denne fejl for at komprimere sessionen og sende anmodningen igen. Den frembringes af 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
  }
}

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

På en stream er status allerede 200, så fejlen kommer som en hændelse, og streamen lukker derefter på normal vis:

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

Hvad en agentløkke kan regne med

Fejlfinding

Din nøgle og din saldo findes på siden Nøgler og forbrug. Nøgler og forbrug