Mga CLI coding tool

Tatlong setting ang kailangan ng coding tool para gumana sa Shannon: ang base URL ng API, ang iyong API key, at isang Shannon model id. Ibinibigay ng pahinang ito ang eksaktong mga setting para sa Claude Code at Codex CLI, ipinaliliwanag kung paano binibilang ang coding model na shannon-coder-1, at inililista ang mga error na nasasalubong ng mga tool na ito.

Aling endpoint ang ginagamit ng bawat tool

Parehong API key ang tinatanggap ng lahat ng tatlong endpoint, bilang Authorization: Bearer o bilang x-api-key. Tinatanggap ang mga header na anthropic-version, anthropic-beta at openai-beta na ipinapadala ng mga tool na ito.

Pumili ng Shannon model

Dapat pangalanan ng bawat request ang isang model id na inilalathala ng Shannon. Ipinapadala ng coding tool ang pangalan ng sarili nitong default na model maliban kung sasabihin mo nang iba, at ang pangalang hindi inilalathala ng Shannon ay sinasagot ng 400 at ng mensaheng unknown model: <name>. Walang ibang pangalan na minamapa sa Shannon model, kaya i-set ang model sa tool bago ang unang request.

Inililista ng GET /v1/models ang bawat id kasama ang context window nito. Walang key na kailangan. Mga model at presyo

Ginagabayan ng mga coding tool ang model gamit ang mahabang system prompt. Ina-apply ang system prompt ng shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro at ng mga hosted open-weight model, kaya pumili ng isa sa mga ito para sa coding tool.

Claude Code

Binabasa ng Claude Code ang koneksyon nito mula sa mga environment variable. I-set ang mga ito sa shell na nagsisimula nito, o sa env block ng ~/.claude/settings.json para manatili sa bawat session.

# 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"
  }
}

• I-set ang lahat ng tatlong variable na ANTHROPIC_DEFAULT_…_MODEL. Humihingi ang mga subagent at ilang command ng model sa built-in na pangalan nito, at dapat mag-resolve ang bawat pangalan sa isang Shannon id.
• Itinuturo ng sample ang mga background request sa shannon-1.6-lite, na binibilang sa tokens. Kaya hindi gumagamit ng Coder calls ang mga pamagat ng session at katulad na request.
• Hinihingi ng Claude Code sa POST /v1/messages/count_tokens ang laki ng context. Gumagana ang endpoint para sa mga hosted open-weight model. Sa Shannon id, sumasagot ito ng 400; itinuturing ng Claude Code na opsyonal ang token counting at tinatantya nito mismo ang laki. Pagbibilang ng token

Para suriin ang address, ang key at ang model id bago simulan ang tool, magpadala ng isang request nang mano-mano:

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

Nakikipag-usap ang Codex CLI sa Responses API. Ilarawan ang Shannon bilang model provider sa ~/.codex/config.toml, pumili roon ng Shannon model id, at ilagay ang iyong API key sa environment variable na pinangalanan ng 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

• Walang itinatagong conversation ang /v1/responses sa server: dala ng bawat request ang conversation sa input. Tinatanggap ang previous_response_id para sa compatibility.
• Iniaalok sa model ang mga function tool (type: "function") sa /v1/responses.
• Sa /v1/responses, ang shannon-coder-1 ay binibilang sa tokens mula sa iyong balance, hindi sa Coder calls.

Ang parehong pagsusuri para sa 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."
  }'

Ang coding model at kung paano ito binibilang

Ang shannon-coder-1 ay ang Shannon model para sa mga coding agent. Iniuulat ito ng GET /v1/models na may context window na 131,072 tokens, tool call, reasoning at text input. Binibilang ito sa isa sa dalawang paraan, depende sa endpoint na ginagamit ng tool.

Ang call ay isang request, anuman ang laki nito. Binibilang ito kapag tinanggap ang request, bago sumagot ang model. Nagpapadala ang agent session ng isang request sa bawat hakbang nito, kaya maraming call ang ginagamit ng mahabang gawain. Depende sa iyong plan ang allowance at nagsisimula ulit tuwing 4 na oras, sa 00:00, 04:00, 08:00, 12:00, 16:00 at 20:00 UTC.

Ipinapakita ng pahina ng plan ang kasalukuyang mga numero. Mga plan

Kapag naubos na ang mga call ng isang window, sinasagot ang request ng 429. Sa /v1/messages, dumarating ang parehong error sa hugis ng 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 overflow

Kapag mas malaki ang conversation kaysa sa context window ng model, sumasagot ang /v1/chat/completions at /v1/messages ng 400, ang type na invalid_request_error, ang code na context_length_exceeded at isang mensaheng nagsisimula sa prompt is too long. Binabasa ng mga coding tool ang error na ito para i-compact ang session at ipadala muli ang request. Ginagawa ito ng shannon-coder-1, shannon-1.6-lite at 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
  }
}

Ang mensahe ay prompt is too long: <sent> tokens > <limit> maximum. Kapag hindi alam ang dalawang numero, ito ay prompt is too long. Please compact the conversation and try again.

Sa isang stream, 200 na ang status, kaya dumarating ang error bilang event at pagkatapos ay normal na magsasara ang 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"}

Ang maaasahan ng isang agent loop

Pag-troubleshoot

Nasa pahinang Keys & usage ang iyong key at balance. Keys & usage