CLI alati za kodiranje

Alatu za kodiranje trebaju tri postavke da bi radio sa Shannonom: osnovni URL API-ja, vaš API ključ i Shannon id modela. Ova stranica daje tač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 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.

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 se ne preslikava u Shannon model, zato postavite model 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 shellu 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 varijable ANTHROPIC_DEFAULT_…_MODEL. Subagenti i neke komande traže model po njegovom 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. Sa Shannon idom odgovara 400; Claude Code smatra brojanje tokena opcionalnim 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 provider modela u ~/.codex/config.toml, tamo odaberite Shannon id modela i stavite svoj API ključ u varijablu okruženja koju provider imenuje.

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 prihvata zbog kompatibilnosti.
• Alati-funkcije (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, reasoningom 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 što model odgovori. Sesija agenta šalje jedan zahtjev za svaki korak, pa dug zadatak troši mnogo poziva. Kvota ovisi o vašem planu i počinje ponovo 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 prozora potroše, 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"
  }
}

Prelijevanje 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 ovu grešku da sažmu sesiju i ponovo pošalju 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 šta se petlja agenta može osloniti

Rješavanje problema

Vaš ključ i vaše stanje su na stranici Ključevi i korištenje. Ključevi i korištenje