ابزارهای CLI برای کدنویسی

یک ابزار کدنویسی برای کار با Shannon به سه تنظیم نیاز دارد: base URL مربوط به API، کلید API شما و یک شناسه مدل Shannon. این صفحه تنظیمات دقیق Claude Code و Codex CLI را می‌دهد، توضیح می‌دهد مدل کدنویسی shannon-coder-1 چگونه شمرده می‌شود و خطاهایی را که این ابزارها با آن‌ها روبه‌رو می‌شوند فهرست می‌کند.

هر ابزار از کدام endpoint استفاده می‌کند

هر سه endpoint همان کلید API را می‌پذیرند، به‌صورت Authorization: Bearer یا x-api-key. هدرهای anthropic-version، anthropic-beta و openai-beta که این ابزارها می‌فرستند پذیرفته می‌شوند.

انتخاب یک مدل Shannon

هر درخواست باید شناسه مدلی را که Shannon منتشر کرده نام ببرد. ابزار کدنویسی اگر به آن نگویید، نام مدل پیش‌فرض خودش را می‌فرستد و نامی که Shannon منتشر نکرده با 400 و پیام unknown model: <name> پاسخ داده می‌شود. هیچ نام دیگری به مدل Shannon نگاشت نمی‌شود، پس مدل را پیش از اولین درخواست در ابزار تنظیم کنید.

GET /v1/models هر شناسه را با پنجره زمینه‌اش فهرست می‌کند. کلید نمی‌خواهد. مدل‌ها و قیمت‌ها

ابزارهای کدنویسی مدل را با یک system prompt طولانی هدایت می‌کنند. system prompt را shannon-coder-1، shannon-1.6-lite، shannon-1.6-pro، shannon-2-lite، shannon-2-pro و مدل‌های open-weight میزبانی‌شده اعمال می‌کنند، پس برای ابزار کدنویسی یکی از این‌ها را انتخاب کنید.

Claude Code

Claude Code اتصال خود را از متغیرهای محیطی می‌خواند. آن‌ها را در شلی که آن را اجرا می‌کند تنظیم کنید، یا در بلوک env فایل ~/.claude/settings.json تا برای هر نشست بمانند.

# 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 را تنظیم کنید. subagentها و برخی دستورها مدل را با نام داخلی‌اش می‌خواهند و هر نام باید به یک شناسه Shannon تبدیل شود.
• نمونه، درخواست‌های پس‌زمینه را به shannon-1.6-lite می‌فرستد که بر حسب توکن شمرده می‌شود. عنوان نشست‌ها و درخواست‌های مشابه آن‌گاه از فراخوانی‌های Coder مصرف نمی‌کنند.
• Claude Code اندازه زمینه را از POST /v1/messages/count_tokens می‌پرسد. این endpoint برای مدل‌های open-weight میزبانی‌شده می‌شمارد. با شناسه Shannon 400 پاسخ می‌دهد؛ Claude Code شمارش توکن را اختیاری می‌داند و اندازه را خودش تخمین می‌زند. شمارش توکن

برای بررسی آدرس، کلید و شناسه مدل پیش از شروع ابزار، یک درخواست را دستی بفرستید:

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 صحبت می‌کند. Shannon را در ~/.codex/config.toml به‌عنوان یک provider مدل تعریف کنید، در آنجا یک شناسه مدل Shannon انتخاب کنید و کلید API خود را در متغیر محیطی‌ای که provider نام می‌برد بگذارید.

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 هیچ گفتگویی را روی سرور نگه نمی‌دارد: هر درخواست گفتگو را در input همراه دارد. previous_response_id برای سازگاری پذیرفته می‌شود.
• ابزارهای تابعی (type: "function") روی /v1/responses به مدل عرضه می‌شوند.
• روی /v1/responses، shannon-coder-1 بر حسب توکن از موجودی شما شمرده می‌شود، نه بر حسب فراخوانی‌های Coder.

همین بررسی برای endpoint مربوط به Responses:

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

مدل کدنویسی و نحوه شمارش آن

shannon-coder-1 مدل Shannon برای عامل‌های کدنویسی است. GET /v1/models آن را با پنجره زمینه 131,072 توکن، فراخوانی ابزار، استدلال و ورودی متن گزارش می‌کند. بسته به endpointی که ابزار استفاده می‌کند، به یکی از دو روش شمرده می‌شود.

فراخوانی یعنی یک درخواست، با هر اندازه‌ای. هنگام پذیرفته شدن درخواست، پیش از پاسخ مدل، شمرده می‌شود. یک نشست عامل برای هر گامی که برمی‌دارد یک درخواست می‌فرستد، پس یک کار طولانی فراخوانی‌های زیادی مصرف می‌کند. سهمیه به پلن شما بستگی دارد و هر 4 ساعت دوباره شروع می‌شود، در ساعت‌های 00:00، 04:00، 08:00، 12:00، 16:00 و 20:00 UTC.

صفحه پلن‌ها اعداد فعلی را نشان می‌دهد. پلن‌ها

وقتی فراخوانی‌های یک بازه تمام شود، درخواست با 429 پاسخ داده می‌شود. روی /v1/messages همین خطا با شکل Anthropic می‌آید.

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

سرریز زمینه

وقتی گفتگو از پنجره زمینه مدل بزرگ‌تر باشد، /v1/chat/completions و /v1/messages با 400، نوع invalid_request_error، کد context_length_exceeded و پیامی که با prompt is too long شروع می‌شود پاسخ می‌دهند. ابزارهای کدنویسی این خطا را می‌خوانند تا نشست را فشرده کنند و درخواست را دوباره بفرستند. این خطا را shannon-coder-1، shannon-1.6-lite و 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
  }
}

پیام prompt is too long: <sent> tokens > <limit> maximum است. وقتی این دو عدد معلوم نباشند، prompt is too long. Please compact the conversation and try again. است.

روی stream وضعیت از قبل 200 است، پس خطا به‌صورت رویداد می‌رسد و stream سپس به روش عادی بسته می‌شود:

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

آنچه یک حلقه عامل می‌تواند به آن تکیه کند

عیب‌یابی

کلید و موجودی شما در صفحه «کلیدها و مصرف» است. کلیدها و مصرف