CLI coding tools

coding tool တစ်ခုသည် Shannon နှင့် အလုပ်လုပ်ရန် setting သုံးခု လိုအပ်သည်- API ၏ base URL၊ သင့် API key နှင့် Shannon model id။ ဤစာမျက်နှာတွင် Claude Code နှင့် Codex CLI အတွက် တိကျသော settings များကို ဖော်ပြထားပြီး coding model shannon-coder-1 ကို မည်သို့ ရေတွက်သည်ကို ရှင်းပြကာ ဤ tool များ ကြုံတွေ့ရသော အမှားများကို စာရင်းပြုစုထားသည်။

tool တစ်ခုစီ အသုံးပြုသော endpoint

endpoint သုံးခုလုံးသည် Authorization: Bearer အဖြစ်ဖြစ်စေ x-api-key အဖြစ်ဖြစ်စေ တူညီသော API key ကို လက်ခံသည်။ ဤ tool များ ပို့သော anthropic-version၊ anthropic-beta နှင့် openai-beta headers များကိုလည်း လက်ခံသည်။

Shannon model တစ်ခု ရွေးချယ်ခြင်း

request တိုင်းတွင် Shannon ထုတ်ပြန်ထားသော model id တစ်ခုကို အမည်ပေးရမည်။ သင်မပြောင်းပါက coding tool သည် ၎င်း၏ ကိုယ်ပိုင် default model အမည်ကို ပို့ပြီး Shannon မထုတ်ပြန်ထားသော အမည်ကို 400 နှင့် unknown model: <name> မက်ဆေ့ချ်ဖြင့် ဖြေကြားသည်။ အခြားအမည်များကို Shannon model သို့ မချိတ်ထားသဖြင့် ပထမဆုံး request မတိုင်မီ tool တွင် model ကို သတ်မှတ်ပါ။

GET /v1/models သည် id တိုင်းကို ၎င်း၏ context window နှင့်အတူ စာရင်းပြသည်။ key မလိုအပ်ပါ။ Model များနှင့် ဈေးနှုန်း

Coding tool များသည် ရှည်လျားသော system prompt ဖြင့် model ကို ထိန်းကျောင်းသည်။ system prompt ကို shannon-coder-1၊ shannon-1.6-lite၊ shannon-1.6-pro၊ shannon-2-lite၊ shannon-2-pro နှင့် host လုပ်ထားသော open-weight models များက အသုံးပြုသဖြင့် coding tool အတွက် ၎င်းတို့အနက် တစ်ခုကို ရွေးပါ။

Claude Code

Claude Code သည် ၎င်း၏ ချိတ်ဆက်မှုကို environment variable များမှ ဖတ်သည်။ ၎င်းကို စတင်သည့် shell တွင် သတ်မှတ်ပါ၊ သို့မဟုတ် session တိုင်းအတွက် ထားရှိလိုပါက ~/.claude/settings.json ၏ env block တွင် သတ်မှတ်ပါ။

# 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 variable သုံးခုလုံးကို သတ်မှတ်ပါ။ Subagent များနှင့် အချို့ command များသည် model ကို built-in အမည်ဖြင့် တောင်းဆိုသဖြင့် အမည်တစ်ခုစီသည် Shannon id တစ်ခုသို့ ညွှန်းရမည်။
• နမူနာတွင် နောက်ခံ request များကို tokens ဖြင့် ရေတွက်သော shannon-1.6-lite သို့ ညွှန်းထားသည်။ ထိုအခါ session ခေါင်းစဉ်များနှင့် အလားတူ request များသည် Coder calls ကို မသုံးပါ။
• Claude Code သည် context အရွယ်အစားအတွက် POST /v1/messages/count_tokens ကို မေးသည်။ ဤ endpoint သည် host လုပ်ထားသော open-weight models များအတွက် ရေတွက်ပေးသည်။ Shannon id ဖြင့်ဆိုလျှင် 400 ဖြင့် ဖြေသည်၊ Claude Code သည် token ရေတွက်ခြင်းကို ရွေးချယ်စရာအဖြစ် သတ်မှတ်ပြီး အရွယ်အစားကို ကိုယ်တိုင် ခန့်မှန်းသည်။ Token ရေတွက်ခြင်း

