CLI kodēšanas rīki

Lai kodēšanas rīks darbotos ar Shannon, vajag trīs iestatījumus: API bāzes URL, jūsu API atslēgu un Shannon modeļa id. Šajā lapā ir precīzi iestatījumi Claude Code un Codex CLI, paskaidrots, kā tiek skaitīts kodēšanas modelis shannon-coder-1, un uzskaitītas kļūdas, ar kurām šie rīki sastopas.

Kuru galapunktu izmanto katrs rīks

Visi trīs galapunkti pieņem to pašu API atslēgu, kā Authorization: Bearer vai kā x-api-key. Galvenes anthropic-version, anthropic-beta un openai-beta, ko šie rīki sūta, tiek pieņemtas.

Izvēlieties Shannon modeli

Katram pieprasījumam jānorāda modeļa id, ko Shannon publicē. Kodēšanas rīks sūta sava noklusējuma modeļa nosaukumu, ja neliekat citādi, un uz nosaukumu, ko Shannon nepublicē, atbild ar 400 un ziņojumu unknown model: <name>. Neviens cits nosaukums netiek attēlots uz Shannon modeli, tāpēc iestatiet modeli rīkā pirms pirmā pieprasījuma.

GET /v1/models uzskaita katru id ar tā konteksta logu. Atslēga nav vajadzīga. Modeļi un cenas

Kodēšanas rīki modeli vada ar garu sistēmas uzvedni. Sistēmas uzvedni piemēro shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro un hostētie atvērto svaru modeļi, tāpēc kodēšanas rīkam izvēlieties kādu no tiem.

Claude Code

Claude Code savienojumu nolasa no vides mainīgajiem. Iestatiet tos čaulā, kas to palaiž, vai ~/.claude/settings.json blokā env, lai tie paliktu visām sesijām.

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

• Iestatiet visus trīs ANTHROPIC_DEFAULT_…_MODEL mainīgos. Apakšaģenti un dažas komandas pieprasa modeli pēc tā iebūvētā nosaukuma, un katram nosaukumam jāatrisinās uz Shannon id.
• Paraugā fona pieprasījumi tiek vērsti uz shannon-1.6-lite, kas tiek skaitīts tokenos. Sesiju nosaukumi un līdzīgi pieprasījumi tad neizmanto Coder izsaukumus.
• Claude Code pieprasa POST /v1/messages/count_tokens konteksta izmēru. Galapunkts skaita hostētajiem atvērto svaru modeļiem. Ar Shannon id tas atbild 400; Claude Code tokenu skaitīšanu uzskata par neobligātu un izmēru novērtē pats. Tokenu skaitīšana

Lai pārbaudītu adresi, atslēgu un modeļa id pirms rīka palaišanas, nosūtiet vienu pieprasījumu ar roku:

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 sazinās ar Responses API. Aprakstiet Shannon kā modeļu nodrošinātāju failā ~/.codex/config.toml, tur izvēlieties Shannon modeļa id un ievietojiet savu API atslēgu vides mainīgajā, ko nodrošinātājs nosauc.

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 serverī sarunu neglabā: katrs pieprasījums nes sarunu laukā input. previous_response_id tiek pieņemts saderības dēļ.
• Funkciju rīki (type: "function") modelim tiek piedāvāti galapunktā /v1/responses.
• Galapunktā /v1/responses shannon-coder-1 tiek skaitīts tokenos no jūsu atlikuma, nevis Coder izsaukumos.

Tāda pati pārbaude Responses galapunktam:

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

Kodēšanas modelis un kā to skaita

shannon-coder-1 ir Shannon modelis kodēšanas aģentiem. GET /v1/models to norāda ar konteksta logu 131,072 tokeni, rīku izsaukumiem, spriešanu un teksta ievadi. To skaita vienā no diviem veidiem, atkarībā no galapunkta, ko izmanto rīks.

Izsaukums ir viens pieprasījums neatkarīgi no tā izmēra. To skaita, kad pieprasījums tiek pieņemts, pirms modelis atbild. Aģenta sesija sūta vienu pieprasījumu katram solim, tāpēc gari uzdevumi izmanto daudz izsaukumu. Kvota ir atkarīga no jūsu plāna un sākas no jauna ik pēc 4 stundām: plkst. 00:00, 04:00, 08:00, 12:00, 16:00 un 20:00 UTC.

Plāna lapā redzami pašreizējie skaitļi. Plāni

Kad loga izsaukumi ir izlietoti, uz pieprasījumu atbild ar 429. Galapunktā /v1/messages tā pati kļūda nāk Anthropic formā.

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

Konteksta pārpilde

Kad saruna ir lielāka par modeļa konteksta logu, /v1/chat/completions un /v1/messages atbild ar 400, tipu invalid_request_error, kodu context_length_exceeded un ziņojumu, kas sākas ar prompt is too long. Kodēšanas rīki šo kļūdu nolasa, lai saspiestu sesiju un nosūtītu pieprasījumu vēlreiz. To rada shannon-coder-1, shannon-1.6-lite un 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
  }
}

Ziņojums ir prompt is too long: <sent> tokens > <limit> maximum. Ja abi skaitļi nav zināmi, tas ir prompt is too long. Please compact the conversation and try again.

Straumē statuss jau ir 200, tāpēc kļūda ierodas kā notikums, un straume tad aizveras parastā veidā:

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

Uz ko aģentu cikls var paļauties

Problēmu novēršana

Jūsu atslēga un atlikums ir lapā Atslēgas un izmantošana. Atslēgas un izmantošana