Outils CLI de programmation

Un outil de programmation a besoin de trois réglages pour fonctionner avec Shannon : l'URL de base de l'API, votre clé API et un id de modèle Shannon. Cette page donne les réglages exacts pour Claude Code et Codex CLI, explique comment le modèle de programmation shannon-coder-1 est compté et liste les erreurs que rencontrent ces outils.

Quel point de terminaison utilise chaque outil

Les trois points de terminaison acceptent la même clé API, comme Authorization: Bearer ou comme x-api-key. Les en-têtes anthropic-version, anthropic-beta et openai-beta que ces outils envoient sont acceptés.

Choisir un modèle Shannon

Chaque requête doit nommer un id de modèle que Shannon publie. Un outil de programmation envoie le nom de son propre modèle par défaut si vous ne lui dites pas autre chose, et un nom que Shannon ne publie pas reçoit 400 et le message unknown model: <name>. Aucun autre nom n'est associé à un modèle Shannon : définissez donc le modèle dans l'outil avant la première requête.

GET /v1/models liste chaque id avec sa fenêtre de contexte. Il n'exige aucune clé. Modèles et tarifs

Les outils de programmation pilotent le modèle avec un long prompt système. Le prompt système est appliqué par shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro et les modèles open-weight hébergés : choisissez donc l'un d'eux pour un outil de programmation.

Claude Code

Claude Code lit sa connexion dans des variables d'environnement. Définissez-les dans le shell qui le lance, ou dans le bloc env de ~/.claude/settings.json pour les conserver à chaque 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"
  }
}

• Définissez les trois variables ANTHROPIC_DEFAULT_…_MODEL. Les sous-agents et certaines commandes demandent un modèle par son nom intégré, et chaque nom doit correspondre à un id Shannon.
• L'exemple dirige les requêtes d'arrière-plan vers shannon-1.6-lite, qui est compté en tokens. Les titres de session et requêtes similaires n'utilisent alors pas d'appels Coder.
• Claude Code interroge POST /v1/messages/count_tokens pour connaître la taille du contexte. Le point de terminaison compte pour les modèles open-weight hébergés. Avec un id Shannon, il répond 400 ; Claude Code considère le comptage de tokens comme facultatif et estime lui-même la taille. Décompte de tokens

Pour vérifier l'adresse, la clé et un id de modèle avant de lancer l'outil, envoyez une requête à la main :

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 parle à l'API Responses. Décrivez Shannon comme fournisseur de modèle dans ~/.codex/config.toml, choisissez-y un id de modèle Shannon et mettez votre clé API dans la variable d'environnement que nomme le fournisseur.

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 ne conserve aucune conversation sur le serveur : chaque requête porte la conversation dans input. previous_response_id est accepté pour la compatibilité.
• Les outils de fonction (type: "function") sont proposés au modèle sur /v1/responses.
• Sur /v1/responses, shannon-coder-1 est compté en tokens sur votre solde, et non en appels Coder.

La même vérification pour le point de terminaison 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."
  }'

Le modèle de programmation et son comptage

shannon-coder-1 est le modèle Shannon pour les agents de programmation. GET /v1/models l'indique avec une fenêtre de contexte de 131,072 tokens, des appels d'outil, du raisonnement et une entrée texte. Il est compté de l'une de deux façons, selon le point de terminaison qu'utilise un outil.

Un appel est une requête, quelle que soit sa taille. Il est compté quand la requête est acceptée, avant que le modèle réponde. Une session d'agent envoie une requête à chaque étape, donc une longue tâche consomme beaucoup d'appels. Le quota dépend de votre forfait et repart toutes les 4 heures, à 00:00, 04:00, 08:00, 12:00, 16:00 et 20:00 UTC.

La page des forfaits montre les chiffres actuels. Forfaits

Quand les appels d'une fenêtre sont épuisés, la requête reçoit 429. Sur /v1/messages, la même erreur arrive sous la forme 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"
  }
}

Dépassement de contexte

Quand une conversation dépasse la fenêtre de contexte du modèle, /v1/chat/completions et /v1/messages répondent avec 400, le type invalid_request_error, le code context_length_exceeded et un message qui commence par prompt is too long. Les outils de programmation lisent cette erreur pour compacter la session et renvoyer la requête. Elle est produite par shannon-coder-1, shannon-1.6-lite et 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
  }
}

Le message est prompt is too long: <sent> tokens > <limit> maximum. Quand les deux nombres ne sont pas connus, c'est prompt is too long. Please compact the conversation and try again.

Sur un flux, le statut est déjà 200 : l'erreur arrive donc comme un événement, puis le flux se ferme normalement :

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

Ce sur quoi une boucle d'agent peut compter

Dépannage

Votre clé et votre solde se trouvent sur la page Clés et utilisation. Clés et utilisation