CLI kodeerimistööriistad

Kodeerimistööriist vajab Shannoniga töötamiseks kolme seadet: API base URL, sinu API võti ja Shannoni mudeli id. See leht annab Claude Code'i ja Codex CLI täpsed seaded, selgitab, kuidas kodeerimismudelit shannon-coder-1 loetakse, ja loetleb vead, millega need tööriistad kokku puutuvad.

Millist lõpp-punkti iga tööriist kasutab

Kõik kolm lõpp-punkti võtavad sama API võtit, kujul Authorization: Bearer või x-api-key. Päised anthropic-version, anthropic-beta ja openai-beta, mida need tööriistad saadavad, võetakse vastu.

Vali Shannoni mudel

Iga päring peab nimetama mudeli id, mille Shannon avaldab. Kodeerimistööriist saadab oma vaikemudeli nime, kui sa ei ütle teisiti, ja nimele, mida Shannon ei avalda, vastatakse 400 ja teatega unknown model: <name>. Ühtegi muud nime ei vastendata Shannoni mudelile, seega määra mudel tööriistas enne esimest päringut.

GET /v1/models loetleb iga id koos kontekstiaknaga. See ei vaja võtit. Mudelid ja hinnad

Kodeerimistööriistad juhivad mudelit pika süsteemipromptiga. Süsteemiprompti rakendavad shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro ja hostitud avatud kaaludega mudelid, seega vali kodeerimistööriista jaoks üks neist.

Claude Code

Claude Code loeb oma ühenduse keskkonnamuutujatest. Määra need kestas, mis selle käivitab, või failis ~/.claude/settings.json ploki env sees, et need iga sessiooni jaoks säiliksid.

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

• Määra kõik kolm ANTHROPIC_DEFAULT_…_MODEL muutujat. Subagendid ja mõned käsud küsivad mudelit selle sisseehitatud nime järgi ja iga nimi peab lahenduma Shannoni id-ks.
• Näide suunab taustapäringud mudelile shannon-1.6-lite, mida loetakse tokenites. Sessiooni pealkirjad ja sarnased päringud ei kasuta siis Coderi kõnesid.
• Claude Code küsib POST /v1/messages/count_tokens kaudu konteksti suurust. Lõpp-punkt loeb hostitud avatud kaaludega mudelitele. Shannoni id puhul vastab see 400; Claude Code peab tokenite lugemist valikuliseks ja hindab suuruse ise. Tokenite lugemine

Aadressi, võtme ja mudeli id kontrollimiseks enne tööriista käivitamist saada üks päring käsitsi:

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 räägib Responses API-ga. Kirjelda Shannon mudelipakkujana failis ~/.codex/config.toml, vali seal Shannoni mudeli id ja pane oma API võti keskkonnamuutujasse, mille pakkuja nimetab.

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 ei hoia serveris vestlust: iga päring kannab vestlust väljas input. previous_response_id võetakse ühilduvuse tarbeks vastu.
• Funktsioonitööriistad (type: "function") pakutakse mudelile lõpp-punktis /v1/responses.
• Lõpp-punktis /v1/responses loetakse shannon-coder-1 sinu saldost tokenites, mitte Coderi kõnedes.

Sama kontroll Responses lõpp-punkti jaoks:

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

Kodeerimismudel ja kuidas seda loetakse

shannon-coder-1 on Shannoni mudel kodeerimisagentidele. GET /v1/models teatab selle 131,072 tokeni kontekstiaknaga, tööriistakutsete, arutluse ja tekstisisendiga. Seda loetakse kahel viisil, olenevalt lõpp-punktist, mida tööriist kasutab.

Kõne on üks päring, olenemata suurusest. See loetakse, kui päring vastu võetakse, enne mudeli vastust. Agendisessioon saadab iga sammu kohta ühe päringu, seega kasutab pikk ülesanne palju kõnesid. Limiit sõltub sinu paketist ja algab uuesti iga 4 tunni järel, kell 00:00, 04:00, 08:00, 12:00, 16:00 ja 20:00 UTC.

Paketi leht näitab praeguseid numbreid. Paketid

Kui akna kõned on kasutatud, vastatakse päringule 429. Lõpp-punktis /v1/messages tuleb sama viga Anthropic kujul.

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

Konteksti ületäitumine

Kui vestlus on suurem kui mudeli kontekstiaken, vastavad /v1/chat/completions ja /v1/messages koodiga 400, tüübiga invalid_request_error, koodiga context_length_exceeded ja teatega, mis algab prompt is too long. Kodeerimistööriistad loevad seda viga, et sessiooni tihendada ja päring uuesti saata. Selle annavad shannon-coder-1, shannon-1.6-lite ja 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
  }
}

Teade on prompt is too long: <sent> tokens > <limit> maximum. Kui kaks arvu ei ole teada, on see prompt is too long. Please compact the conversation and try again.

Voos on olek juba 200, seega saabub viga sündmusena ja voog sulgub seejärel tavapäraselt:

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

Mida agenditsükkel saab usaldada

Tõrkeotsing

Sinu võti ja saldo on lehel Võtmed ja kasutus. Võtmed ja kasutus