Instrumente CLI pentru programare

Un instrument de programare are nevoie de trei setări pentru a funcționa cu Shannon: URL-ul de bază al API-ului, cheia ta API și un id de model Shannon. Această pagină oferă setările exacte pentru Claude Code și Codex CLI, explică cum este numărat modelul de programare shannon-coder-1 și listează erorile pe care le întâlnesc aceste instrumente.

Ce endpoint folosește fiecare instrument

Toate cele trei endpoint-uri acceptă aceeași cheie API, ca Authorization: Bearer sau ca x-api-key. Header-ele anthropic-version, anthropic-beta și openai-beta pe care le trimit aceste instrumente sunt acceptate.

Selectează un model Shannon

Fiecare cerere trebuie să indice un id de model pe care îl publică Shannon. Un instrument de programare trimite numele propriului model implicit dacă nu îi spui altceva, iar un nume pe care Shannon nu îl publică primește răspuns 400 și mesajul unknown model: <name>. Niciun alt nume nu este asociat unui model Shannon, deci setează modelul în instrument înainte de prima cerere.

GET /v1/models listează fiecare id cu fereastra lui de context. Nu necesită cheie. Modele și prețuri

Instrumentele de programare ghidează modelul cu un system prompt lung. System prompt-ul este aplicat de shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro și de modelele open-weight găzduite, deci selectează unul dintre acestea pentru un instrument de programare.

Claude Code

Claude Code își citește conexiunea din variabile de mediu. Setează-le în shell-ul care îl pornește sau în blocul env din ~/.claude/settings.json pentru a le păstra la fiecare sesiune.

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

• Setează toate cele trei variabile ANTHROPIC_DEFAULT_…_MODEL. Subagenții și unele comenzi cer un model după numele lui încorporat, iar fiecare nume trebuie să se rezolve într-un id Shannon.
• Exemplul îndreaptă cererile de fundal spre shannon-1.6-lite, care este numărat în token-uri. Titlurile sesiunilor și cererile similare nu consumă atunci apeluri Coder.
• Claude Code cere POST /v1/messages/count_tokens pentru dimensiunea contextului. Endpoint-ul numără pentru modelele open-weight găzduite. Cu un id Shannon răspunde 400; Claude Code tratează numărarea token-urilor ca opțională și estimează singur dimensiunea. Numărarea token-urilor

Pentru a verifica adresa, cheia și un id de model înainte de a porni instrumentul, trimite manual o cerere:

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 comunică cu Responses API. Descrie Shannon ca provider de modele în ~/.codex/config.toml, selectează acolo un id de model Shannon și pune cheia ta API în variabila de mediu numită de provider.

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 nu păstrează nicio conversație pe server: fiecare cerere poartă conversația în input. previous_response_id este acceptat pentru compatibilitate.
• Instrumentele de tip funcție (type: "function") sunt oferite modelului pe /v1/responses.
• Pe /v1/responses, shannon-coder-1 este numărat în token-uri din soldul tău, nu în apeluri Coder.

Aceeași verificare pentru endpoint-ul Responses:

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

Modelul de programare și cum este numărat

shannon-coder-1 este modelul Shannon pentru agenții de programare. GET /v1/models îl raportează cu o fereastră de context de 131,072 token-uri, apeluri de instrumente, raționament și text la intrare. Este numărat într-unul din două moduri, în funcție de endpoint-ul folosit de un instrument.

Un apel este o cerere, indiferent de dimensiunea ei. Este numărat când cererea este acceptată, înainte ca modelul să răspundă. O sesiune de agent trimite o cerere pentru fiecare pas pe care îl face, deci o sarcină lungă consumă multe apeluri. Cota depinde de planul tău și o ia de la capăt la fiecare 4 ore, la 00:00, 04:00, 08:00, 12:00, 16:00 și 20:00 UTC.

Pagina planurilor arată cifrele curente. Planuri

Când apelurile unei ferestre sunt consumate, cererea primește răspuns 429. Pe /v1/messages aceeași eroare vine în forma Anthropic.

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

Depășirea contextului

Când o conversație este mai mare decât fereastra de context a modelului, /v1/chat/completions și /v1/messages răspund cu 400, tipul invalid_request_error, codul context_length_exceeded și un mesaj care începe cu prompt is too long. Instrumentele de programare citesc această eroare pentru a compacta sesiunea și a trimite din nou cererea. Este produsă de shannon-coder-1, shannon-1.6-lite și 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
  }
}

Mesajul este prompt is too long: <sent> tokens > <limit> maximum. Când cele două numere nu sunt cunoscute, este prompt is too long. Please compact the conversation and try again.

Pe un stream, starea este deja 200, deci eroarea sosește ca eveniment, iar stream-ul se închide apoi în mod normal:

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

Pe ce se poate baza o buclă de agent

Depanare

Cheia și soldul tău se află pe pagina Chei și utilizare. Chei și utilizare