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 и размещенные модели с открытыми весами, поэтому для инструмента кодинга выбирайте одну из них.

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 размер контекста. Эндпоинт считает для размещенных моделей с открытыми весами. С 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"}

На что может рассчитывать цикл агента

Устранение неполадок

Ваш ключ и ваш баланс находятся на странице Keys & usage. Keys & usage