ເຄື່ອງມື CLI ສຳລັບຂຽນໂຄ້ດ

tool ສຳລັບຂຽນໂຄ້ດຕ້ອງການສາມການຕັ້ງຄ່າເພື່ອໃຊ້ກັບ Shannon: base URL ຂອງ API, API key ຂອງທ່ານ, ແລະ id ຂອງ model Shannon. ໜ້ານີ້ໃຫ້ການຕັ້ງຄ່າທີ່ຖືກຕ້ອງສຳລັບ Claude Code ແລະ Codex CLI, ອະທິບາຍວິທີນັບ model ສຳລັບຂຽນໂຄ້ດ shannon-coder-1, ແລະ ລາຍຊື່ຂໍ້ຜິດພາດທີ່ tool ເຫຼົ່ານີ້ພົບ.

endpoint ທີ່ແຕ່ລະ tool ໃຊ້

ທັງສາມ endpoint ໃຊ້ API key ດຽວກັນ, ເປັນ Authorization: Bearer ຫຼື x-api-key. header anthropic-version, anthropic-beta ແລະ openai-beta ທີ່ tool ເຫຼົ່ານີ້ສົ່ງມາຖືກຮັບໄວ້.

ເລືອກ model Shannon

ທຸກຄຳຮ້ອງຂໍຕ້ອງລະບຸ id ຂອງ model ທີ່ Shannon ເຜີຍແຜ່. tool ສຳລັບຂຽນໂຄ້ດຈະສົ່ງຊື່ model ເລີ່ມຕົ້ນຂອງມັນເອງ ນອກຈາກທ່ານຈະບອກເປັນຢ່າງອື່ນ, ແລະ ຊື່ທີ່ Shannon ບໍ່ເຜີຍແຜ່ຈະຖືກຕອບດ້ວຍ 400 ແລະ ຂໍ້ຄວາມ unknown model: <name>. ບໍ່ມີຊື່ອື່ນຖືກແປງເປັນ model ຂອງ Shannon, ດັ່ງນັ້ນໃຫ້ຕັ້ງ model ໃນ tool ກ່ອນຄຳຮ້ອງຂໍທຳອິດ.

GET /v1/models ລາຍຊື່ທຸກ id ພ້ອມ context window ຂອງມັນ. ບໍ່ຕ້ອງໃຊ້ key. Model ແລະ ລາຄາ

tool ສຳລັບຂຽນໂຄ້ດນຳທາງ model ດ້ວຍ system prompt ຍາວ. system prompt ຖືກນຳໃຊ້ໂດຍ shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro ແລະ hosted open-weight models, ດັ່ງນັ້ນໃຫ້ເລືອກໜຶ່ງໃນນີ້ສຳລັບ tool ສຳລັບຂຽນໂຄ້ດ.

Claude Code

Claude Code ອ່ານການເຊື່ອມຕໍ່ຈາກຕົວແປ environment. ຕັ້ງຄ່າໃນ shell ທີ່ເລີ່ມມັນ, ຫຼື ໃນ block env ຂອງ ~/.claude/settings.json ເພື່ອເກັບໄວ້ສຳລັບທຸກ session.

# 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 ແລະ ບາງຄຳສັ່ງຂໍ model ດ້ວຍຊື່ໃນຕົວຂອງມັນ, ແລະ ແຕ່ລະຊື່ຕ້ອງຖືກແປງເປັນ id ຂອງ Shannon.
• ຕົວຢ່າງຊີ້ຄຳຮ້ອງຂໍພື້ນຫຼັງໄປທີ່ shannon-1.6-lite, ເຊິ່ງນັບເປັນ tokens. ດັ່ງນັ້ນຊື່ session ແລະ ຄຳຮ້ອງຂໍທຳນອງດຽວກັນຈະບໍ່ໃຊ້ການເອີ້ນ Coder.
• Claude Code ຖາມ POST /v1/messages/count_tokens ເພື່ອຮູ້ຂະໜາດຂອງ context. endpoint ນັບໃຫ້ hosted open-weight models. ກັບ id ຂອງ Shannon ມັນຕອບ 400; Claude Code ຖືວ່າການນັບ tokens ເປັນທາງເລືອກ ແລະ ຄາດຄະເນຂະໜາດເອງ. ການນັບ token

