เครื่องมือเขียนโค้ดแบบ CLI

เครื่องมือเขียนโค้ดต้องมีการตั้งค่าสามอย่างเพื่อทำงานกับ Shannon: base URL ของ API, API key ของคุณ และ model id ของ Shannon หน้านี้ให้การตั้งค่าที่ถูกต้องสำหรับ Claude Code และ Codex CLI อธิบายวิธีนับโมเดลเขียนโค้ด shannon-coder-1 และรวบรวมข้อผิดพลาดที่เครื่องมือเหล่านี้พบ

แต่ละเครื่องมือใช้ endpoint ใด

ทั้งสาม endpoint ใช้ API key เดียวกัน ทั้งแบบ Authorization: Bearer หรือ x-api-key ระบบรับเฮดเดอร์ anthropic-version, anthropic-beta และ openai-beta ที่เครื่องมือเหล่านี้ส่งมา

เลือกโมเดล Shannon

ทุกคำขอต้องระบุ model id ที่ Shannon เผยแพร่ เครื่องมือเขียนโค้ดจะส่งชื่อโมเดลเริ่มต้นของตัวเองเว้นแต่คุณจะบอกเป็นอย่างอื่น และชื่อที่ Shannon ไม่ได้เผยแพร่จะได้รับ 400 พร้อมข้อความ unknown model: <name> ไม่มีชื่ออื่นที่ถูกแมปไปยังโมเดลของ Shannon ดังนั้นให้ตั้งค่าโมเดลในเครื่องมือก่อนส่งคำขอแรก

GET /v1/models แสดงรายการทุก id พร้อม context window ไม่ต้องใช้คีย์ โมเดลและราคา

เครื่องมือเขียนโค้ดควบคุมโมเดลด้วย 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 และบางคำสั่งขอโมเดลด้วยชื่อที่มีมาในตัว และแต่ละชื่อต้องชี้ไปที่ id ของ Shannon
• ตัวอย่างชี้คำขอเบื้องหลังไปที่ shannon-1.6-lite ซึ่งนับเป็น tokens ดังนั้นชื่อเซสชันและคำขอลักษณะเดียวกันจะไม่ใช้การเรียก Coder
• Claude Code เรียก POST /v1/messages/count_tokens เพื่อถามขนาดของ context endpoint นี้นับให้โมเดล open-weight ที่โฮสต์ ส่วน id ของ Shannon จะตอบ 400 โดย Claude Code ถือว่าการนับ tokens เป็นทางเลือกและประมาณขนาดเอง การนับ token

หากต้องการตรวจสอบที่อยู่ คีย์ และ model 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 เป็น model provider ใน ~/.codex/config.toml เลือก model id ของ Shannon ที่นั่น และใส่ API key ของคุณในตัวแปรสภาพแวดล้อมที่ 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 tools (type: "function") ถูกเสนอให้โมเดลบน /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."
  }'

โมเดลสำหรับเขียนโค้ดและวิธีนับ

shannon-coder-1 คือโมเดล Shannon สำหรับ coding agent GET /v1/models รายงานว่ามี context window 131,072 tokens รองรับการเรียก tool การให้เหตุผล และอินพุตข้อความ โมเดลนี้นับได้สองวิธี ขึ้นอยู่กับ endpoint ที่เครื่องมือใช้

การเรียกคือหนึ่งคำขอ ไม่ว่าขนาดเท่าใด จะนับเมื่อรับคำขอ ก่อนที่โมเดลจะตอบ เซสชัน agent ส่งหนึ่งคำขอต่อทุกขั้นที่ทำ งานยาวจึงใช้การเรียกหลายครั้ง โควตาขึ้นกับแผนของคุณ และเริ่มใหม่ทุก 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"
  }
}

Context ล้น

เมื่อบทสนทนาใหญ่กว่า context window ของโมเดล /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"}

สิ่งที่ลูปของ agent พึ่งพาได้

การแก้ปัญหา

คีย์และยอดคงเหลือของคุณอยู่ในหน้าคีย์และการใช้งาน คีย์และการใช้งาน