Ad contentum transili
Instrumenta CLI ad codicem scribendum

Instrumenta CLI ad codicem scribendum

Novum

Shannon utere ut modello post Claude Code, Codex CLI et alia agent CLI.

Instrumentum codicis tribus statutis eget ut cum Shannon operetur: URL basi API, clave tua API et id modelli Shannon. Haec pagina statuta exacta pro Claude Code et Codex CLI dat, explicat quomodo modellum codicis shannon-coder-1 computetur, et errores quos haec instrumenta inveniunt enumerat.

Quo endpoint quodque instrumentum utatur

Instrumentum Endpoint URL basis ponenda Nota
Claude Code POST /v1/messages
POST /v1/messages/count_tokens
https://api.shannon-ai.com Instrumentum ipsum /v1/messages ad URL basim addit.
Codex CLI POST /v1/responses https://api.shannon-ai.com/v1 Instrumentum /responses ad URL basim addit.
Alia instrumenta agentium quae formam chat OpenAI loquuntur POST /v1/chat/completions https://api.shannon-ai.com/v1 URL basim, clavem et id modelli Shannon in configuratione propria instrumenti pone.

Omnia tria endpoints eandem clavem API accipiunt, ut Authorization: Bearer vel ut x-api-key. Headers anthropic-version, anthropic-beta et openai-beta quos haec instrumenta mittunt accipiuntur.

Modellum Shannon elige

Quaeque petitio id modelli nominare debet quod Shannon publicat. Instrumentum codicis nomen modelli sui defaultis mittit nisi aliter ei dicis, et nomen quod Shannon non publicat cum 400 et nuntio unknown model: <name> respondetur. Nullum aliud nomen ad modellum Shannon refertur, itaque modellum in instrumento ante primam petitionem pone.

GET /v1/models omnia ids cum fenestra contextus enumerat. Clavem non requirit. Modella et pretia

Modellum Computatur ut Quid afferat
shannon-coder-1 Una vocatio per petitionem in /v1/messages et /v1/chat/completions. Tokens in /v1/responses. Modellum codicis. Input textus, vocationes instrumentorum, fenestra contextus 131,072 tokenorum.
shannon-1.6-lite
shannon-1.6-pro
Tokens de saldo tuo. Modella generalia cum vocationibus instrumentorum. shannon-1.6-lite petitionibus brevibus in secundo plano quas instrumentum facit convenit.
Modella open-weight hospitata Tokens de saldo tuo, cum input cached ad 25% pretii inputi. Vocationes instrumentorum, cachatio prompti pro sessionibus longis, et computationes exactae ex /v1/messages/count_tokens.

Instrumenta codicis modellum system prompt longo dirigunt. System prompt a shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro et modellis open-weight hospitatis applicatur, itaque unum ex his pro instrumento codicis elige.

Claude Code

Claude Code connexionem suam e variabilibus ambitus legit. Eas in shell quod eum incipit pone, vel in blocum env fasciculi ~/.claude/settings.json ut pro omni sessione serventur.

# 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
Variabilis Descriptio
ANTHROPIC_BASE_URL Quo Claude Code petitiones suas mittit. Inscriptione sine /v1 utere.
ANTHROPIC_AUTH_TOKEN Clavis tua API Shannon, ut Authorization: Bearer missa. ANTHROPIC_API_KEY etiam operatur: clavem ut x-api-key mittit, et Claude Code semel petit ut eam approbes.
ANTHROPIC_MODEL Modellum sessionis. claude --model <id> et /model <id> idem statuunt.
ANTHROPIC_DEFAULT_HAIKU_MODEL Modellum pro petitionibus in secundo plano, ut tituli sessionum, et pro quolibet quod haiku petit.
ANTHROPIC_DEFAULT_SONNET_MODEL Modellum quod adhibetur cum subagens vel mandatum sonnet petit.
ANTHROPIC_DEFAULT_OPUS_MODEL Modellum quod adhibetur cum subagens vel mandatum opus petit.
CLAUDE_CODE_MAX_CONTEXT_TOKENS Fenestra contextus quam Claude Code pro modello ponit. context_window utere quod GET /v1/models pro id electo nuntiat.
  • Omnes tres variabiles ANTHROPIC_DEFAULT_…_MODEL pone. Subagentes et quaedam mandata modellum nomine suo inbuilt petunt, et quodque nomen in id Shannon resolvi debet.
  • Exemplum petitiones in secundo plano ad shannon-1.6-lite dirigit, quod in tokens computatur. Tituli sessionum et similes petitiones tum vocationibus Coder non utuntur.
  • Claude Code POST /v1/messages/count_tokens de magnitudine contextus rogat. Endpoint pro modellis open-weight hospitatis computat. Cum id Shannon cum 400 respondet; Claude Code computationem tokenorum ut facultativam tractat et magnitudinem ipse aestimat. Computatio tokenum

