Offer codio CLI

Mae offeryn codio angen tri gosodiad i weithio gyda Shannon: URL sylfaen yr API, eich allwedd API ac id model Shannon. Mae'r dudalen hon yn rhoi'r union osodiadau ar gyfer Claude Code a Codex CLI, yn egluro sut y caiff y model codio shannon-coder-1 ei gyfrif, ac yn rhestru'r gwallau y mae'r offer hyn yn eu cyfarfod.

Pa bwynt terfyn y mae pob offeryn yn ei ddefnyddio

Mae'r tri phwynt terfyn yn derbyn yr un allwedd API, fel Authorization: Bearer neu fel x-api-key. Derbynnir y penawdau anthropic-version, anthropic-beta ac openai-beta y mae'r offer hyn yn eu hanfon.

Dewis model Shannon

Rhaid i bob cais enwi id model y mae Shannon yn ei gyhoeddi. Mae offeryn codio yn anfon enw ei fodel rhagosodedig ei hun oni ddywedwch yn wahanol, ac atebir enw nad yw Shannon yn ei gyhoeddi gyda 400 a'r neges unknown model: <name>. Nid oes unrhyw enw arall yn cael ei fapio i fodel Shannon, felly gosodwch y model yn yr offeryn cyn y cais cyntaf.

Mae GET /v1/models yn rhestru pob id gyda'i ffenestr cyd-destun. Nid oes angen allwedd arno. Modelau a phrisiau

Mae offer codio yn llywio'r model gyda system prompt hir. Mae'r system prompt yn cael ei gymhwyso gan shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro a'r modelau pwysau agored a gynhelir, felly dewiswch un o'r rhain ar gyfer offeryn codio.

Claude Code

Mae Claude Code yn darllen ei gysylltiad o newidynnau amgylchedd. Gosodwch nhw yn y gragen sy'n ei gychwyn, neu ym mloc env ~/.claude/settings.json i'w cadw ar gyfer pob sesiwn.

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

• Gosodwch y tri newidyn ANTHROPIC_DEFAULT_…_MODEL i gyd. Mae is-asiantau a rhai gorchmynion yn gofyn am fodel yn ôl ei enw adeiledig, a rhaid i bob enw ddatrys i id Shannon.
• Mae'r sampl yn pwyntio ceisiadau cefndir at shannon-1.6-lite, a gyfrifir mewn tokenau. Yna nid yw teitlau sesiynau a cheisiadau tebyg yn defnyddio galwadau Coder.
• Mae Claude Code yn gofyn i POST /v1/messages/count_tokens am faint y cyd-destun. Mae'r pwynt terfyn yn cyfrif ar gyfer y modelau pwysau agored a gynhelir. Gydag id Shannon mae'n ateb 400; mae Claude Code yn trin cyfrif tokenau fel dewisol ac yn amcangyfrif y maint ei hun. Cyfrif tokenau

I wirio'r cyfeiriad, yr allwedd ac id model cyn i chi gychwyn yr offeryn, anfonwch un cais â llaw:

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

Mae Codex CLI yn siarad â'r Responses API. Disgrifiwch Shannon fel darparwr model yn ~/.codex/config.toml, dewiswch id model Shannon yno, a rhowch eich allwedd API yn y newidyn amgylchedd y mae'r darparwr yn ei enwi.

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

• Nid yw /v1/responses yn cadw sgwrs ar y gweinydd: mae pob cais yn cario'r sgwrs yn input. Derbynnir previous_response_id er cydnawsedd.
• Cynigir offer ffwythiant (type: "function") i'r model ar /v1/responses.
• Ar /v1/responses, cyfrifir shannon-coder-1 mewn tokenau o'ch balans, nid mewn galwadau Coder.

Yr un gwiriad ar gyfer y pwynt terfyn 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."
  }'

Y model codio a sut y caiff ei gyfrif

shannon-coder-1 yw'r model Shannon ar gyfer asiantau codio. Mae GET /v1/models yn ei adrodd gyda ffenestr cyd-destun o 131,072 token, galwadau offer, rhesymu a mewnbwn testun. Fe'i cyfrifir mewn un o ddwy ffordd, yn dibynnu ar y pwynt terfyn y mae offeryn yn ei ddefnyddio.

Un cais yw galwad, beth bynnag fo'i faint. Fe'i cyfrifir pan dderbynnir y cais, cyn i'r model ateb. Mae sesiwn asiant yn anfon un cais ar gyfer pob cam y mae'n ei gymryd, felly mae tasg hir yn defnyddio llawer o alwadau. Mae'r lwfans yn dibynnu ar eich cynllun ac yn dechrau eto bob 4 awr, am 00:00, 04:00, 08:00, 12:00, 16:00 a 20:00 UTC.

Mae tudalen y cynlluniau yn dangos y rhifau cyfredol. Cynlluniau

Pan ddefnyddir galwadau ffenestr i gyd, atebir y cais gyda 429. Ar /v1/messages daw'r un gwall ar ffurf 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"
  }
}

Gorlif cyd-destun

Pan fo sgwrs yn fwy na ffenestr cyd-destun y model, mae /v1/chat/completions a /v1/messages yn ateb gyda 400, y math invalid_request_error, y cod context_length_exceeded a neges sy'n dechrau gyda prompt is too long. Mae offer codio yn darllen y gwall hwn i gywasgu'r sesiwn ac anfon y cais eto. Fe'i cynhyrchir gan shannon-coder-1, shannon-1.6-lite a 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
  }
}

Y neges yw prompt is too long: <sent> tokens > <limit> maximum. Pan nad yw'r ddau rif yn hysbys, y neges yw prompt is too long. Please compact the conversation and try again.

Ar ffrwd mae'r statws eisoes yn 200, felly mae'r gwall yn cyrraedd fel digwyddiad ac yna mae'r ffrwd yn cau yn y ffordd arferol:

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

Yr hyn y gall dolen asiant ddibynnu arno

Datrys problemau

Mae eich allwedd a'ch balans ar y dudalen Keys & usage. Allweddi a defnydd