CLI alati za kodiranje

Alatu za kodiranje trebaju tri postavke da bi radio sa Shannonom: osnovni URL API-ja, vaš API ključ i id Shannon modela. Ova stranica daje točne postavke za Claude Code i Codex CLI, objašnjava kako se broji model za kodiranje shannon-coder-1 i navodi greške na koje ti 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 ti alati šalju se prihvaćaju.

Odaberite Shannon model

Svaki zahtjev mora navesti id modela koji Shannon objavljuje. Alat za kodiranje šalje ime vlastitog zadanog modela osim ako mu ne kažete drugačije, a na ime koje Shannon ne objavljuje odgovara se s 400 i porukom unknown model: <name>. Nijedno drugo ime ne preslikava se na Shannon model, pa model postavite u alatu prije prvog zahtjeva.

GET /v1/models navodi svaki id s njegovim kontekstnim prozorom. Ne treba ključ. Modeli i cijene

Alati za kodiranje usmjeravaju model dugim system promptom. System prompt primjenjuju shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro i hostirani open-weight modeli, pa za alat za kodiranje odaberite jedan od njih.

Claude Code

Claude Code čita svoju vezu iz varijabli okruženja. Postavite ih u ljusci koja ga pokreće ili u bloku env datoteke ~/.claude/settings.json da ostanu 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 varijable ANTHROPIC_DEFAULT_…_MODEL. Subagenti i neke naredbe traže model po ugrađenom imenu, a svako ime mora se razriješiti u Shannon id.
• Primjer usmjerava pozadinske zahtjeve na shannon-1.6-lite, koji se broji u tokenima. Naslovi sesija i slični zahtjevi tada ne troše Coder pozive.
• Claude Code traži od POST /v1/messages/count_tokens veličinu konteksta. Endpoint broji za hostirane open-weight modele. S Shannon id-om odgovara 400; Claude Code smatra brojanje tokena neobaveznim i sam procjenjuje veličinu. Brojanje tokena

Da provjerite adresu, ključ i id modela prije pokretanja alata, pošaljite jedan zahtjev 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 s Responses API-jem. Opišite Shannon kao model providera u ~/.codex/config.toml, ondje odaberite id Shannon modela i stavite svoj API ključ u varijablu okruženja koju provider 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 zahtjev nosi razgovor u input. previous_response_id se prihvaća radi kompatibilnosti.
• Alati tipa funkcija (type: "function") nude se modelu na /v1/responses.
• Na /v1/responses shannon-coder-1 se broji u tokenima s vašeg stanja, a ne u Coder pozivima.

Ista provjera 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 kodiranje i kako se broji

shannon-coder-1 je Shannon model za agente za kodiranje. GET /v1/models ga prijavljuje s kontekstnim prozorom od 131,072 tokena, pozivima alata, rezoniranjem i tekstualnim ulazom. Broji se na jedan od dva načina, ovisno o endpointu koji alat koristi.

Poziv je jedan zahtjev, bez obzira na veličinu. Broji se kada se zahtjev prihvati, prije nego model odgovori. Agentska sesija šalje jedan zahtjev za svaki korak koji poduzme, pa dugi zadatak troši mnogo poziva. Dopušteni broj ovisi o vašem planu i počinje ispočetka svaka 4 sata, u 00:00, 04:00, 08:00, 12:00, 16:00 i 20:00 UTC.

Stranica plana prikazuje trenutačne brojeve. Planovi

Kada se pozivi prozora iskoriste, na zahtjev se odgovara s 429. Na /v1/messages ista greška dolazi 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"
  }
}

Prekoračenje konteksta

Kada je razgovor veći od kontekstnog prozora modela, /v1/chat/completions i /v1/messages odgovaraju s 400, tipom invalid_request_error, kodom context_length_exceeded i porukom koja počinje s prompt is too long. Alati za kodiranje čitaju tu grešku kako bi saželi sesiju i ponovno poslali zahtjev. 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 što se agentska petlja može osloniti

Otklanjanje problema

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