Ut inscriptionem, clavem et id modelli inspicias antequam instrumentum incipis, unam petitionem manu mitte:

cURL
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 cum API Responses colloquitur. Shannon ut provisorem modellorum in ~/.codex/config.toml describe, ibi id modelli Shannon elige, et clavem tuam API in variabilem ambitus quam provisor nominat pone.

~/.codex/config.toml
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"
Shell
# 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
Clavis Descriptio
model Id modelli Shannon. codex --model <id> id pro uno cursu statuit.
model_provider Nomen blocci provisoris adhibendi, hic shannon.
base_url Inscriptio API cum /v1.
env_key Nomen variabilis ambitus quae clavem tuam API Shannon tenet.
wire_api responses: Codex cum POST /v1/responses colloquitur.
model_context_window Fenestra contextus modelli, ut Codex sessionem longam tempestive compactet. context_window utere quod GET /v1/models nuntiat.
  • /v1/responses nullum colloquium in servere servat: quaeque petitio colloquium in input fert. previous_response_id propter compatibilitatem accipitur.
  • Instrumenta functionum (type: "function") modello in /v1/responses offeruntur.
  • In /v1/responses, shannon-coder-1 in tokens de saldo tuo computatur, non in vocationibus Coder.

Eadem inspectio pro endpoint Responses:

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

Modellum codicis et quomodo computetur

shannon-coder-1 est modellum Shannon pro agentibus codicis. GET /v1/models id cum fenestra contextus 131,072 tokenorum, vocationibus instrumentorum, ratiocinatione et input textus nuntiat. Duobus modis computatur, secundum endpoint quo instrumentum utitur.

Endpoint Petitio constat Sumitur de
/v1/messages 1 vocatio per petitionem Quota vocationum Coder plani tui. Nulli tokens de saldo tuo sumuntur.
/v1/chat/completions 1 vocatio per petitionem Quota vocationum Coder plani tui. Nulli tokens de saldo tuo sumuntur.
/v1/responses Tokens, ad $8.00 per 1M Saldum tuum, sicut quodvis aliud modellum. Quota vocationum non adhibetur.

Vocatio est una petitio, cuiuscumque magnitudinis. Computatur cum petitio accipitur, antequam modellum respondet. Sessio agentis unam petitionem pro quoque gradu quem facit mittit, itaque negotium longum multas vocationes consumit. Quota a plano tuo pendet et quaque 4 horis de integro incipit, hora 00:00, 04:00, 08:00, 12:00, 16:00 et 20:00 UTC.

Planum Vocationes per fenestram 4 horarum
Free 3
Plus 20
Standard 40
Pro 60

Pagina planorum numeros praesentes ostendit. Plana

Cum vocationes fenestrae consumptae sunt, petitio cum 429 respondetur. In /v1/messages idem error in forma Anthropic venit.

429 /v1/chat/completions
{
  "error": {
    "type": "rate_limit_error",
    "message": "Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan"
  }
}
429 /v1/messages
{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan"
  }
}

Superfluxus contextus

Cum colloquium maius est quam fenestra contextus modelli, /v1/chat/completions et /v1/messages cum 400, genere invalid_request_error, codice context_length_exceeded et nuntio qui a prompt is too long incipit respondent. Instrumenta codicis hunc errorem legunt ut sessionem compactent et petitionem iterum mittant. A shannon-coder-1, shannon-1.6-lite et shannon-1.6-pro producitur.

