CLI coding මෙවලම්

Coding මෙවලමකට Shannon සමඟ ක්‍රියා කිරීමට සැකසුම් තුනක් අවශ්‍ය වේ: API එකේ base URL එක, ඔබේ API key එක සහ Shannon model id එකක්. මෙම පිටුවේ Claude Code සහ Codex CLI සඳහා නිවැරදි සැකසුම් දී ඇත, shannon-coder-1 coding model එක ගණන් ගන්නා ආකාරය පැහැදිලි කරයි, සහ මෙම මෙවලම්වලට මුහුණ දීමට සිදුවන දෝෂ ලැයිස්තුගත කරයි.

සෑම මෙවලමක්ම භාවිතා කරන endpoint එක

Endpoints තුනම එකම API key එක ගනී, Authorization: Bearer ලෙස හෝ x-api-key ලෙස. මෙම මෙවලම් යවන anthropic-version, anthropic-beta සහ openai-beta headers පිළිගනී.

Shannon model එකක් තෝරන්න

සෑම ඉල්ලීමකම Shannon ප්‍රකාශයට පත් කරන model id එකක් නම් කළ යුතුය. ඔබ වෙනත් ලෙස නොකියන්නේ නම් coding මෙවලමක් තමන්ගේම පෙරනිමි model එකේ නම යවයි, සහ Shannon ප්‍රකාශයට පත් නොකරන නමකට 400 සහ unknown model: <name> පණිවිඩය ලැබේ. වෙනත් කිසිදු නමක් Shannon model එකකට සිතියම් නොකෙරේ, එබැවින් පළමු ඉල්ලීමට පෙර මෙවලමේ model එක සකසන්න.

GET /v1/models සෑම id එකක්ම එහි context window එක සමඟ ලැයිස්තුගත කරයි. එයට key එකක් අවශ්‍ය නැත. Models සහ මිල ගණන්

Coding මෙවලම් දිගු system prompt එකකින් model එක මෙහෙයවයි. System prompt එක ක්‍රියාත්මක කරන්නේ shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro සහ අපගේ සේවාදායකවල ධාවනය වන open-weight models ය, එබැවින් coding මෙවලමක් සඳහා මේවායින් එකක් තෝරන්න.

Claude Code

Claude Code එහි සම්බන්ධතාව environment variables වලින් කියවයි. ඒවා එය ආරම්භ කරන 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 variables තුනම සකසන්න. Subagents සහ සමහර commands model එකක් ඉල්ලන්නේ එහි built-in නමෙනි, සහ සෑම නමක්ම Shannon id එකකට විසඳිය යුතුය.
• නියැදිය පසුබිම් ඉල්ලීම් tokens වලින් ගණන් ගන්නා shannon-1.6-lite වෙත යොමු කරයි. එවිට session titles සහ එවැනි ඉල්ලීම් Coder calls භාවිතා නොකරයි.
• Claude Code context එකේ ප්‍රමාණය සඳහා POST /v1/messages/count_tokens අසයි. එම endpoint එක ගණන් කරන්නේ අපගේ සේවාදායකවල ධාවනය වන open-weight models සඳහාය. Shannon id එකක් සමඟ එය 400 පිළිතුරු දෙයි; Claude Code token ගණන් කිරීම විකල්ප ලෙස සලකා ප්‍රමාණය තනිවම ඇස්තමේන්තු කරයි. Token ගණන් කිරීම

මෙවලම ආරම්භ කිරීමට පෙර ලිපිනය, key එක සහ 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 සමඟ සන්නිවේදනය කරයි. ~/.codex/config.toml හි Shannon model provider එකක් ලෙස විස්තර කර, එහි Shannon model id එකක් තෝරා, ඔබේ API key එක provider නම් කරන environment variable එකේ තබන්න.

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") /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 agents සඳහා වූ Shannon model එකයි. GET /v1/models එය tokens 131,072ක context window එකක්, tool calls, තර්කනය සහ පෙළ ආදානය සමඟ වාර්තා කරයි. මෙවලමක් භාවිතා කරන endpoint එක අනුව එය ක්‍රම දෙකකින් එකකින් ගණන් ගැනේ.

Call එකක් යනු ප්‍රමාණය කුමක් වුවත් එක ඉල්ලීමකි. ඉල්ලීම පිළිගන්නා විට, model එක පිළිතුරු දීමට පෙර එය ගණන් ගැනේ. Agent session එකක් එය ගන්නා සෑම පියවරකටම එක ඉල්ලීමක් යවන බැවින්, දිගු කාර්යයක් calls බොහොමයක් භාවිතා කරයි. ප්‍රමාණය ඔබේ සැලසුම මත රඳා පවතින අතර පැය 4කට වරක්, 00:00, 04:00, 08:00, 12:00, 16:00 සහ 20:00 UTC ට නැවත ආරම්භ වේ.

සැලසුම් පිටුවේ වත්මන් අංක පෙන්වයි. සැලසුම්

කවුළුවක calls අවසන් වූ විට, ඉල්ලීමට 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, invalid_request_error type එක, context_length_exceeded code එක සහ prompt is too long වලින් ආරම්භ වන පණිවිඩයක් සමඟ පිළිතුරු දෙයි. Coding මෙවලම් 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"}

Agent loop එකකට විශ්වාස කළ හැකි දේ

ගැටලු නිරාකරණය

ඔබේ key එක සහ ශේෂය Keys & usage පිටුවේ ඇත. යතුරු සහ භාවිතය