CLI programavimo įrankiai

Programavimo įrankiui dirbti su Shannon reikia trijų nustatymų: API bazinio URL, jūsų API rakto ir Shannon modelio id. Šiame puslapyje pateikti tikslūs Claude Code ir Codex CLI nustatymai, paaiškinta, kaip skaičiuojamas programavimo modelis shannon-coder-1, ir išvardytos klaidos, su kuriomis šie įrankiai susiduria.

Kurį galinį tašką naudoja kiekvienas įrankis

Visi trys galiniai taškai priima tą patį API raktą, kaip Authorization: Bearer arba kaip x-api-key. Antraštės anthropic-version, anthropic-beta ir openai-beta, kurias šie įrankiai siunčia, priimamos.

Pasirinkite Shannon modelį

Kiekviena užklausa turi nurodyti Shannon paskelbtą modelio id. Programavimo įrankis siunčia savo numatytojo modelio pavadinimą, nebent nurodysite kitaip, o Shannon nepaskelbtas pavadinimas atsakomas 400 ir pranešimu unknown model: <name>. Joks kitas pavadinimas nesiejamas su Shannon modeliu, todėl modelį įrankyje nustatykite prieš pirmąją užklausą.

GET /v1/models išvardija kiekvieną id su jo konteksto langu. Raktas nereikalingas. Modeliai ir kainos

Programavimo įrankiai modelį valdo ilgais sistemos nurodymais. Sistemos nurodymus taiko shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro ir talpinami atvirų svorių modeliai, todėl programavimo įrankiui pasirinkite vieną iš jų.

Claude Code

Claude Code ryšio nustatymus skaito iš aplinkos kintamųjų. Nustatykite juos apvalkale, kuris jį paleidžia, arba ~/.claude/settings.json bloke env, kad jie liktų kiekvienai sesijai.

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

• Nustatykite visus tris ANTHROPIC_DEFAULT_…_MODEL kintamuosius. Subagentai ir kai kurios komandos prašo modelio pagal jo įtaisytąjį pavadinimą, ir kiekvienas pavadinimas turi atitikti Shannon id.
• Pavyzdyje foninės užklausos nukreipiamos į shannon-1.6-lite, kuris skaičiuojamas tokenais. Sesijų pavadinimai ir panašios užklausos tada nenaudoja Coder kreipinių.
• Claude Code per POST /v1/messages/count_tokens klausia konteksto dydžio. Galinis taškas skaičiuoja talpinamiems atvirų svorių modeliams. Su Shannon id jis atsako 400; Claude Code tokenų skaičiavimą laiko neprivalomu ir dydį įvertina pats. Tokenų skaičiavimas

Norėdami patikrinti adresą, raktą ir modelio id prieš paleisdami įrankį, išsiųskite vieną užklausą rankiniu būdu:

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 kalbasi su Responses API. Aprašykite Shannon kaip modelių teikėją faile ~/.codex/config.toml, pasirinkite ten Shannon modelio id ir savo API raktą įrašykite į aplinkos kintamąjį, kurį nurodo teikėjas.

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 serveryje pokalbio nelaiko: kiekviena užklausa perduoda pokalbį input. previous_response_id priimamas dėl suderinamumo.
• Funkcijų įrankiai (type: "function") modeliui pateikiami galiniame taške /v1/responses.
• Galiniame taške /v1/responses shannon-coder-1 skaičiuojamas tokenais iš jūsų balanso, o ne Coder kreipiniais.

Ta pati patikra Responses galiniam taškui:

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

Programavimo modelis ir kaip jis skaičiuojamas

shannon-coder-1 yra Shannon modelis programavimo agentams. GET /v1/models jį pateikia su 131,072 tokenų konteksto langu, įrankių kreipiniais, mąstymu ir teksto įvestimi. Jis skaičiuojamas vienu iš dviejų būdų, priklausomai nuo galinio taško, kurį naudoja įrankis.

Kreipinys yra viena užklausa, nesvarbu, kokio dydžio. Jis įskaičiuojamas užklausą priėmus, prieš modeliui atsakant. Agento sesija siunčia vieną užklausą kiekvienam savo žingsniui, todėl ilga užduotis sunaudoja daug kreipinių. Kvota priklauso nuo jūsų plano ir atsinaujina kas 4 valandas: 00:00, 04:00, 08:00, 12:00, 16:00 ir 20:00 UTC.

Dabartiniai skaičiai matomi plano puslapyje. Planai

Kai lango kreipiniai išnaudojami, užklausa atsakoma 429. Galiniame taške /v1/messages ta pati klaida ateina Anthropic forma.

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

Konteksto perpildymas

Kai pokalbis didesnis už modelio konteksto langą, /v1/chat/completions ir /v1/messages atsako 400, tipu invalid_request_error, kodu context_length_exceeded ir pranešimu, prasidedančiu prompt is too long. Programavimo įrankiai pagal šią klaidą suspaudžia sesiją ir siunčia užklausą iš naujo. Ją sukuria shannon-coder-1, shannon-1.6-lite ir 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
  }
}

Pranešimas yra prompt is too long: <sent> tokens > <limit> maximum. Kai abu skaičiai nežinomi, jis yra prompt is too long. Please compact the conversation and try again.

Sraute būsena jau yra 200, todėl klaida ateina kaip įvykis, o srautas tada užsidaro įprastai:

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

Kuo gali pasikliauti agento ciklas

Problemų sprendimas

Jūsų raktas ir balansas yra puslapyje Raktai ir naudojimas. Raktai ir naudojimas