CLI ਕੋਡਿੰਗ ਟੂਲ

ਕੋਡਿੰਗ ਟੂਲ ਨੂੰ Shannon ਨਾਲ ਕੰਮ ਕਰਨ ਲਈ ਤਿੰਨ ਸੈਟਿੰਗਾਂ ਚਾਹੀਦੀਆਂ ਹਨ: API ਦਾ base URL, ਤੁਹਾਡੀ API key, ਅਤੇ ਇੱਕ Shannon ਮਾਡਲ id। ਇਹ ਪੰਨਾ Claude Code ਅਤੇ Codex CLI ਲਈ ਠੀਕ ਸੈਟਿੰਗਾਂ ਦਿੰਦਾ ਹੈ, ਸਮਝਾਉਂਦਾ ਹੈ ਕਿ ਕੋਡਿੰਗ ਮਾਡਲ shannon-coder-1 ਕਿਵੇਂ ਗਿਣਿਆ ਜਾਂਦਾ ਹੈ, ਅਤੇ ਉਹ ਗਲਤੀਆਂ ਸੂਚੀਬੱਧ ਕਰਦਾ ਹੈ ਜੋ ਇਨ੍ਹਾਂ ਟੂਲਾਂ ਨੂੰ ਮਿਲਦੀਆਂ ਹਨ।

ਹਰ ਟੂਲ ਕਿਹੜਾ endpoint ਵਰਤਦਾ ਹੈ

ਤਿੰਨੇ endpoints ਇੱਕੋ API key ਲੈਂਦੇ ਹਨ, Authorization: Bearer ਵਜੋਂ ਜਾਂ x-api-key ਵਜੋਂ। ਇਹ ਟੂਲ ਜੋ ਹੈਡਰ anthropic-version, anthropic-beta ਅਤੇ openai-beta ਭੇਜਦੇ ਹਨ ਉਹ ਸਵੀਕਾਰ ਕੀਤੇ ਜਾਂਦੇ ਹਨ।

Shannon ਮਾਡਲ ਚੁਣੋ

ਹਰ ਰਿਕੁਐਸਟ ਵਿੱਚ ਉਸ ਮਾਡਲ id ਦਾ ਨਾਂ ਹੋਣਾ ਲਾਜ਼ਮੀ ਹੈ ਜੋ Shannon ਪ੍ਰਕਾਸ਼ਿਤ ਕਰਦਾ ਹੈ। ਕੋਡਿੰਗ ਟੂਲ ਆਪਣੇ ਡਿਫਾਲਟ ਮਾਡਲ ਦਾ ਨਾਂ ਭੇਜਦਾ ਹੈ ਜਦੋਂ ਤੱਕ ਤੁਸੀਂ ਉਸ ਨੂੰ ਹੋਰ ਨਾ ਕਹੋ, ਅਤੇ ਜੋ ਨਾਂ Shannon ਪ੍ਰਕਾਸ਼ਿਤ ਨਹੀਂ ਕਰਦਾ ਉਸ ਦਾ ਜਵਾਬ 400 ਅਤੇ ਸੁਨੇਹੇ unknown model: <name> ਨਾਲ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ। ਕੋਈ ਹੋਰ ਨਾਂ Shannon ਮਾਡਲ ਨਾਲ ਨਹੀਂ ਜੋੜਿਆ ਜਾਂਦਾ, ਇਸ ਲਈ ਪਹਿਲੀ ਰਿਕੁਐਸਟ ਤੋਂ ਪਹਿਲਾਂ ਟੂਲ ਵਿੱਚ ਮਾਡਲ ਸੈੱਟ ਕਰੋ।

