Eines de programació CLI

Una eina de programació necessita tres paràmetres per funcionar amb Shannon: la URL base de l'API, la teva clau API i un id de model Shannon. Aquesta pàgina dona els paràmetres exactes per a Claude Code i Codex CLI, explica com es compta el model de programació shannon-coder-1 i llista els errors que troben aquestes eines.

Quin endpoint fa servir cada eina

Els tres endpoints accepten la mateixa clau API, com a Authorization: Bearer o com a x-api-key. S'accepten les capçaleres anthropic-version, anthropic-beta i openai-beta que envien aquestes eines.

Selecciona un model Shannon

Cada sol·licitud ha d'indicar un id de model que Shannon publiqui. Una eina de programació envia el nom del seu propi model per defecte si no li indiques una altra cosa, i un nom que Shannon no publica es respon amb 400 i el missatge unknown model: <name>. Cap altre nom s'associa a un model Shannon, així que defineix el model a l'eina abans de la primera sol·licitud.

GET /v1/models llista cada id amb la seva finestra de context. No necessita clau. Models i preus

Les eines de programació dirigeixen el model amb un prompt de sistema llarg. El prompt de sistema l'apliquen shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro i els models open-weight hostejats, així que selecciona'n un per a una eina de programació.

Claude Code

Claude Code llegeix la seva connexió de variables d'entorn. Defineix-les a la shell que l'inicia, o al bloc env de ~/.claude/settings.json per conservar-les a cada sessió.

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

• Defineix les tres variables ANTHROPIC_DEFAULT_…_MODEL. Els subagents i algunes ordres demanen un model pel seu nom integrat, i cada nom s'ha de resoldre a un id Shannon.
• L'exemple apunta les sol·licituds en segon pla a shannon-1.6-lite, que es compta en tokens. Els títols de sessió i sol·licituds semblants no fan servir llavors crides de Coder.
• Claude Code demana a POST /v1/messages/count_tokens la mida del context. L'endpoint compta per als models open-weight hostejats. Amb un id Shannon respon 400; Claude Code tracta el recompte de tokens com a opcional i estima la mida per si mateix. Recompte de tokens

Per comprovar l'adreça, la clau i un id de model abans d'iniciar l'eina, envia una sol·licitud a mà:

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 parla amb l'API Responses. Descriu Shannon com a proveïdor de models a ~/.codex/config.toml, selecciona-hi un id de model Shannon i posa la teva clau API a la variable d'entorn que el proveïdor indica.

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 no guarda cap conversa al servidor: cada sol·licitud porta la conversa a input. previous_response_id s'accepta per compatibilitat.
• Les eines de funció (type: "function") s'ofereixen al model a /v1/responses.
• A /v1/responses, shannon-coder-1 es compta en tokens del teu saldo, no en crides de Coder.

La mateixa comprovació per a l'endpoint 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."
  }'

El model de programació i com es compta

shannon-coder-1 és el model Shannon per a agents de programació. GET /v1/models l'informa amb una finestra de context de 131,072 tokens, crides d'eina, raonament i entrada de text. Es compta d'una de dues maneres, segons l'endpoint que faci servir una eina.

Una crida és una sol·licitud, sigui quina sigui la seva mida. Es compta quan la sol·licitud s'accepta, abans que el model respongui. Una sessió d'agent envia una sol·licitud per cada pas que fa, de manera que una tasca llarga gasta moltes crides. La quota depèn del teu pla i torna a començar cada 4 hores, a les 00:00, 04:00, 08:00, 12:00, 16:00 i 20:00 UTC.

La pàgina del pla mostra les xifres actuals. Plans

Quan s'esgoten les crides d'una finestra, la sol·licitud es respon amb 429. A /v1/messages el mateix error arriba amb la forma d'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"
  }
}

Desbordament de context

Quan una conversa és més gran que la finestra de context del model, /v1/chat/completions i /v1/messages responen amb 400, el tipus invalid_request_error, el codi context_length_exceeded i un missatge que comença per prompt is too long. Les eines de programació llegeixen aquest error per compactar la sessió i tornar a enviar la sol·licitud. El produeixen 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
  }
}

El missatge és prompt is too long: <sent> tokens > <limit> maximum. Quan els dos números no es coneixen és prompt is too long. Please compact the conversation and try again.

En un stream l'estat ja és 200, així que l'error arriba com a esdeveniment i el stream es tanca després de la manera 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"}

En què pot confiar un bucle d'agent

Resolució de problemes

La teva clau i el teu saldo són a la pàgina Keys & usage. Keys & usage