CLI kodlama araçları

Bir kodlama aracının Shannon ile çalışması için üç ayara ihtiyacı vardır: API'nin temel URL'si, API anahtarınız ve bir Shannon model kimliği. Bu sayfa Claude Code ve Codex CLI için tam ayarları verir, shannon-coder-1 kodlama modelinin nasıl sayıldığını açıklar ve bu araçların karşılaştığı hataları listeler.

Her aracın kullandığı uç nokta

Üç uç nokta da aynı API anahtarını Authorization: Bearer veya x-api-key olarak alır. Bu araçların gönderdiği anthropic-version, anthropic-beta ve openai-beta başlıkları kabul edilir.

Bir Shannon modeli seçin

Her istek, Shannon'ın yayımladığı bir model kimliğini belirtmelidir. Bir kodlama aracı, ona aksini söylemediğiniz sürece kendi varsayılan modelinin adını gönderir ve Shannon'ın yayımlamadığı bir ad 400 ve unknown model: <name> mesajıyla yanıtlanır. Başka hiçbir ad bir Shannon modeline eşlenmez; bu yüzden modeli ilk istekten önce araçta ayarlayın.

GET /v1/models her kimliği bağlam penceresiyle listeler. Anahtar gerektirmez. Modeller ve fiyatlandırma

Kodlama araçları modeli uzun bir sistem istemiyle yönlendirir. Sistem istemini shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro ve host edilen açık ağırlıklı modeller uygular; bu yüzden bir kodlama aracı için bunlardan birini seçin.

Claude Code

Claude Code bağlantısını ortam değişkenlerinden okur. Onları aracı başlatan kabukta ayarlayın veya her oturum için kalıcı olması amacıyla ~/.claude/settings.json dosyasının env bloğunda ayarlayın.

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

• Üç ANTHROPIC_DEFAULT_…_MODEL değişkeninin hepsini ayarlayın. Alt ajanlar ve bazı komutlar bir modeli yerleşik adıyla ister ve her adın bir Shannon kimliğine çözümlenmesi gerekir.
• Örnek, arka plan isteklerini token cinsinden sayılan shannon-1.6-lite modeline yönlendirir. Böylece oturum başlıkları ve benzeri istekler Coder çağrılarını kullanmaz.
• Claude Code bağlamın boyutunu POST /v1/messages/count_tokens ile sorar. Uç nokta host edilen açık ağırlıklı modeller için sayar. Bir Shannon kimliğiyle 400 yanıtı verir; Claude Code token saymayı isteğe bağlı sayar ve boyutu kendisi tahmin eder. Token sayma

Aracı başlatmadan önce adresi, anahtarı ve bir model kimliğini denetlemek için elle bir istek gönderin:

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 ile konuşur. Shannon'ı ~/.codex/config.toml içinde bir model sağlayıcısı olarak tanımlayın, orada bir Shannon model kimliği seçin ve API anahtarınızı sağlayıcının adını verdiği ortam değişkenine koyun.

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 sunucuda konuşma tutmaz: her istek konuşmayı input içinde taşır. previous_response_id uyumluluk için kabul edilir.
• Fonksiyon araçları (type: "function") /v1/responses üzerinde modele sunulur.
• /v1/responses üzerinde shannon-coder-1, Coder çağrıları olarak değil bakiyenizden token olarak sayılır.

Responses uç noktası için aynı denetim:

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

Kodlama modeli ve nasıl sayıldığı

shannon-coder-1, kodlama ajanları için Shannon modelidir. GET /v1/models onu 131,072 token bağlam penceresi, araç çağrıları, akıl yürütme ve metin girdisiyle bildirir. Bir aracın kullandığı uç noktaya bağlı olarak iki yoldan biriyle sayılır.

Bir çağrı, boyutu ne olursa olsun tek bir istektir. İstek kabul edildiğinde, model yanıtlamadan önce sayılır. Bir ajan oturumu attığı her adım için bir istek gönderir; bu yüzden uzun bir görev çok sayıda çağrı kullanır. Limit planınıza bağlıdır ve her 4 saatte bir, 00:00, 04:00, 08:00, 12:00, 16:00 ve 20:00 UTC'de yeniden başlar.

Plan sayfası güncel sayıları gösterir. Planlar

Bir pencerenin çağrıları tükendiğinde istek 429 ile yanıtlanır. /v1/messages üzerinde aynı hata Anthropic biçiminde gelir.

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

Bağlam taşması

Bir konuşma modelin bağlam penceresinden büyük olduğunda /v1/chat/completions ve /v1/messages, 400, invalid_request_error türü, context_length_exceeded kodu ve prompt is too long ile başlayan bir mesajla yanıt verir. Kodlama araçları bu hatayı oturumu sıkıştırmak ve isteği tekrar göndermek için okur. Hatayı shannon-coder-1, shannon-1.6-lite ve shannon-1.6-pro üretir.

{
  "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 biçimindedir. İki sayı bilinmediğinde prompt is too long. Please compact the conversation and try again. olur.

Bir akışta durum zaten 200 olduğundan hata bir olay olarak gelir ve akış sonra normal şekilde kapanı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"}

Bir ajan döngüsünün güvenebileceği şeyler

Sorun giderme

Anahtarınız ve bakiyeniz Keys & usage sayfasında. Keys & usage