ເພື່ອກວດສອບທີ່ຢູ່, key ແລະ id ຂອງ model ກ່ອນເລີ່ມ tool, ໃຫ້ສົ່ງຄຳຮ້ອງຂໍໜຶ່ງອັນດ້ວຍມື:

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 ເປັນ model provider ໃນ ~/.codex/config.toml, ເລືອກ id ຂອງ model Shannon ຢູ່ບ່ອນນັ້ນ, ແລະ ໃສ່ API key ຂອງທ່ານໃນຕົວແປ environment ທີ່ 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 ບໍ່ເກັບການສົນທະນາໄວ້ໃນ server: ແຕ່ລະຄຳຮ້ອງຂໍນຳການສົນທະນາມາໃນ input. previous_response_id ຖືກຮັບໄວ້ເພື່ອຄວາມເຂົ້າກັນໄດ້.
• Function tools (type: "function") ຖືກສະເໜີໃຫ້ model ໃນ /v1/responses.
• ໃນ /v1/responses, shannon-coder-1 ຖືກນັບເປັນ tokens ຈາກ ຍອດເງິນ ຂອງທ່ານ, ບໍ່ແມ່ນເປັນການເອີ້ນ 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."
  }'

model ສຳລັບຂຽນໂຄ້ດ ແລະ ວິທີນັບ

shannon-coder-1 ແມ່ນ model ຂອງ Shannon ສຳລັບ coding agent. GET /v1/models ລາຍງານມັນດ້ວຍ context window 131,072 tokens, ການເອີ້ນ tool, reasoning ແລະ input ແບບຂໍ້ຄວາມ. ມັນຖືກນັບໃນສອງວິທີ, ຂຶ້ນກັບ endpoint ທີ່ tool ໃຊ້.

ການເອີ້ນແມ່ນໜຶ່ງຄຳຮ້ອງຂໍ, ບໍ່ວ່າຂະໜາດໃດ. ມັນຖືກນັບເມື່ອຄຳຮ້ອງຂໍຖືກຮັບ, ກ່ອນທີ່ model ຈະຕອບ. session ຂອງ agent ສົ່ງໜຶ່ງຄຳຮ້ອງຂໍຕໍ່ທຸກຂັ້ນຕອນທີ່ມັນເຮັດ, ດັ່ງນັ້ນວຽກຍາວຈະໃຊ້ການເອີ້ນຫຼາຍ. ໂຄວຕາຂຶ້ນກັບແຜນຂອງທ່ານ ແລະ ເລີ່ມໃໝ່ທຸກ 4 ຊົ່ວໂມງ, ເວລາ 00:00, 04:00, 08:00, 12:00, 16:00 ແລະ 20:00 UTC.

ໜ້າແຜນສະແດງຕົວເລກປັດຈຸບັນ. ແຜນ

ເມື່ອການເອີ້ນຂອງໜຶ່ງ window ຖືກໃຊ້ໝົດ, ຄຳຮ້ອງຂໍຈະຖືກຕອບດ້ວຍ 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"
  }
}

Context ເກີນຂີດຈຳກັດ

ເມື່ອການສົນທະນາໃຫຍ່ກວ່າ context window ຂອງ model, /v1/chat/completions ແລະ /v1/messages ຕອບດ້ວຍ 400, ປະເພດ invalid_request_error, code context_length_exceeded ແລະ ຂໍ້ຄວາມທີ່ເລີ່ມດ້ວຍ prompt is too long. tool ສຳລັບຂຽນໂຄ້ດອ່ານຂໍ້ຜິດພາດນີ້ເພື່ອບີບອັດ session ແລ້ວສົ່ງຄຳຮ້ອງຂໍອີກຄັ້ງ. ມັນຖືກສ້າງໂດຍ 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, status ເປັນ 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"}

ສິ່ງທີ່ loop ຂອງ agent ເພິ່ງພາໄດ້

ການແກ້ໄຂບັນຫາ

key ແລະ ຍອດເງິນ ຂອງທ່ານຢູ່ໃນໜ້າ Keys & usage. Keys & usage