CLI-iloj por programado

Koda ilo bezonas tri agordojn por funkcii kun Shannon: la bazan URL de la API, vian API-ŝlosilon kaj id de Shannon-modelo. Ĉi tiu paĝo donas la precizajn agordojn por Claude Code kaj Codex CLI, klarigas kiel la koda modelo shannon-coder-1 estas kalkulata, kaj listigas la erarojn, kiujn ĉi tiuj iloj renkontas.

Kiun endpoint uzas ĉiu ilo

Ĉiuj tri endpoints akceptas la saman API-ŝlosilon, kiel Authorization: Bearer aŭ kiel x-api-key. La kapoj anthropic-version, anthropic-beta kaj openai-beta, kiujn ĉi tiuj iloj sendas, estas akceptataj.

Elekti Shannon-modelon

Ĉiu peto devas nomi model-id, kiun Shannon publikigas. Koda ilo sendas la nomon de sia propra defaŭlta modelo, se vi ne diras alie, kaj nomo, kiun Shannon ne publikigas, ricevas respondon 400 kun la mesaĝo unknown model: <name>. Neniu alia nomo estas mapata al Shannon-modelo, do agordu la modelon en la ilo antaŭ la unua peto.

GET /v1/models listigas ĉiun id kun ĝia kunteksta fenestro. Ĝi ne bezonas ŝlosilon. Modeloj kaj prezoj

Kodaj iloj gvidas la modelon per longa sistema prompt. La sisteman prompt aplikas shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro kaj la gastigitaj malfermpezaj modeloj, do elektu unu el ili por koda ilo.

Claude Code

Claude Code legas sian konekton el medivariabloj. Agordu ilin en la ŝelo, kiu lanĉas ĝin, aŭ en la bloko env de ~/.claude/settings.json por konservi ilin por ĉiu sesio.

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

• Agordu ĉiujn tri variablojn ANTHROPIC_DEFAULT_…_MODEL. Subagentoj kaj kelkaj komandoj petas modelon per ĝia enkonstruita nomo, kaj ĉiu nomo devas solviĝi al Shannon-id.
• La ekzemplo direktas fonajn petojn al shannon-1.6-lite, kiu estas kalkulata en tokenoj. Sesiaj titoloj kaj similaj petoj tiam ne uzas vokojn de Coder.
• Claude Code petas de POST /v1/messages/count_tokens la grandon de la kunteksto. La endpoint kalkulas por la gastigitaj malfermpezaj modeloj. Kun Shannon-id ĝi respondas 400; Claude Code traktas la kalkuladon de tokenoj kiel laŭvolan kaj mem taksas la grandon. Kalkulado de tokenoj

Por kontroli la adreson, la ŝlosilon kaj modelo-id antaŭ ol vi lanĉas la ilon, sendu unu peton permane:

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 parolas al la Responses API. Priskribu Shannon kiel modelan provizanton en ~/.codex/config.toml, elektu tie Shannon-modelo-id, kaj metu vian API-ŝlosilon en la medivariablon, kiun la provizanto nomas.

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 tenas konversacion sur la servilo: ĉiu peto portas la konversacion en input. previous_response_id estas akceptata pro kongrueco.
• Funkciaj iloj (type: "function") estas proponataj al la modelo ĉe /v1/responses.
• Ĉe /v1/responses shannon-coder-1 estas kalkulata en tokenoj el via saldo, ne en vokoj de Coder.

La sama kontrolo por la 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."
  }'

La koda modelo kaj kiel ĝi estas kalkulata

shannon-coder-1 estas la Shannon-modelo por programaj agentoj. GET /v1/models raportas ĝin kun kunteksta fenestro de 131,072 tokenoj, ilovokoj, reasoning kaj teksta enigo. Ĝi estas kalkulata laŭ unu el du manieroj, depende de la endpoint, kiun ilo uzas.

Voko estas unu peto, kia ajn estas ĝia grando. Ĝi estas kalkulata kiam la peto estas akceptata, antaŭ ol la modelo respondas. Agenta sesio sendas unu peton por ĉiu paŝo, kiun ĝi faras, do longa tasko uzas multajn vokojn. La kvoto dependas de via plano kaj rekomenciĝas ĉiujn 4 horojn, je 00:00, 04:00, 08:00, 12:00, 16:00 kaj 20:00 UTC.

La plana paĝo montras la nunajn nombrojn. Planoj

Kiam la vokoj de fenestro estas elĉerpitaj, la peto ricevas respondon 429. Ĉe /v1/messages la sama eraro venas en la formo de 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"
  }
}

Superfluo de kunteksto

Kiam konversacio estas pli granda ol la kunteksta fenestro de la modelo, /v1/chat/completions kaj /v1/messages respondas per 400, la tipo invalid_request_error, la kodo context_length_exceeded kaj mesaĝo, kiu komenciĝas per prompt is too long. Kodaj iloj legas ĉi tiun eraron por kompaktigi la sesion kaj resendi la peton. Ĝin produktas shannon-coder-1, shannon-1.6-lite kaj 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
  }
}

La mesaĝo estas prompt is too long: <sent> tokens > <limit> maximum. Kiam la du nombroj ne estas konataj, ĝi estas prompt is too long. Please compact the conversation and try again.

En fluo la stato jam estas 200, do la eraro venas kiel evento kaj la fluo poste fermiĝas en la normala maniero:

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

Kion povas fidi agent-ciklo

Solvo de problemoj

Via ŝlosilo kaj via saldo estas en la paĝo Keys & usage. Ŝlosiloj kaj uzado