CLI കോഡിംഗ് ടൂളുകൾ

Shannon-മായി പ്രവർത്തിക്കാൻ ഒരു കോഡിംഗ് ടൂളിന് മൂന്ന് സെറ്റിംഗ്സ് വേണം: API-യുടെ ബേസ് URL, നിങ്ങളുടെ API കീ, ഒരു Shannon മോഡൽ ഐഡി. Claude Code, Codex CLI എന്നിവയ്ക്കുള്ള കൃത്യമായ സെറ്റിംഗ്സ് ഈ പേജ് നൽകുന്നു, കോഡിംഗ് മോഡലായ shannon-coder-1 എങ്ങനെ കണക്കാക്കുന്നു എന്ന് വിശദീകരിക്കുന്നു, ഈ ടൂളുകൾ നേരിടുന്ന പിശകുകളും പട്ടികപ്പെടുത്തുന്നു.

ഓരോ ടൂളും ഉപയോഗിക്കുന്ന എൻഡ്‌പോയിന്റ്

മൂന്ന് എൻഡ്‌പോയിന്റുകളും ഒരേ API കീ സ്വീകരിക്കുന്നു, Authorization: Bearer ആയോ x-api-key ആയോ. ഈ ടൂളുകൾ അയയ്ക്കുന്ന anthropic-version, anthropic-beta, openai-beta ഹെഡറുകൾ സ്വീകരിക്കും.

ഒരു Shannon മോഡൽ തിരഞ്ഞെടുക്കുക

ഓരോ റിക്വസ്റ്റിലും Shannon പ്രസിദ്ധീകരിക്കുന്ന ഒരു മോഡൽ ഐഡി പേരുനൽകണം. നിങ്ങൾ മറ്റൊന്ന് പറഞ്ഞില്ലെങ്കിൽ കോഡിംഗ് ടൂൾ അതിന്റെ സ്വന്തം ഡിഫോൾട്ട് മോഡലിന്റെ പേര് അയയ്ക്കും, Shannon പ്രസിദ്ധീകരിക്കാത്ത പേരിന് 400 എന്ന സ്റ്റാറ്റസും unknown model: <name> എന്ന സന്ദേശവും മറുപടിയായി ലഭിക്കും. മറ്റൊരു പേരും Shannon മോഡലിലേക്ക് മാപ്പ് ചെയ്യുന്നില്ല, അതിനാൽ ആദ്യ റിക്വസ്റ്റിന് മുമ്പ് ടൂളിൽ മോഡൽ സജ്ജമാക്കുക.

GET /v1/models എല്ലാ ഐഡികളെയും അവയുടെ കോൺടെക്സ്റ്റ് വിൻഡോയോടെ പട്ടികപ്പെടുത്തുന്നു. ഇതിന് കീ ആവശ്യമില്ല. മോഡലുകളും വിലയും

കോഡിംഗ് ടൂളുകൾ ദൈർഘ്യമേറിയ സിസ്റ്റം പ്രോംപ്റ്റ് ഉപയോഗിച്ച് മോഡലിനെ നയിക്കുന്നു. shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro, ഹോസ്റ്റ് ചെയ്ത ഓപ്പൺ-വെയിറ്റ് മോഡലുകൾ എന്നിവ സിസ്റ്റം പ്രോംപ്റ്റ് പ്രയോഗിക്കുന്നു, അതിനാൽ ഒരു കോഡിംഗ് ടൂളിന് ഇവയിലൊന്ന് തിരഞ്ഞെടുക്കുക.

Claude Code

Claude Code അതിന്റെ കണക്ഷൻ എൻവയോൺമെന്റ് വേരിയബിളുകളിൽ നിന്ന് വായിക്കുന്നു. അത് തുടങ്ങുന്ന ഷെല്ലിൽ അവ സജ്ജമാക്കുക, അല്ലെങ്കിൽ എല്ലാ സെഷനുകൾക്കും നിലനിർത്താൻ ~/.claude/settings.json-ലെ env ബ്ലോക്കിൽ സജ്ജമാക്കുക.

