Programatzeko CLI tresnak

Programazio-tresna batek hiru ezarpen behar ditu Shannon-ekin funtzionatzeko: API-aren base URL-a, zure API gakoa eta Shannon modelo-id bat. Orrialde honek Claude Code eta Codex CLI-rentzako ezarpen zehatzak ematen ditu, shannon-coder-1 programazio-modeloa nola kontatzen den azaltzen du, eta tresna hauek aurkitzen dituzten erroreak zerrendatzen ditu.

Tresna bakoitzak zein endpoint erabiltzen duen

Hiru endpoint-ek API gako bera hartzen dute, Authorization: Bearer gisa edo x-api-key gisa. Tresna hauek bidaltzen dituzten anthropic-version, anthropic-beta eta openai-beta goiburuak onartzen dira.

Hautatu Shannon modelo bat

Eskaera guztiek Shannon-ek argitaratzen duen modelo-id bat izendatu behar dute. Programazio-tresna batek bere modelo lehenetsiaren izena bidaltzen du besterik esan ezean, eta Shannon-ek argitaratzen ez duen izen bati 400 eta unknown model: <name> mezuarekin erantzuten zaio. Beste ezein izen ez da Shannon modelo batera mapatzen, beraz ezarri modeloa tresnan lehen eskaera baino lehen.

GET /v1/models-ek id guztiak zerrendatzen ditu beren testuinguru-leihoarekin. Ez du gakorik behar. Modeloak eta prezioak

Programazio-tresnek modeloa system prompt luze batekin gidatzen dute. System prompt-a shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro eta pisu irekiko modelo ostatatuek aplikatzen dute, beraz hautatu horietako bat programazio-tresna baterako.

Claude Code

Claude Code-k bere konexioa ingurune-aldagaietatik irakurtzen du. Ezarri hasten duen shell-ean, edo ~/.claude/settings.json-eko env blokean saio guztietarako mantentzeko.

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

• Ezarri hiru ANTHROPIC_DEFAULT_…_MODEL aldagaiak. Azpiagenteek eta komando batzuek modelo bat bere izen integratuaren bidez eskatzen dute, eta izen bakoitzak Shannon id batera ebatzi behar du.
• Laginak atzeko planoko eskaerak shannon-1.6-lite-ra zuzentzen ditu, tokenetan kontatzen dena. Saio-izenburuek eta antzeko eskaerek orduan ez dituzte Coder deiak erabiltzen.
• Claude Code-k POST /v1/messages/count_tokens-i testuinguruaren tamaina eskatzen dio. Endpoint-ak pisu irekiko modelo ostatatuetarako kontatzen du. Shannon id batekin 400 erantzuten du; Claude Code-k token-kontaketa aukerakotzat hartzen du eta tamaina bere kabuz kalkulatzen du. Tokenen kontaketa

Tresna hasi aurretik helbidea, gakoa eta modelo-id bat egiaztatzeko, bidali eskaera bat eskuz:

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-k Responses API-arekin hitz egiten du. Deskribatu Shannon modelo-hornitzaile gisa ~/.codex/config.toml-en, hautatu han Shannon modelo-id bat, eta jarri zure API gakoa hornitzaileak izendatzen duen ingurune-aldagaian.

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-ek ez du elkarrizketarik gordetzen zerbitzarian: eskaera bakoitzak elkarrizketa input-ean darama. previous_response_id bateragarritasunerako onartzen da.
• Funtzio-tresnak (type: "function") modeloari eskaintzen zaizkio /v1/responses endpoint-ean.
• /v1/responses endpoint-ean, shannon-coder-1 tokenetan kontatzen da zure saldotik, ez Coder deietan.

Egiaztapen bera Responses endpoint-erako:

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

Programazio-modeloa eta nola kontatzen den

shannon-coder-1 programazio-agenteentzako Shannon modeloa da. GET /v1/models-ek 131,072 tokeneko testuinguru-leihoarekin, tresna-deiekin, arrazonamenduarekin eta testu-sarrerarekin jakinarazten du. Bi modutako batean kontatzen da, tresnak erabiltzen duen endpoint-aren arabera.

Dei bat eskaera bat da, tamaina edozein dela ere. Eskaera onartzen denean kontatzen da, modeloak erantzun aurretik. Agente-saio batek eskaera bat bidaltzen du ematen duen urrats bakoitzeko, beraz zeregin luze batek dei asko erabiltzen ditu. Kupoa zure planaren araberakoa da eta 4 orduz behin berriz hasten da, 00:00, 04:00, 08:00, 12:00, 16:00 eta 20:00 UTC-n.

Planen orrialdeak uneko zenbakiak erakusten ditu. Planak

Leiho bateko deiak agortzen direnean, eskaerari 429 erantzuten zaio. /v1/messages endpoint-ean errore bera Anthropic formatuan dator.

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

Testuinguruaren gainezkatzea

Elkarrizketa modeloaren testuinguru-leihoa baino handiagoa denean, /v1/chat/completions eta /v1/messages endpoint-ek 400 erantzuten dute, invalid_request_error motarekin, context_length_exceeded kodearekin eta prompt is too long hasten den mezu batekin. Programazio-tresnek errore hau irakurtzen dute saioa trinkotzeko eta eskaera berriro bidaltzeko. shannon-coder-1, shannon-1.6-lite eta shannon-1.6-pro modeloek sortzen dute.

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

Mezua prompt is too long: <sent> tokens > <limit> maximum da. Bi zenbakiak ezagutzen ez direnean prompt is too long. Please compact the conversation and try again. da.

Stream batean egoera 200 da jada, beraz errorea gertaera gisa iristen da eta streama ondoren ohiko moduan ixten da:

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

Agente-begizta batek zertan fida daitekeen

Arazoak konpontzea

Zure gakoa eta zure saldoa Gakoak eta erabilera orrialdean daude. Gakoak eta erabilera