Εργαλεία CLI για προγραμματισμό

Ένα εργαλείο προγραμματισμού χρειάζεται τρεις ρυθμίσεις για να δουλέψει με το Shannon: το base URL του API, το κλειδί API σας και ένα id μοντέλου Shannon. Αυτή η σελίδα δίνει τις ακριβείς ρυθμίσεις για το Claude Code και το Codex CLI, εξηγεί πώς μετριέται το μοντέλο προγραμματισμού shannon-coder-1 και απαριθμεί τα σφάλματα που συναντούν αυτά τα εργαλεία.

Ποιο endpoint χρησιμοποιεί κάθε εργαλείο

Και τα τρία endpoints δέχονται το ίδιο κλειδί API, ως Authorization: Bearer ή ως x-api-key. Οι κεφαλίδες anthropic-version, anthropic-beta και openai-beta που στέλνουν αυτά τα εργαλεία γίνονται δεκτές.

Επιλογή μοντέλου Shannon

Κάθε αίτημα πρέπει να ονομάζει ένα id μοντέλου που δημοσιεύει το Shannon. Ένα εργαλείο προγραμματισμού στέλνει το όνομα του δικού του προεπιλεγμένου μοντέλου εκτός αν του πείτε αλλιώς, και ένα όνομα που το Shannon δεν δημοσιεύει απαντάται με 400 και το μήνυμα unknown model: <name>. Κανένα άλλο όνομα δεν αντιστοιχίζεται σε μοντέλο Shannon, οπότε ορίστε το μοντέλο στο εργαλείο πριν από το πρώτο αίτημα.

Το GET /v1/models απαριθμεί κάθε id με το παράθυρο συμφραζομένων του. Δεν χρειάζεται κλειδί. Μοντέλα & τιμές

Τα εργαλεία προγραμματισμού καθοδηγούν το μοντέλο με ένα μακρύ system prompt. Το system prompt εφαρμόζεται από τα shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro και τα φιλοξενούμενα μοντέλα ανοιχτών βαρών, οπότε επιλέξτε ένα από αυτά για ένα εργαλείο προγραμματισμού.

Claude Code

Το Claude Code διαβάζει τη σύνδεσή του από μεταβλητές περιβάλλοντος. Ορίστε τις στο shell που το ξεκινά ή στο block env του ~/.claude/settings.json για να τις κρατήσετε σε κάθε συνεδρία.

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

• Ορίστε και τις τρεις μεταβλητές ANTHROPIC_DEFAULT_…_MODEL. Οι subagents και ορισμένες εντολές ζητούν μοντέλο με το ενσωματωμένο όνομά του και κάθε όνομα πρέπει να αντιστοιχεί σε id Shannon.
• Το δείγμα στρέφει τα αιτήματα παρασκηνίου στο shannon-1.6-lite, που μετριέται σε tokens. Οι τίτλοι συνεδριών και παρόμοια αιτήματα δεν χρησιμοποιούν τότε κλήσεις Coder.
• Το Claude Code ρωτά το POST /v1/messages/count_tokens για το μέγεθος του context. Το endpoint μετρά για τα φιλοξενούμενα μοντέλα ανοιχτών βαρών. Με id Shannon απαντά 400· το Claude Code θεωρεί τη μέτρηση tokens προαιρετική και εκτιμά το μέγεθος μόνο του. Καταμέτρηση tokens

Για να ελέγξετε τη διεύθυνση, το κλειδί και ένα id μοντέλου πριν ξεκινήσετε το εργαλείο, στείλτε ένα αίτημα με το χέρι:

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 μιλά στο Responses API. Περιγράψτε το Shannon ως provider μοντέλων στο ~/.codex/config.toml, επιλέξτε εκεί ένα id μοντέλου Shannon και βάλτε το κλειδί API σας στη μεταβλητή περιβάλλοντος που ονομάζει ο 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 δεν κρατά συνομιλία στον διακομιστή: κάθε αίτημα φέρει τη συνομιλία στο input. Το previous_response_id γίνεται δεκτό για συμβατότητα.
• Εργαλεία συναρτήσεων (type: "function") προσφέρονται στο μοντέλο στο /v1/responses.
• Στο /v1/responses, το shannon-coder-1 μετριέται σε tokens από το υπόλοιπό σας και όχι σε κλήσεις Coder.

Ο ίδιος έλεγχος για το 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."
  }'

Το μοντέλο προγραμματισμού και πώς μετριέται

Το shannon-coder-1 είναι το μοντέλο Shannon για agents προγραμματισμού. Το GET /v1/models το αναφέρει με παράθυρο συμφραζομένων 131,072 tokens, κλήσεις εργαλείων, συλλογισμό και είσοδο κειμένου. Μετριέται με έναν από δύο τρόπους, ανάλογα με το endpoint που χρησιμοποιεί ένα εργαλείο.

Μια κλήση είναι ένα αίτημα, όποιο κι αν είναι το μέγεθός του. Μετριέται όταν γίνεται δεκτό το αίτημα, πριν απαντήσει το μοντέλο. Μια συνεδρία agent στέλνει ένα αίτημα για κάθε βήμα που κάνει, οπότε μια μακριά εργασία χρησιμοποιεί πολλές κλήσεις. Το όριο εξαρτάται από το πλάνο σας και ξεκινά ξανά κάθε 4 ώρες, στις 00:00, 04:00, 08:00, 12:00, 16:00 και 20:00 UTC.

Η σελίδα του πλάνου δείχνει τους τρέχοντες αριθμούς. Πλάνα

Όταν εξαντληθούν οι κλήσεις ενός παραθύρου, το αίτημα απαντάται με 429. Στο /v1/messages το ίδιο σφάλμα έρχεται στη μορφή της 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"
  }
}

Υπέρβαση του context

Όταν μια συνομιλία είναι μεγαλύτερη από το παράθυρο συμφραζομένων του μοντέλου, τα /v1/chat/completions και /v1/messages απαντούν με 400, τον τύπο invalid_request_error, τον κωδικό context_length_exceeded και ένα μήνυμα που αρχίζει με prompt is too long. Τα εργαλεία προγραμματισμού διαβάζουν αυτό το σφάλμα για να συμπυκνώσουν τη συνεδρία και να στείλουν ξανά το αίτημα. Παράγεται από τα shannon-coder-1, shannon-1.6-lite και 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
  }
}

Το μήνυμα είναι prompt is too long: <sent> tokens > <limit> maximum. Όταν δεν είναι γνωστοί οι δύο αριθμοί, είναι prompt is too long. Please compact the conversation and try again.

Σε ένα stream η κατάσταση είναι ήδη 200, οπότε το σφάλμα φτάνει ως συμβάν και το stream κλείνει στη συνέχεια κανονικά:

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

Σε τι μπορεί να βασιστεί ένας βρόχος agent

Αντιμετώπιση προβλημάτων

Το κλειδί και το υπόλοιπό σας βρίσκονται στη σελίδα Κλειδιά & χρήση. Κλειδιά & χρήση