CLI kodlaşdırma alətləri

Kodlaşdırma aləti Shannon ilə işləmək üçün üç parametrə ehtiyac duyur: API-nin əsas URL-i, API açarınız və Shannon model id-si. Bu səhifə Claude Code və Codex CLI üçün dəqiq parametrləri verir, shannon-coder-1 kodlaşdırma modelinin necə sayıldığını izah edir və bu alətlərin rastlaşdığı xətaları siyahıya alır.

Hər alətin hansı endpoint-dən istifadə etdiyi

Hər üç endpoint eyni API açarını Authorization: Bearer və ya x-api-key kimi qəbul edir. Bu alətlərin göndərdiyi anthropic-version, anthropic-beta və openai-beta başlıqları qəbul edilir.

Shannon modeli seçin

Hər sorğu Shannon-un dərc etdiyi model id-sini göstərməlidir. Kodlaşdırma aləti ona başqa şey demədiyiniz halda öz defolt modelinin adını göndərir, Shannon-un dərc etmədiyi ada isə 400 və unknown model: <name> mesajı ilə cavab verilir. Heç bir başqa ad Shannon modelinə uyğunlaşdırılmır, buna görə modeli ilk sorğudan əvvəl alətdə təyin edin.

GET /v1/models hər id-ni kontekst pəncərəsi ilə siyahıya alır. Açar tələb etmir. Modellər və qiymətlər

Kodlaşdırma alətləri modeli uzun system prompt ilə yönləndirir. System promptu shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro və host edilmiş açıq çəkili modellər tətbiq edir, buna görə kodlaşdırma aləti üçün bunlardan birini seçin.

Claude Code

Claude Code bağlantısını mühit dəyişənlərindən oxuyur. Onları onu işə salan shell-də və ya hər sessiya üçün saxlamaq istəsəniz ~/.claude/settings.json faylının env blokunda təyin edin.

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

• Hər üç ANTHROPIC_DEFAULT_…_MODEL dəyişənini təyin edin. Subagent-lər və bəzi komandalar modeli daxili adı ilə istəyir və hər ad Shannon id-sinə çevrilməlidir.
• Nümunə arxa plan sorğularını token ilə sayılan shannon-1.6-lite modelinə yönəldir. Sessiya başlıqları və oxşar sorğular onda Coder çağırışlarından istifadə etmir.
• Claude Code kontekstin ölçüsü üçün POST /v1/messages/count_tokens endpoint-ini çağırır. Endpoint host edilmiş açıq çəkili modellər üçün sayır. Shannon id-si ilə 400 cavab verir; Claude Code token saymanı ixtiyari sayır və ölçünü özü təxmin edir. Tokenlərin sayılması

Aləti işə salmazdan əvvəl ünvanı, açarı və model id-sini yoxlamaq üçün əllə bir sorğu göndərin:

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 Responses API ilə danışır. Shannon-u ~/.codex/config.toml faylında model provider kimi təsvir edin, orada Shannon model id-sini seçin və API açarınızı provider-in adını çəkdiyi mühit dəyişəninə qoyun.

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 serverdə söhbət saxlamır: hər sorğu söhbəti input daxilində daşıyır. previous_response_id uyğunluq üçün qəbul edilir.
• Funksiya alətləri (type: "function") /v1/responses üzərində modelə təqdim olunur.
• /v1/responses üzərində shannon-coder-1 Coder çağırışları ilə yox, balansınızdan token ilə sayılır.

Responses endpoint-i üçün eyni yoxlama:

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

Kodlaşdırma modeli və onun necə sayıldığı

shannon-coder-1 kodlaşdırma agentləri üçün Shannon modelidir. GET /v1/models onu 131,072 tokenlik kontekst pəncərəsi, alət çağırışları, reasoning və mətn girişi ilə bildirir. Alətin istifadə etdiyi endpoint-dən asılı olaraq iki üsuldan biri ilə sayılır.

Çağırış ölçüsündən asılı olmayaraq bir sorğudur. Sorğu qəbul edildikdə, model cavab verməzdən əvvəl sayılır. Agent sessiyası atdığı hər addım üçün bir sorğu göndərir, buna görə uzun tapşırıq çoxlu çağırış işlədir. Limit planınızdan asılıdır və hər 4 saatdan bir, 00:00, 04:00, 08:00, 12:00, 16:00 və 20:00 UTC-də yenidən başlayır.

Plan səhifəsi cari rəqəmləri göstərir. Planlar

Pəncərənin çağırışları bitdikdə sorğuya 429 ilə cavab verilir. /v1/messages üzərində eyni xəta Anthropic formasında gəlir.

{
  "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 aşması

Söhbət modelin kontekst pəncərəsindən böyük olduqda /v1/chat/completions və /v1/messages 400, invalid_request_error tipi, context_length_exceeded kodu və prompt is too long ilə başlayan mesajla cavab verir. Kodlaşdırma alətləri bu xətanı oxuyub sessiyanı sıxışdırır və sorğunu yenidən göndərir. Onu shannon-coder-1, shannon-1.6-lite və shannon-1.6-pro yaradır.

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

Mesaj prompt is too long: <sent> tokens > <limit> maximum şəklindədir. İki ədəd məlum olmadıqda prompt is too long. Please compact the conversation and try again. olur.

Axında status artıq 200-dür, buna görə xəta hadisə kimi gəlir və axın sonra normal qaydada bağlanır:

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

Agent dövrəsinin etibar edə biləcəyi şeylər

Problemlərin aradan qaldırılması

Açarınız və balansınız Keys & usage səhifəsindədir. Keys & usage