CLI-інструменти для кодування

Інструменту для кодування потрібні три налаштування для роботи з Shannon: базовий URL API, ваш API-ключ та id моделі Shannon. Ця сторінка дає точні налаштування для Claude Code і Codex CLI, пояснює, як рахується модель для кодування shannon-coder-1, і перелічує помилки, з якими ці інструменти стикаються.

Який ендпоінт використовує кожен інструмент

Усі три ендпоінти приймають той самий API-ключ, як Authorization: Bearer або як x-api-key. Заголовки anthropic-version, anthropic-beta і openai-beta, які надсилають ці інструменти, приймаються.

Вибір моделі Shannon

Кожен запит має називати id моделі, який публікує Shannon. Інструмент для кодування надсилає назву власної моделі за замовчуванням, якщо ви не скажете інакше, а на назву, якої Shannon не публікує, відповідають 400 і повідомленням unknown model: <name>. Жодна інша назва не зіставляється з моделлю Shannon, тож задайте модель в інструменті до першого запиту.

GET /v1/models перелічує кожен id з його вікном контексту. Ключ не потрібен. Моделі та ціни

Інструменти для кодування керують моделлю довгим системним промптом. Системний промпт застосовують 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. Субагенти та деякі команди просять модель за її вбудованою назвою, і кожна назва має зіставлятися з id Shannon.
• У прикладі фонові запити спрямовано на shannon-1.6-lite, що рахується в токенах. Заголовки сесій та подібні запити тоді не витрачають виклики Coder.
• Claude Code запитує в POST /v1/messages/count_tokens розмір контексту. Ендпоінт рахує для хостованих open-weight моделей. З id Shannon він відповідає 400; Claude Code вважає підрахунок токенів необов'язковим і оцінює розмір сам. Підрахунок токенів

Щоб перевірити адресу, ключ і id моделі перед запуском інструмента, надішліть один запит вручну:

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, виберіть там id моделі Shannon і помістіть свій API-ключ у змінну середовища, яку називає провайдер.

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.

Така сама перевірка для ендпоінта 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 токенів, викликами інструментів, міркуваннями та текстовим входом. Вона рахується одним із двох способів, залежно від ендпоінта, який використовує інструмент.

Виклик — це один запит, незалежно від розміру. Він рахується, коли запит прийнято, до відповіді моделі. Сесія агента надсилає один запит на кожен свій крок, тож довге завдання використовує багато викликів. Ліміт залежить від вашого плану й оновлюється кожні 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.

У стрімі статус уже 200, тож помилка надходить як подія, після чого стрім закривається звичайним способом:

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

На що може покладатися цикл агента

Усунення несправностей

Ваш ключ і ваш баланс є на сторінці «Ключі та використання». Ключі та використання