CLI-forritunartól

Forritunartól þarf þrjár stillingar til að virka með Shannon: base URL API, API-lykilinn þinn og Shannon-líkanauðkenni. Þessi síða gefur nákvæmar stillingar fyrir Claude Code og Codex CLI, útskýrir hvernig forritunarlíkanið shannon-coder-1 er talið og telur upp villurnar sem þessi tól rekast á.

Hvaða endapunkt hvert tól notar

Allir þrír endapunktarnir taka við sama API-lykli, sem Authorization: Bearer eða sem x-api-key. Hausarnir anthropic-version, anthropic-beta og openai-beta sem þessi tól senda eru samþykktir.

Veldu Shannon-líkan

Hver beiðni verður að nefna líkanauðkenni sem Shannon gefur út. Forritunartól sendir heiti síns eigin sjálfgefna líkans nema þú segir því annað, og heiti sem Shannon gefur ekki út er svarað með 400 og skilaboðunum unknown model: <name>. Ekkert annað heiti er varpað á Shannon-líkan, svo stilltu líkanið í tólinu áður en fyrsta beiðnin er send.

GET /v1/models telur upp öll auðkenni með samhengisglugga. Það þarf engan lykil. Líkön og verð

Forritunartól stýra líkaninu með löngum system prompt. System prompt er virtur af shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro og hýstum líkönum með opnum þyngdum, svo veldu eitt þeirra fyrir forritunartól.

Claude Code

Claude Code les tenginguna sína úr umhverfisbreytum. Stilltu þær í skelinni sem ræsir það, eða í env blokkinni í ~/.claude/settings.json til að halda þeim fyrir allar lotur.

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

• Stilltu allar þrjár ANTHROPIC_DEFAULT_…_MODEL breyturnar. Undirumboðsmenn og sumar skipanir biðja um líkan eftir innbyggðu nafni þess, og hvert nafn verður að leysast í Shannon-auðkenni.
• Dæmið beinir bakgrunnsbeiðnum að shannon-1.6-lite, sem er talið í táknum. Lotuheiti og áþekkar beiðnir nota þá ekki Coder köll.
• Claude Code spyr POST /v1/messages/count_tokens um stærð samhengisins. Endapunkturinn telur fyrir hýst líkön með opnum þyngdum. Með Shannon-auðkenni svarar hann 400; Claude Code lítur á táknatalningu sem valfrjálsa og áætlar stærðina sjálft. Tókatalning

Til að athuga vistfangið, lykilinn og líkanauðkenni áður en þú ræsir tólið skaltu senda eina beiðni í höndunum:

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 talar við Responses API. Lýstu Shannon sem líkanaþjónustuaðila í ~/.codex/config.toml, veldu Shannon-líkanauðkenni þar og settu API-lykilinn þinn í umhverfisbreytuna sem þjónustuaðilinn nefnir.

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 geymir ekkert samtal á þjóninum: hver beiðni ber samtalið í input. previous_response_id er samþykkt vegna samhæfni.
• Fallatól (type: "function") eru boðin líkaninu á /v1/responses.
• Á /v1/responses er shannon-coder-1 talið í táknum af stöðunni þinni, ekki í Coder köllum.

Sama athugun fyrir Responses-endapunktinn:

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

Forritunarlíkanið og hvernig það er talið

shannon-coder-1 er Shannon-líkanið fyrir forritunarumboðsmenn. GET /v1/models sýnir það með 131,072 tákna samhengisglugga, tólakölum, rökhugsun og textainntaki. Það er talið á einn af tveimur vegum, eftir því hvaða endapunkt tól notar.

Kall er ein beiðni, hver sem stærð hennar er. Það er talið þegar beiðnin er samþykkt, áður en líkanið svarar. Umboðsmannslota sendir eina beiðni fyrir hvert skref sem hún tekur, svo langt verkefni notar mörg köll. Úthlutunin fer eftir áskriftinni þinni og hefst á ný á 4 klukkustunda fresti, kl. 00:00, 04:00, 08:00, 12:00, 16:00 og 20:00 UTC.

Áskriftarsíðan sýnir núverandi tölur. Áskriftir

Þegar köll glugga eru uppurin er beiðninni svarað með 429. Á /v1/messages kemur sama villa á Anthropic-forminu.

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

Samhengisflæði

Þegar samtal er stærra en samhengisgluggi líkansins svara /v1/chat/completions og /v1/messages með 400, gerðinni invalid_request_error, kóðanum context_length_exceeded og skilaboðum sem byrja á prompt is too long. Forritunartól lesa þessa villu til að þjappa lotunni og senda beiðnina aftur. Hún er framleidd af shannon-coder-1, shannon-1.6-lite og 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
  }
}

Skilaboðin eru prompt is too long: <sent> tokens > <limit> maximum. Þegar tölurnar tvær eru óþekktar eru þau prompt is too long. Please compact the conversation and try again.

Á streymi er staðan þegar 200, svo villan berst sem atburður og straumnum er síðan lokað á venjulegan hátt:

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

Á hvað umboðsmannalykkja getur treyst

Bilanaleit

Lykillinn þinn og staðan eru á síðunni Lyklar og notkun. Lyklar og notkun