tool မစတင်မီ လိပ်စာ၊ key နှင့် model id ကို စစ်ဆေးရန် request တစ်ခုကို လက်ဖြင့် ပို့ပါ-

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 ကို model provider အဖြစ် ဖော်ပြပါ၊ ထိုနေရာတွင် Shannon model id တစ်ခုကို ရွေးပါ၊ ပြီးလျှင် provider က အမည်ပေးထားသော environment variable တွင် သင့် API key ကို ထည့်ပါ။

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 ပေါ်တွင် စကားပြောဆိုမှုကို မသိမ်းပါ- request တစ်ခုစီသည် စကားပြောဆိုမှုကို input ထဲတွင် သယ်ဆောင်သည်။ previous_response_id ကို ကိုက်ညီမှုအတွက် လက်ခံသည်။
• Function tools (type: "function") များကို /v1/responses တွင် model သို့ ပေးအပ်သည်။
• /v1/responses တွင် shannon-coder-1 ကို Coder calls ဖြင့်မဟုတ်ဘဲ သင့် လက်ကျန်ငွေ မှ tokens ဖြင့် ရေတွက်သည်။

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 model နှင့် ၎င်းကို ရေတွက်ပုံ

shannon-coder-1 သည် coding agent များအတွက် Shannon model ဖြစ်သည်။ GET /v1/models က ၎င်းကို 131,072 tokens ပါသော context window၊ tool calls၊ reasoning နှင့် စာသား input ပါသည်ဟု ဖော်ပြသည်။ tool တစ်ခု အသုံးပြုသော endpoint ပေါ်မူတည်၍ နည်းလမ်းနှစ်မျိုးအနက် တစ်မျိုးဖြင့် ရေတွက်သည်။

call တစ်ခုဆိုသည်မှာ အရွယ်အစား မည်သို့ပင်ဖြစ်စေ request တစ်ခုဖြစ်သည်။ request ကို လက်ခံသည့်အခါ model မဖြေမီ ရေတွက်သည်။ agent session သည် လုပ်ဆောင်သော အဆင့်တိုင်းအတွက် request တစ်ခု ပို့သဖြင့် ကြာရှည်သောလုပ်ငန်းသည် call များစွာ သုံးသည်။ ခွင့်ပြုချက်သည် သင့် plan ပေါ်မူတည်ပြီး 4 နာရီတိုင်း၊ 00:00၊ 04:00၊ 08:00၊ 12:00၊ 16:00 နှင့် 20:00 UTC တွင် ပြန်စသည်။

လက်ရှိနံပါတ်များကို plan စာမျက်နှာတွင် ပြထားသည်။ Plans

window တစ်ခု၏ calls ကုန်သွားလျှင် request ကို 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 ကျော်လွန်ခြင်း

စကားပြောဆိုမှုသည် model ၏ context window ထက် ပိုကြီးလျှင် /v1/chat/completions နှင့် /v1/messages တို့သည် 400၊ type invalid_request_error၊ code context_length_exceeded နှင့် prompt is too long ဖြင့် စတင်သော မက်ဆေ့ချ်တို့ဖြင့် ဖြေကြားသည်။ Coding tool များသည် session ကို compact လုပ်ပြီး request ကို ပြန်ပို့ရန် ဤအမှားကို ဖတ်သည်။ ၎င်းကို 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"}

agent loop တစ်ခု အားထားနိုင်သည့်အရာများ

ပြဿနာဖြေရှင်းခြင်း

သင့် key နှင့် လက်ကျန်ငွေ တို့ကို Keys & usage စာမျက်နှာတွင် ကြည့်နိုင်သည်။ Keys & usage