400 /v1/chat/completions
{
  "error": {
    "type": "invalid_request_error",
    "code": "context_length_exceeded",
    "message": "prompt is too long: 140211 tokens > 131072 maximum",
    "param": null
  }
}
400 /v1/messages
{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "code": "context_length_exceeded",
    "message": "prompt is too long: 140211 tokens > 131072 maximum",
    "param": null
  }
}

Nuntius est prompt is too long: <sent> tokens > <limit> maximum. Cum duo numeri ignoti sunt, est prompt is too long. Please compact the conversation and try again.

In fluxu status iam est 200, itaque error ut eventus advenit et fluxus deinde modo normali clauditur:

/v1/chat/completions, fluxus
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]
/v1/messages, fluxus
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"}

Quibus circulus agentis confidere possit

Argumentum Mores
Schemata instrumentorum Definitiones instrumentorum ut instrumentum eas mittit accipiuntur. In shannon-coder-1 et shannon-1.6-*, verba clavia JSON Schema quibus modellum non utitur, ut $schema, $ref, additionalProperties, default et title, ex eo quod modellum legit omittuntur, et oneOf ut anyOf legitur. Nulla petitio propter ea recusatur.
Argumenta vocationis instrumenti In fluxu, argumenta vocationis instrumenti in uno delta completa adveniunt: tool_calls[].function.arguments, input_json_delta.partial_json vel response.function_call_arguments.delta.
Finis vicis instrumenti finish_reason: "tool_calls" in Chat Completions, stop_reason: "tool_use" in Messages.
Keep-alive Dum modellum operatur, /v1/messages event: ping mittit et /v1/chat/completions lineam commenti : ping quaque 15 secundis mittit.
Petitionem sistere Connexionem claudere fluxum sistit. Vicis ipsa ad finem currit et computatur.

Solutio problematum

Signum Causa Remedium
400 cum unknown model: claude-… vel unknown model: gpt-… Instrumentum nomen modelli sui defaultis misit. Solum ids Shannon publicata ministrantur, et nullum aliud nomen ad unum refertur. Id Shannon elige: ANTHROPIC_MODEL et tres variabiles ANTHROPIC_DEFAULT_…_MODEL in Claude Code, model in configuratione Codex.
400 cum unknown model: et sine nomine, ex Codex CLI Petitio nullum modellum nominavit. /v1/responses unum requirit. model in ~/.codex/config.toml pone vel --model praebe.
401 cum Missing authentication vel Invalid API key Clavis ad API non pervenit, vel clavis praesens non est. Clavis Shannon a sk- incipit. Inspice num variabilis in shell quod instrumentum incipit posita sit. Clavem iterum ex Claves et usus copia.
404 in omni petitione URL basis unum /v1 nimis vel nimis paucum pro instrumento habet. Claude Code: inscriptio sine /v1. Codex CLI: inscriptio cum /v1.
429 cum Shannon Coder call quota reached Vocationes Coder fenestrae 4 horarum praesentis consumptae sunt. Fenestram proximam exspecta, ad planum cum pluribus vocationibus transi, vel modellum elige quod in tokens computatur.
429 cum Quota exceeded Saldum tuum petitionem non tegit. Creditum adde, vel quotam cotidianam plani tui hora 00:00 UTC exspecta.
400 cum prompt is too long Colloquium maius est quam fenestra contextus modelli. Sessionem compacta (/compact in ambobus instrumentis). Instrumento fenestram contextus modelli dic ut citius compactet.
Claude Code numeros contextus approximatos ostendit /v1/messages/count_tokens pro modellis open-weight hospitatis computat. Cum id Shannon cum 400 respondet, et Claude Code magnitudinem ipse aestimat. Nihil corrigendum est. Modellum open-weight hospitatum elige si computationes exactas vis.
Imago screenshot inserta non consideratur shannon-coder-1 input textus accipit. Modellum quod imagines accipit pro illa sessione elige.

Clavis tua et saldum tuum in pagina Claves et usus sunt. Claves et usus