Innealan còdachaidh CLI

Tha trì roghainnean a dhìth air inneal còdachaidh gus obrachadh le Shannon: base URL an API, d’ iuchair API, agus id modail Shannon. Tha an duilleag seo a’ toirt seachad na roghainnean cruinn airson Claude Code agus Codex CLI, a’ mìneachadh mar a thèid am modail còdachaidh shannon-coder-1 a chunntadh, agus a’ liostadh na mearachdan a choinnicheas na h-innealan seo.

Dè an endpoint a chleachdas gach inneal

Gabhaidh na trì endpoints ris an aon iuchair API, mar Authorization: Bearer no mar x-api-key. Thèid na headers anthropic-version, anthropic-beta agus openai-beta a chuireas na h-innealan seo aontachadh.

Tagh modail Shannon

Feumaidh gach iarrtas id modail ainmeachadh a bhios Shannon a’ foillseachadh. Cuiridh inneal còdachaidh ainm a mhodail bhun-roghainn fhèin mura h-innis thu dha eile, agus thèid ainm nach bi Shannon a’ foillseachadh a fhreagairt le 400 agus an teachdaireachd unknown model: <name>. Chan eil ainm eile air a mhapadh gu modail Shannon, agus mar sin suidhich am modail san inneal ron chiad iarrtas.

Liostaidh GET /v1/models gach id le uinneag cho-theacsa. Chan eil feum air iuchair. Modailean & prìsean

Stiùiridh innealan còdachaidh am modail le system prompt fhada. Thèid an system prompt a chur an sàs le shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro agus na modailean open-weight hosted, agus mar sin tagh fear dhiubh seo airson inneal còdachaidh.

Claude Code

Leughaidh Claude Code a cheangal o chaochladairean àrainneachd. Suidhich iad san t-slige a thòisicheas e, no ann am bloc env de ~/.claude/settings.json gus an cumail airson gach seisean.

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

• Suidhich na trì caochladairean ANTHROPIC_DEFAULT_…_MODEL uile. Iarraidh subagents is cuid de dh’àitheantan modail len ainm built-in, agus feumaidh gach ainm fuasgladh gu id Shannon.
• Tha an sampall a’ stiùireadh iarrtasan sa chùlaibh gu shannon-1.6-lite, a thèid a chunntadh ann an tokens. Cha chleachd tiotalan seisean agus iarrtasan coltach riutha gairmean Coder an uair sin.
• Bidh Claude Code ag iarraidh meud a’ cho-theacsa air POST /v1/messages/count_tokens. Bidh an endpoint a’ cunntadh airson nam modailean open-weight hosted. Le id Shannon freagraidh e 400; làimhsichidh Claude Code cunntadh token mar rud roghainneil agus measaidh e am meud fhèin. Cunntadh tokens

Gus an seòladh, an iuchair agus id modail a sgrùdadh mus tòisich thu an t-inneal, cuir aon iarrtas le làimh:

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

Bidh Codex CLI a’ bruidhinn ris an Responses API. Mìnich Shannon mar provider modail ann an ~/.codex/config.toml, tagh id modail Shannon an sin, agus cuir d’ iuchair API anns a’ chaochladair àrainneachd a dh’ainmicheas am 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

• Chan eil /v1/responses a’ cumail còmhradh air an server: tha an còmhradh aig gach iarrtas ann an input. Thèid previous_response_id aontachadh airson co-chòrdalachd.
• Thèid innealan function (type: "function") a thabhann dhan mhodail air /v1/responses.
• Air /v1/responses, thèid shannon-coder-1 a chunntadh ann an tokens bhon bhalance agad, chan ann ann an gairmean Coder.

An aon sgrùdadh airson an 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."
  }'

Am modail còdachaidh agus mar a thèid a chunntadh

Is e shannon-coder-1 am modail Shannon airson àidseantan còdachaidh. Bheir GET /v1/models cunntas air le uinneag cho-theacsa de 131,072 tokens, gairmean inneil, reusanachadh agus input teacsa. Thèid a chunntadh ann an aon de dhà dhòigh, a-rèir an endpoint a chleachdas inneal.

Is e gairm aon iarrtas, ge bith dè am meud. Thèid a chunntadh nuair a thèid an t-iarrtas a ghabhail, mus freagair am modail. Cuiridh seisean àidseant aon iarrtas airson gach ceum a ghabhas e, agus mar sin cleachdaidh obair fhada mòran ghairmean. Tha an cuibhreann an urra ris a’ phlana agad agus tòisichidh e a-rithist gach 4 uairean, aig 00:00, 04:00, 08:00, 12:00, 16:00 agus 20:00 UTC.

Seallaidh duilleag a’ phlana na h-àireamhan làithreach. Planaichean

Nuair a thèid gairmean uinneige a chleachdadh, thèid an t-iarrtas a fhreagairt le 429. Air /v1/messages thig an aon mhearachd ann an cruth 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"
  }
}

Cus-lìonadh co-theacsa

Nuair a tha còmhradh nas motha na uinneag cho-theacsa a’ mhodail, freagraidh /v1/chat/completions agus /v1/messages le 400, an seòrsa invalid_request_error, an còd context_length_exceeded agus teachdaireachd a thòisicheas le prompt is too long. Leughaidh innealan còdachaidh a’ mhearachd seo gus an seisean a dhlùthadh agus an t-iarrtas a chur a-rithist. Thèid a thoirt a-mach le shannon-coder-1, shannon-1.6-lite agus 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
  }
}

Is e an teachdaireachd prompt is too long: <sent> tokens > <limit> maximum. Nuair nach eil an dà àireamh aithnichte is e prompt is too long. Please compact the conversation and try again.

Air stream tha an staid 200 mar-thà, agus mar sin thig a’ mhearachd mar thachartas agus dùinidh an stream an uair sin san dòigh àbhaisteach:

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

Na dh’fhaodas lùb àidseant earbsa a chur ann

Fuasgladh dhuilgheadasan

Tha d’ iuchair agus do bhalance air an duilleag Keys & usage. Iuchraichean & cleachdadh