CLI alati za programiranje

Alatu za programiranje trebaju tri podešavanja da radi sa Shannonom: osnovni URL API-ja, vaš API ključ i id Shannon modela. Ova stranica daje tačna podešavanja za Claude Code i Codex CLI, objašnjava kako se računa model za programiranje shannon-coder-1 i navodi greške na koje ovi alati nailaze.

Koji endpoint koristi koji alat

Sva tri endpointa primaju isti API ključ, kao Authorization: Bearer ili kao x-api-key. Zaglavlja anthropic-version, anthropic-beta i openai-beta koja ovi alati šalju se prihvataju.

Izaberite Shannon model

Svaki zahtev mora da navede id modela koji Shannon objavljuje. Alat za programiranje šalje ime sopstvenog podrazumevanog modela osim ako mu ne kažete drugačije, a na ime koje Shannon ne objavljuje odgovara se sa 400 i porukom unknown model: <name>. Nijedno drugo ime se ne preslikava u Shannon model, zato postavite model u alatu pre prvog zahteva.

GET /v1/models navodi svaki id sa kontekstnim prozorom. Ne traži ključ. Modeli i cene

Alati za programiranje usmeravaju model dugim system promptom. System prompt primenjuju shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro i hostovani open-weight modeli, zato za alat za programiranje izaberite jedan od njih.

Claude Code

Claude Code čita svoju vezu iz promenljivih okruženja. Postavite ih u shell-u koji ga pokreće, ili u bloku env u ~/.claude/settings.json da ih zadržite za svaku sesiju.

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

• Postavite sve tri promenljive ANTHROPIC_DEFAULT_…_MODEL. Subagenti i neke komande traže model po njegovom ugrađenom imenu, a svako ime mora da se razreši u Shannon id.
• Primer usmerava pozadinske zahteve na shannon-1.6-lite, koji se računa u tokenima. Naslovi sesija i slični zahtevi tada ne troše Coder pozive.
• Claude Code traži od POST /v1/messages/count_tokens veličinu konteksta. Endpoint broji za hostovane open-weight modele. Sa Shannon id-jem odgovara 400; Claude Code smatra brojanje tokena opcionim i sam procenjuje veličinu. Brojanje tokena

Da proverite adresu, ključ i id modela pre pokretanja alata, pošaljite jedan zahtev ručno:

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 komunicira sa Responses API-jem. Opišite Shannon kao provajdera modela u ~/.codex/config.toml, tamo izaberite id Shannon modela i stavite svoj API ključ u promenljivu okruženja koju provajder navodi.

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 ne čuva razgovor na serveru: svaki zahtev nosi razgovor u input. previous_response_id se prihvata radi kompatibilnosti.
• Funkcijski alati (type: "function") nude se modelu na /v1/responses.
• Na /v1/responses shannon-coder-1 se računa u tokenima sa vašeg stanja, a ne u Coder pozivima.

Ista provera za Responses endpoint:

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

Model za programiranje i kako se računa

shannon-coder-1 je Shannon model za agente za programiranje. GET /v1/models ga prijavljuje sa kontekstnim prozorom od 131,072 tokena, pozivima alata, reasoningom i tekstom na ulazu. Računa se na jedan od dva načina, zavisno od endpointa koji alat koristi.

Poziv je jedan zahtev, bez obzira na veličinu. Računa se kada se zahtev prihvati, pre nego što model odgovori. Agentska sesija šalje po jedan zahtev za svaki korak koji napravi, pa dug zadatak troši mnogo poziva. Dozvola zavisi od vašeg plana i počinje iznova na svaka 4 sata, u 00:00, 04:00, 08:00, 12:00, 16:00 i 20:00 UTC.

Stranica plana prikazuje trenutne brojeve. Planovi

Kada se pozivi jednog perioda potroše, na zahtev se odgovara sa 429. Na /v1/messages ista greška stiže u Anthropic obliku.

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

Prelivanje konteksta

Kada je razgovor veći od kontekstnog prozora modela, /v1/chat/completions i /v1/messages odgovaraju sa 400, tipom invalid_request_error, kodom context_length_exceeded i porukom koja počinje sa prompt is too long. Alati za programiranje čitaju ovu grešku da sažmu sesiju i ponovo pošalju zahtev. Proizvode je shannon-coder-1, shannon-1.6-lite i 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
  }
}

Poruka je prompt is too long: <sent> tokens > <limit> maximum. Kada dva broja nisu poznata, poruka je prompt is too long. Please compact the conversation and try again.

Na streamu je status već 200, pa greška stiže kao događaj, a stream se zatim zatvara na uobičajen način:

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

Na šta se petlja agenta može osloniti

Rešavanje problema

Vaš ključ i stanje nalaze se na stranici Ključevi i upotreba. Ključevi i upotreba