GET /v1/models ਹਰ id ਨੂੰ ਉਸ ਦੀ ਕਾਂਟੈਕਸਟ ਵਿੰਡੋ ਸਮੇਤ ਸੂਚੀਬੱਧ ਕਰਦਾ ਹੈ। ਇਸ ਨੂੰ 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 ਤੋਂ ਪੜ੍ਹਦਾ ਹੈ। ਉਨ੍ਹਾਂ ਨੂੰ ਉਸ ਸ਼ੈੱਲ ਵਿੱਚ ਸੈੱਟ ਕਰੋ ਜੋ ਇਸ ਨੂੰ ਸ਼ੁਰੂ ਕਰਦਾ ਹੈ, ਜਾਂ ਹਰ ਸੈਸ਼ਨ ਲਈ ਰੱਖਣ ਵਾਸਤੇ ~/.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 ਵੱਲ ਭੇਜਦਾ ਹੈ, ਜਿਸ ਦੀ ਗਿਣਤੀ tokens ਵਿੱਚ ਹੁੰਦੀ ਹੈ। ਫਿਰ ਸੈਸ਼ਨ ਦੇ ਸਿਰਲੇਖ ਅਤੇ ਅਜਿਹੀਆਂ ਰਿਕੁਐਸਟਾਂ Coder ਕਾਲਾਂ ਨਹੀਂ ਵਰਤਦੀਆਂ।
• 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 ਉਸ environment variable ਵਿੱਚ ਪਾਓ ਜਿਸ ਦਾ ਨਾਂ provider ਦਿੰਦਾ ਹੈ।

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 ਟੂਲ (type: "function") /v1/responses ਉੱਤੇ ਮਾਡਲ ਨੂੰ ਪੇਸ਼ ਕੀਤੇ ਜਾਂਦੇ ਹਨ।
• /v1/responses ਉੱਤੇ shannon-coder-1 ਦੀ ਗਿਣਤੀ ਤੁਹਾਡੇ ਬੈਲੇਂਸ ਦੇ tokens ਵਿੱਚ ਹੁੰਦੀ ਹੈ, 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 ਕੋਡਿੰਗ ਏਜੰਟਾਂ ਲਈ Shannon ਮਾਡਲ ਹੈ। GET /v1/models ਇਸ ਨੂੰ 131,072 tokens ਦੀ ਕਾਂਟੈਕਸਟ ਵਿੰਡੋ, ਟੂਲ ਕਾਲਾਂ, ਰੀਜ਼ਨਿੰਗ ਅਤੇ ਟੈਕਸਟ ਇਨਪੁਟ ਨਾਲ ਦੱਸਦਾ ਹੈ। ਟੂਲ ਜੋ endpoint ਵਰਤਦਾ ਹੈ ਉਸ ਦੇ ਹਿਸਾਬ ਨਾਲ ਇਹ ਦੋ ਤਰੀਕਿਆਂ ਵਿੱਚੋਂ ਇੱਕ ਨਾਲ ਗਿਣਿਆ ਜਾਂਦਾ ਹੈ।

ਇੱਕ ਕਾਲ ਇੱਕ ਰਿਕੁਐਸਟ ਹੈ, ਉਸ ਦਾ ਆਕਾਰ ਕੁਝ ਵੀ ਹੋਵੇ। ਇਹ ਉਦੋਂ ਗਿਣੀ ਜਾਂਦੀ ਹੈ ਜਦੋਂ ਰਿਕੁਐਸਟ ਸਵੀਕਾਰ ਹੁੰਦੀ ਹੈ, ਮਾਡਲ ਦੇ ਜਵਾਬ ਦੇਣ ਤੋਂ ਪਹਿਲਾਂ। ਏਜੰਟ ਸੈਸ਼ਨ ਹਰ ਕਦਮ ਲਈ ਇੱਕ ਰਿਕੁਐਸਟ ਭੇਜਦਾ ਹੈ, ਇਸ ਲਈ ਲੰਮਾ ਕੰਮ ਕਈ ਕਾਲਾਂ ਵਰਤਦਾ ਹੈ। ਹਿੱਸਾ ਤੁਹਾਡੇ ਪਲਾਨ ਉੱਤੇ ਨਿਰਭਰ ਕਰਦਾ ਹੈ ਅਤੇ ਹਰ 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. ਹੁੰਦਾ ਹੈ।

stream ਉੱਤੇ ਸਟੇਟਸ ਪਹਿਲਾਂ ਹੀ 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"}

ਏਜੰਟ ਲੂਪ ਕਿਸ ਉੱਤੇ ਭਰੋਸਾ ਕਰ ਸਕਦਾ ਹੈ

ਸਮੱਸਿਆ ਦਾ ਹੱਲ

ਤੁਹਾਡੀ key ਅਤੇ ਤੁਹਾਡਾ ਬੈਲੇਂਸ Keys & usage ਪੰਨੇ ਉੱਤੇ ਹਨ। Keys ਅਤੇ ਵਰਤੋਂ