CLI кодчилолын хэрэгслүүд

Coding хэрэгсэл Shannon-той ажиллахад гурван тохиргоо хэрэгтэй: API-ийн үндсэн URL, таны API түлхүүр, Shannon загварын id. Энэ хуудас Claude Code болон Codex CLI-ийн яг тохиргоог өгч, shannon-coder-1 coding загвар хэрхэн тоологддогийг тайлбарлаж, эдгээр хэрэгсэлд тохиолддог алдааг жагсаана.

Хэрэгсэл бүр аль endpoint ашигладаг вэ

Гурван endpoint бүгд ижил API түлхүүр авна: Authorization: Bearer эсвэл x-api-key хэлбэрээр. Эдгээр хэрэгслийн илгээдэг anthropic-version, anthropic-beta, openai-beta header-үүдийг хүлээн авна.

Shannon загвар сонгох

Хүсэлт бүр Shannon-ий нийтэлсэн загварын id-г заах ёстой. Coding хэрэгсэл таныг өөрөөр заагаагүй бол өөрийн үндсэн загварын нэрийг илгээдэг бөгөөд Shannon-ий нийтлээгүй нэрэнд 400 ба unknown model: <name> мессежээр хариулна. Өөр ямар ч нэрийг Shannon загвартай холбохгүй тул эхний хүсэлтээс өмнө хэрэгсэлдээ загвараа тохируулаарай.

GET /v1/models бүх id-г контекст цонхтой нь жагсаана. Түлхүүр шаардахгүй. Загвар ба үнэ

Coding хэрэгслүүд урт system prompt-оор загварыг удирддаг. System prompt-ийг shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro болон hosted open-weight загварууд хэрэгжүүлдэг тул coding хэрэгсэлд эдгээрийн аль нэгийг сонгоно уу.

Claude Code

Claude Code холболтоо орчны хувьсагчаас уншдаг. Тэдгээрийг эхлүүлж буй shell-д, эсвэл сесс бүрт хадгалахын тулд ~/.claude/settings.json-ийн env блокт тохируулна.

# 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 хувьсагчийг бүгдийг нь тохируулна. Дэд агентууд болон зарим команд загварыг суурь нэрээр нь хүсдэг тул нэр бүр Shannon id болж задрах ёстой.
• Жишээ нь арын хүсэлтийг токеноор тоологддог shannon-1.6-lite рүү чиглүүлсэн. Тэгвэл сессийн гарчиг зэрэг хүсэлт Coder дуудлага ашиглахгүй.
• Claude Code контекстийн хэмжээг POST /v1/messages/count_tokens-оос асуудаг. Энэ endpoint hosted open-weight загваруудад тоолно. Shannon id-д 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-тай харилцдаг. ~/.codex/config.toml-д Shannon-г загварын provider гэж тодорхойлж, тэнд Shannon загварын id сонгож, 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-г нийцтэй байлгахын тулд хүлээн авна.
• Function tool-уудыг (type: "function") /v1/responses дээр загварт санал болгоно.
• /v1/responses дээр shannon-coder-1-ийг Coder дуудлагаар бус таны үлдэгдлээс токеноор тоолно.

Responses endpoint-ийн ижил шалгалт:

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

Coding загвар ба түүний тооцоо

shannon-coder-1 бол кодчилолын агентуудад зориулсан Shannon загвар. GET /v1/models үүнийг 131,072 токены контекст цонх, tool дуудлага, reasoning ба текст оролттой гэж мэдээлнэ. Хэрэгслийн ашигладаг 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-оор эхэлсэн мессежээр хариулна. Coding хэрэгслүүд энэ алдааг уншиж сессээ шахаад хүсэлтээ дахин илгээдэг. Үүнийг 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 тул алдаа event хэлбэрээр ирээд, дараа нь 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"}

Agent loop юунд найдаж болох вэ

Асуудал засах

Таны түлхүүр ба үлдэгдэл Keys & usage хуудсанд байна. Түлхүүр ба хэрэглээ