CLI குறியீட்டு கருவிகள்

கோடிங் கருவி Shannon-உடன் வேலை செய்ய மூன்று அமைப்புகள் தேவை: API-யின் base URL, உங்கள் API key, மற்றும் ஒரு Shannon மாடல் id. இந்தப் பக்கம் Claude Code மற்றும் Codex CLI-க்கான துல்லியமான அமைப்புகளைத் தருகிறது, கோடிங் மாடல் shannon-coder-1 எவ்வாறு கணக்கிடப்படுகிறது என்பதை விளக்குகிறது, மேலும் இந்தக் கருவிகள் சந்திக்கும் பிழைகளைப் பட்டியலிடுகிறது.

ஒவ்வொரு கருவியும் எந்த endpoint-ஐப் பயன்படுத்துகிறது

மூன்று endpoint-களும் ஒரே API key-ஐ Authorization: Bearer ஆகவோ x-api-key ஆகவோ ஏற்கின்றன. இந்தக் கருவிகள் அனுப்பும் anthropic-version, anthropic-beta மற்றும் openai-beta headers ஏற்கப்படுகின்றன.

ஒரு Shannon மாடலைத் தேர்ந்தெடுங்கள்

ஒவ்வொரு கோரிக்கையும் Shannon வெளியிடும் ஒரு மாடல் id-யைக் குறிப்பிட வேண்டும். நீங்கள் வேறுவிதமாகச் சொல்லாவிட்டால் கோடிங் கருவி தன் சொந்த இயல்பு மாடலின் பெயரை அனுப்பும்; Shannon வெளியிடாத பெயருக்கு 400 மற்றும் செய்தி unknown model: <name> வரும். வேறு எந்தப் பெயரும் Shannon மாடலுக்கு இணைக்கப்படுவதில்லை, எனவே முதல் கோரிக்கைக்கு முன் கருவியில் மாடலை அமையுங்கள்.

GET /v1/models ஒவ்வொரு id-யையும் அதன் context window-வுடன் பட்டியலிடும். இதற்கு key தேவையில்லை. மாடல்கள் & விலை

கோடிங் கருவிகள் நீண்ட 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 தன் இணைப்பை environment variables-லிருந்து படிக்கிறது. அதைத் தொடங்கும் shell-ல் அவற்றை அமையுங்கள், அல்லது ஒவ்வொரு அமர்வுக்கும் நிலைக்க ~/.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 மாறிகளையும் அமையுங்கள். Subagents-ம் சில கட்டளைகளும் உள்ளமைந்த பெயரால் மாடலைக் கேட்கின்றன; ஒவ்வொரு பெயரும் ஒரு Shannon id-க்குத் தீர்க்கப்பட வேண்டும்.
• மாதிரி அமைப்பு பின்னணிக் கோரிக்கைகளை டோக்கன்களில் கணக்கிடப்படும் shannon-1.6-lite-க்குச் சுட்டுகிறது. அதனால் அமர்வுத் தலைப்புகள் போன்ற கோரிக்கைகள் Coder அழைப்புகளைப் பயன்படுத்தாது.
• context-ன் அளவுக்காக Claude Code POST /v1/messages/count_tokens-ஐக் கேட்கிறது. இந்த endpoint ஹோஸ்ட் செய்யப்பட்ட open-weight மாடல்களுக்குக் கணக்கிடும். Shannon id-க்கு அது 400 தரும்; டோக்கன் எண்ணிக்கையை Claude Code விருப்பமானதாகக் கருதி, அளவைத் தானே மதிப்பிடும். Token எண்ணிக்கை

கருவியைத் தொடங்கும் முன் முகவரி, key மற்றும் மாடல் 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 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 சர்வரில் உரையாடலை வைத்திருப்பதில்லை: ஒவ்வொரு கோரிக்கையும் உரையாடலை input-ல் கொண்டுவரும். இணக்கத்துக்காக previous_response_id ஏற்கப்படுகிறது.
• Function tools (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."
  }'

கோடிங் மாடலும் அது கணக்கிடப்படும் முறையும்

shannon-coder-1 என்பது கோடிங் agents-க்கான Shannon மாடல். GET /v1/models அதை 131,072 டோக்கன் context window, tool அழைப்புகள், reasoning மற்றும் உரை உள்ளீட்டுடன் தெரிவிக்கிறது. கருவி பயன்படுத்தும் 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.

stream-ல் நிலை ஏற்கனவே 200 ஆகிவிட்டது, எனவே பிழை ஒரு நிகழ்வாக வந்து, பிறகு 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