CLI કોડિંગ ટૂલ્સ

કોડિંગ ટૂલને Shannon સાથે કામ કરવા ત્રણ સેટિંગ્સ જોઈએ: API નું base URL, તમારી API કી અને Shannon મોડેલ id. આ પેજ Claude Code અને Codex CLI માટેના ચોક્કસ સેટિંગ્સ આપે છે, કોડિંગ મોડેલ shannon-coder-1 કેવી રીતે ગણાય છે તે સમજાવે છે, અને આ ટૂલ્સને મળતી એરર્સની યાદી આપે છે.

દરેક ટૂલ કયો એન્ડપોઇન્ટ વાપરે છે

ત્રણે એન્ડપોઇન્ટ્સ સમાન API કી સ્વીકારે છે, Authorization: Bearer તરીકે અથવા x-api-key તરીકે. આ ટૂલ્સ જે anthropic-version, anthropic-beta અને openai-beta હેડર મોકલે છે તે સ્વીકારાય છે.

Shannon મોડેલ પસંદ કરો

દરેક રિક્વેસ્ટમાં Shannon જે પ્રકાશિત કરે છે તે મોડેલ id આપવો જ પડે. તમે અલગ ન કહો ત્યાં સુધી કોડિંગ ટૂલ તેના પોતાના ડિફોલ્ટ મોડેલનું નામ મોકલે છે, અને Shannon જે નામ પ્રકાશિત કરતું નથી તેનો જવાબ 400 અને મેસેજ unknown model: <name> થી અપાય છે. બીજું કોઈ નામ Shannon મોડેલ સાથે જોડાતું નથી, તેથી પહેલી રિક્વેસ્ટ પહેલાં ટૂલમાં મોડેલ સેટ કરો.

GET /v1/models દરેક id ને તેની કોન્ટેક્સ્ટ વિન્ડો સાથે યાદી કરે છે. તેને કી જોઈતી નથી. મોડેલ્સ અને કિંમત

કોડિંગ ટૂલ્સ લાંબા 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 માંથી વાંચે છે. તેને શરૂ કરનાર શેલમાં સેટ કરો, અથવા દરેક સેશન માટે રાખવા ~/.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 વેરિયેબલ સેટ કરો. Subagents અને કેટલાક કમાન્ડ્સ મોડેલ તેના બિલ્ટ-ઇન નામથી માંગે છે, અને દરેક નામ Shannon id માં ઉકેલાવું જોઈએ.
• નમૂનો બેકગ્રાઉન્ડ રિક્વેસ્ટ્સને shannon-1.6-lite તરફ દોરે છે, જે ટોકન્સમાં ગણાય છે. સેશન ટાઇટલ અને તેના જેવી રિક્વેસ્ટ્સ ત્યારે Coder કોલ્સ વાપરતી નથી.
• Claude Code કોન્ટેક્સ્ટના કદ માટે POST /v1/messages/count_tokens ને પૂછે છે. એન્ડપોઇન્ટ હોસ્ટેડ open-weight મોડેલ્સ માટે ગણે છે. Shannon id સાથે તે 400 થી જવાબ આપે છે; Claude Code ટોકન ગણતરીને વૈકલ્પિક ગણે છે અને કદનો અંદાજ પોતે લગાવે છે. ટોકન ગણતરી

ટૂલ શરૂ કરતાં પહેલાં સરનામું, કી અને મોડેલ 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 મોડેલ id પસંદ કરો, અને તમારી API કી 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 એન્ડપોઇન્ટ માટે એ જ તપાસ:

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 ટોકન્સની કોન્ટેક્સ્ટ વિન્ડો, ટૂલ કોલ, reasoning અને ટેક્સ્ટ ઇનપુટ સાથે જણાવે છે. ટૂલ કયા એન્ડપોઇન્ટનો ઉપયોગ કરે છે તેના આધારે તે બેમાંથી એક રીતે ગણાય છે.

કોલ એટલે એક રિક્વેસ્ટ, તેનું કદ ગમે તે હોય. રિક્વેસ્ટ સ્વીકારાય ત્યારે, મોડેલ જવાબ આપે તે પહેલાં, તે ગણાય છે. એજન્ટ સેશન તે લેતા દરેક પગલા માટે એક રિક્વેસ્ટ મોકલે છે, તેથી લાંબું કામ ઘણા કોલ્સ વાપરે છે. એલાઉન્સ તમારા પ્લાન પર આધારિત છે અને દર 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 થી શરૂ થતા મેસેજથી જવાબ આપે છે. કોડિંગ ટૂલ્સ સેશન compact કરવા અને રિક્વેસ્ટ ફરી મોકલવા આ એરર વાંચે છે. તે 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 પેજ પર છે. Keys & usage