# 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 വേരിയബിളുകളും സജ്ജമാക്കുക. സബ്ഏജന്റുകളും ചില കമാൻഡുകളും മോഡലിനെ അതിന്റെ ബിൽറ്റ്-ഇൻ പേരിൽ ആവശ്യപ്പെടുന്നു, ഓരോ പേരും ഒരു Shannon ഐഡിയിലേക്ക് റിസോൾവ് ആകണം.
• സാമ്പിൾ ബാക്ക്ഗ്രൗണ്ട് റിക്വസ്റ്റുകളെ ടോക്കണിൽ കണക്കാക്കുന്ന shannon-1.6-lite-ലേക്ക് ചൂണ്ടുന്നു. അപ്പോൾ സെഷൻ ടൈറ്റിലുകളും സമാന റിക്വസ്റ്റുകളും Coder കോളുകൾ ഉപയോഗിക്കില്ല.
• കോൺടെക്സ്റ്റിന്റെ വലിപ്പത്തിനായി Claude Code POST /v1/messages/count_tokens വിളിക്കുന്നു. ഈ എൻഡ്‌പോയിന്റ് ഹോസ്റ്റ് ചെയ്ത ഓപ്പൺ-വെയിറ്റ് മോഡലുകൾക്ക് എണ്ണിത്തരും. Shannon ഐഡി ഉപയോഗിച്ചാൽ ഇത് 400 നൽകും; ടോക്കൺ എണ്ണൽ ഓപ്ഷണൽ ആയി Claude Code കണക്കാക്കുകയും വലിപ്പം സ്വയം കണക്കാക്കുകയും ചെയ്യും. ടോക്കൺ എണ്ണൽ

ടൂൾ തുടങ്ങുന്നതിന് മുമ്പ് വിലാസം, കീ, മോഡൽ ഐഡി എന്നിവ പരിശോധിക്കാൻ, ഒരു റിക്വസ്റ്റ് സ്വയം അയയ്ക്കുക:

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-നെ ഒരു മോഡൽ പ്രൊവൈഡറായി വിവരിക്കുക, അവിടെ ഒരു Shannon മോഡൽ ഐഡി തിരഞ്ഞെടുക്കുക, നിങ്ങളുടെ API കീ പ്രൊവൈഡർ പേരുനൽകുന്ന എൻവയോൺമെന്റ് വേരിയബിളിൽ വയ്ക്കുക.

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 അനുയോജ്യതയ്ക്കായി സ്വീകരിക്കും.
• ഫംഗ്ഷൻ ടൂളുകൾ (type: "function") /v1/responses-ൽ മോഡലിന് നൽകുന്നു.
• /v1/responses-ൽ shannon-coder-1 Coder കോളുകളിൽ അല്ല, നിങ്ങളുടെ ബാലൻസിൽ നിന്നുള്ള ടോക്കണുകളിലാണ് കണക്കാക്കുന്നത്.

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 മോഡലാണ്. GET /v1/models ഇത് 131,072 ടോക്കണുകളുടെ കോൺടെക്സ്റ്റ് വിൻഡോ, ടൂൾ കോളുകൾ, റീസണിംഗ്, ടെക്സ്റ്റ് ഇൻപുട്ട് എന്നിവയോടെ റിപ്പോർട്ട് ചെയ്യുന്നു. ടൂൾ ഉപയോഗിക്കുന്ന എൻഡ്‌പോയിന്റ് അനുസരിച്ച് ഇത് രണ്ട് രീതികളിൽ ഒന്നിൽ കണക്കാക്കുന്നു.

വലിപ്പം എന്തായാലും ഒരു കോൾ എന്നത് ഒരു റിക്വസ്റ്റ് ആണ്. റിക്വസ്റ്റ് സ്വീകരിക്കുമ്പോൾ, മോഡൽ ഉത്തരം നൽകുന്നതിന് മുമ്പ്, അത് കണക്കാക്കും. ഏജന്റ് സെഷൻ എടുക്കുന്ന ഓരോ ഘട്ടത്തിനും ഒരു റിക്വസ്റ്റ് അയയ്ക്കുന്നു, അതിനാൽ ദൈർഘ്യമേറിയ ജോലി നിരവധി കോളുകൾ ഉപയോഗിക്കും. അലവൻസ് നിങ്ങളുടെ പ്ലാനിനെ ആശ്രയിച്ചിരിക്കും, ഓരോ 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"
  }
}

കോൺടെക്സ്റ്റ് ഓവർഫ്ലോ

ഒരു സംഭാഷണം മോഡലിന്റെ കോൺടെക്സ്റ്റ് വിൻഡോയേക്കാൾ വലുതാകുമ്പോൾ, /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"}

ഒരു ഏജന്റ് ലൂപ്പിന് ആശ്രയിക്കാവുന്നത്

പ്രശ്നപരിഹാരം

നിങ്ങളുടെ കീയും ബാലൻസും Keys & usage പേജിലുണ്ട്. കീകളും ഉപയോഗവും