Strumenti CLI per la programmazione

Uno strumento di programmazione ha bisogno di tre impostazioni per funzionare con Shannon: l'URL di base dell'API, la tua chiave API e un id di modello Shannon. Questa pagina fornisce le impostazioni esatte per Claude Code e Codex CLI, spiega come viene conteggiato il modello per la programmazione shannon-coder-1 ed elenca gli errori in cui incorrono questi strumenti.

Quale endpoint usa ogni strumento

Tutti e tre gli endpoint accettano la stessa chiave API, come Authorization: Bearer o come x-api-key. Gli header anthropic-version, anthropic-beta e openai-beta che questi strumenti inviano sono accettati.

Seleziona un modello Shannon

Ogni richiesta deve indicare un id di modello pubblicato da Shannon. Uno strumento di programmazione invia il nome del proprio modello predefinito a meno che tu non gli dica altrimenti, e un nome che Shannon non pubblica riceve come risposta 400 e il messaggio unknown model: <name>. Nessun altro nome viene associato a un modello Shannon, quindi imposta il modello nello strumento prima della prima richiesta.

GET /v1/models elenca ogni id con la sua finestra di contesto. Non richiede una chiave. Modelli e prezzi

Gli strumenti di programmazione guidano il modello con un system prompt lungo. Il system prompt è applicato da shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro e dai modelli open-weight ospitati, quindi scegline uno per uno strumento di programmazione.

Claude Code

Claude Code legge la sua connessione dalle variabili d'ambiente. Impostale nella shell che lo avvia, oppure nel blocco env di ~/.claude/settings.json per mantenerle in ogni sessione.

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

• Imposta tutte e tre le variabili ANTHROPIC_DEFAULT_…_MODEL. I subagent e alcuni comandi chiedono un modello con il suo nome integrato, e ogni nome deve risolversi in un id Shannon.
• L'esempio indirizza le richieste in background a shannon-1.6-lite, che è conteggiato in token. I titoli delle sessioni e richieste simili non usano allora le chiamate Coder.
• Claude Code chiede a POST /v1/messages/count_tokens la dimensione del contesto. L'endpoint conta per i modelli open-weight ospitati. Con un id Shannon risponde 400; Claude Code considera facoltativo il conteggio dei token e stima da sé la dimensione. Conteggio dei token

Per verificare l'indirizzo, la chiave e un id di modello prima di avviare lo strumento, invia una richiesta a mano:

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 con la Responses API. Descrivi Shannon come model provider in ~/.codex/config.toml, seleziona lì un id di modello Shannon e inserisci la tua chiave API nella variabile d'ambiente indicata dal 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 non conserva alcuna conversazione sul server: ogni richiesta porta la conversazione in input. previous_response_id è accettato per compatibilità.
• I function tool (type: "function") vengono offerti al modello su /v1/responses.
• Su /v1/responses, shannon-coder-1 è conteggiato in token dal tuo saldo, non in chiamate Coder.

La stessa verifica per 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."
  }'

Il modello per la programmazione e come viene conteggiato

shannon-coder-1 è il modello Shannon per gli agenti di programmazione. GET /v1/models lo riporta con una finestra di contesto di 131,072 token, chiamate a tool, ragionamento e input di testo. Viene conteggiato in uno di due modi, a seconda dell'endpoint che usa uno strumento.

Una chiamata è una richiesta, qualunque sia la sua dimensione. Viene conteggiata quando la richiesta è accettata, prima che il modello risponda. Una sessione di agente invia una richiesta per ogni passo che compie, quindi un compito lungo usa molte chiamate. La quota dipende dal tuo piano e ricomincia ogni 4 ore, alle 00:00, 04:00, 08:00, 12:00, 16:00 e 20:00 UTC.

La pagina dei piani mostra i numeri attuali. Piani

Quando le chiamate di una finestra sono esaurite, la richiesta riceve come risposta 429. Su /v1/messages lo stesso errore arriva nella 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"
  }
}

Superamento del contesto

Quando una conversazione è più grande della finestra di contesto del modello, /v1/chat/completions e /v1/messages rispondono con 400, il tipo invalid_request_error, il codice context_length_exceeded e un messaggio che inizia con prompt is too long. Gli strumenti di programmazione leggono questo errore per compattare la sessione e inviare di nuovo la richiesta. È prodotto da shannon-coder-1, shannon-1.6-lite e 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
  }
}

Il messaggio è prompt is too long: <sent> tokens > <limit> maximum. Quando i due numeri non sono noti è prompt is too long. Please compact the conversation and try again.

Su uno stream lo stato è già 200, quindi l'errore arriva come evento e lo stream si chiude poi normalmente:

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

Su cosa può contare un ciclo di agente

Risoluzione dei problemi

La tua chiave e il tuo saldo si trovano nella pagina Chiavi e utilizzo. Chiavi e utilizzo