CLI-koodaustyökalut

Koodaustyökalu tarvitsee kolme asetusta toimiakseen Shannonin kanssa: API:n perus-URL:n, API-avaimesi ja Shannon-mallin id:n. Tällä sivulla ovat tarkat asetukset Claude Codelle ja Codex CLI:lle, selitys siitä, miten koodausmalli shannon-coder-1 lasketaan, sekä lista virheistä, joihin nämä työkalut törmäävät.

Mitä päätepistettä kukin työkalu käyttää

Kaikki kolme päätepistettä ottavat saman API-avaimen, otsakkeella Authorization: Bearer tai x-api-key. Näiden työkalujen lähettämät otsakkeet anthropic-version, anthropic-beta ja openai-beta hyväksytään.

Valitse Shannon-malli

Jokaisen pyynnön on nimettävä mallin id, jonka Shannon julkaisee. Koodaustyökalu lähettää oman oletusmallinsa nimen, ellet toisin kerro, ja nimeen, jota Shannon ei julkaise, vastataan 400:lla ja viestillä unknown model: <name>. Mitään muuta nimeä ei kuvata Shannon-malliksi, joten aseta malli työkalussa ennen ensimmäistä pyyntöä.

GET /v1/models listaa jokaisen id:n kontekstikokoineen. Se ei tarvitse avainta. Mallit ja hinnoittelu

Koodaustyökalut ohjaavat mallia pitkällä system promptilla. System promptin soveltavat shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro ja hostatut avoimen painon mallit, joten valitse koodaustyökalulle jokin näistä.

Claude Code

Claude Code lukee yhteytensä ympäristömuuttujista. Aseta ne sen käynnistävässä shellissä tai tiedoston ~/.claude/settings.json env-lohkossa, jotta ne säilyvät jokaiselle istunnolle.

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

• Aseta kaikki kolme ANTHROPIC_DEFAULT_…_MODEL-muuttujaa. Aliagentit ja jotkin komennot pyytävät mallia sen sisäänrakennetulla nimellä, ja jokaisen nimen on ratkettava Shannon-id:ksi.
• Esimerkki ohjaa taustapyynnöt malliin shannon-1.6-lite, joka lasketaan tokeneina. Istuntojen otsikot ja vastaavat pyynnöt eivät tällöin kuluta Coder-kutsuja.
• Claude Code kysyy päätepisteeltä POST /v1/messages/count_tokens kontekstin koon. Päätepiste laskee hostatuille avoimen painon malleille. Shannon-id:llä se vastaa 400; Claude Code pitää tokenien laskentaa valinnaisena ja arvioi koon itse. Tokenien laskenta

Voit tarkistaa osoitteen, avaimen ja mallin id:n ennen työkalun käynnistämistä lähettämällä yhden pyynnön käsin:

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 keskustelee Responses API:n kanssa. Kuvaa Shannon malliproviderina tiedostossa ~/.codex/config.toml, valitse siellä Shannon-mallin id ja laita API-avaimesi ympäristömuuttujaan, jonka provider nimeää.

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 säilytä keskustelua palvelimella: jokainen pyyntö kuljettaa keskustelun kentässä input. previous_response_id hyväksytään yhteensopivuuden vuoksi.
• Funktiotyökalut (type: "function") tarjotaan mallille päätepisteessä /v1/responses.
• Päätepisteessä /v1/responses shannon-coder-1 lasketaan saldostasi tokeneina, ei Coder-kutsuina.

Sama tarkistus Responses-päätepisteelle:

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

Koodausmalli ja miten se lasketaan

shannon-coder-1 on Shannon-malli koodausagenteille. GET /v1/models ilmoittaa sille 131,072 tokenin kontekstikoon, työkalukutsut, päättelyn ja tekstisyötteen. Se lasketaan jommallakummalla tavalla riippuen siitä, mitä päätepistettä työkalu käyttää.

Kutsu on yksi pyyntö koosta riippumatta. Se lasketaan, kun pyyntö hyväksytään, ennen kuin malli vastaa. Agenttiistunto lähettää yhden pyynnön jokaista askeltaan kohti, joten pitkä tehtävä kuluttaa monta kutsua. Kiintiö riippuu tilauksestasi ja alkaa alusta 4 tunnin välein, kello 00:00, 04:00, 08:00, 12:00, 16:00 ja 20:00 UTC.

Tilaussivu näyttää nykyiset luvut. Tilaukset

Kun jakson kutsut on käytetty, pyyntöön vastataan 429:llä. Päätepisteessä /v1/messages sama virhe tulee Anthropic-muodossa.

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

Kontekstin ylitys

Kun keskustelu on suurempi kuin mallin kontekstikoko, /v1/chat/completions ja /v1/messages vastaavat 400:lla, tyypillä invalid_request_error, koodilla context_length_exceeded ja viestillä, joka alkaa sanoilla prompt is too long. Koodaustyökalut lukevat tämän virheen tiivistääkseen istunnon ja lähettääkseen pyynnön uudelleen. Sen tuottavat 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
  }
}

Viesti on prompt is too long: <sent> tokens > <limit> maximum. Kun lukuja ei tiedetä, se on prompt is too long. Please compact the conversation and try again.

Virrassa tila on jo 200, joten virhe saapuu tapahtumana ja virta sulkeutuu sen jälkeen normaalisti:

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

Mihin agenttiluuppi voi luottaa

Vianmääritys

Avaimesi ja saldosi ovat sivulla Avaimet ja käyttö. Avaimet ja käyttö