Ngwa CLI maka coding

Coding tool chọrọ setting atọ iji soro Shannon rụọ ọrụ: base URL nke API, API key gị na Shannon model id. Peeji a na-enye setting ziri ezi maka Claude Code na Codex CLI, na-akọwa otu esi agụ coding model shannon-coder-1, ma depụta njehie tools ndị a na-ezute.

Endpoint nke tool ọ bụla na-eji

Endpoints atọ ahụ niile na-anara otu API key, dị ka Authorization: Bearer ma ọ bụ dị ka x-api-key. A na-anabata headers anthropic-version, anthropic-beta na openai-beta ndị tools ndị a na-eziga.

Họrọ Shannon model

Request ọ bụla ga-akpọ model id nke Shannon bipụtara. Coding tool na-ezipu aha default model nke ya ma ọ bụrụ na ị agwaghị ya ọzọ, a na-azakwa aha Shannon na-ebipụtaghị site na 400 na ozi unknown model: <name>. Enweghị aha ọzọ a na-eme map gaa Shannon model, ya mere tọọ model ahụ n'ime tool tupu request mbụ.

GET /v1/models depụtara id niile na context window ha. Ọ chọghị key. Models & ọnụahịa

Coding tools na-eji system prompt ogologo eduzi model. shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro na hosted open-weight models na-etinye system prompt ahụ, ya mere họrọ otu n'ime ha maka coding tool.

Claude Code

Claude Code na-agụ njikọ ya site na environment variables. Setịpụ ha na shell na-amalite ya, ma ọ bụ n'ime env block nke ~/.claude/settings.json iji debe ha maka session ọ bụla.

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

• Setịpụ variables ANTHROPIC_DEFAULT_…_MODEL atọ niile. Subagents na ụfọdụ iwu na-arịọ model site na aha e wuru n'ime, ma aha ọ bụla ga-agbanwe ka ọ bụrụ Shannon id.
• Ihe atụ na-eduga requests azụ na shannon-1.6-lite, nke a na-agụ na tokens. Aha session na requests dị otú ahụ anaghị eji oku Coder mgbe ahụ.
• Claude Code na-ajụ POST /v1/messages/count_tokens maka nha context. Endpoint na-agụ maka hosted open-weight models. Na Shannon id ọ na-azaghachi 400; Claude Code na-ewere ịgụ token dị ka nhọrọ ma na-eche nha n'onwe ya. Ịgụ tokens

Iji lelee adreesị, key na model id tupu ịmalite tool, zipu otu request n'aka:

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 na-agwa Responses API okwu. Kọwaa Shannon dị ka model provider n'ime ~/.codex/config.toml, họrọ Shannon model id n'ebe ahụ, ma tinye API key gị n'ime environment variable provider kpọrọ aha.

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 anaghị edebe mkparịta ụka na server: request ọ bụla na-ebu mkparịta ụka n'ime input. A na-anabata previous_response_id maka nkwekọrịta.
• A na-enye model Function tools (type: "function") na /v1/responses.
• Na /v1/responses, a na-agụ shannon-coder-1 na tokens site na balance gị, ọ bụghị n'oku Coder.

Otu nlele ahụ maka 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."
  }'

Coding model na otu esi agụ ya

shannon-coder-1 bụ model Shannon maka coding agents. GET /v1/models na-akọ ya nwere context window nke tokens 131,072, oku tool, reasoning na text input. A na-agụ ya n'otu n'ụzọ abụọ, dabere n'endpoint tool na-eji.

Oku bụ otu request, n'agbanyeghị nha ya. A na-agụ ya mgbe a nabatara request, tupu model aza. Session agent na-ezipụ otu request maka nzọụkwụ ọ bụla ọ na-eme, yabụ ọrụ ogologo na-eji ọtụtụ oku. Allowance na-adabere na plan gị ma na-amalite ọzọ kwa awa 4, na 00:00, 04:00, 08:00, 12:00, 16:00 na 20:00 UTC.

Peeji plan na-egosi nọmba ndị dị ugbu a. Plans

Mgbe oku nke windo gwụrụ, a na-azaghachi request na 429. Na /v1/messages otu njehie ahụ na-abịa n'udi 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

Mgbe mkparịta ụka buru ibu karịa context window nke model, /v1/chat/completions na /v1/messages na-aza site na 400, ụdị invalid_request_error, koodu context_length_exceeded na ozi malitere na prompt is too long. Coding tools na-agụ njehie a iji kpọkọta session ma zighachi request. shannon-coder-1, shannon-1.6-lite na shannon-1.6-pro na-emepụta ya.

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

Ozi ahụ bụ prompt is too long: <sent> tokens > <limit> maximum. Mgbe amabeghị ọnụọgụ abụọ ahụ, ọ bụ prompt is too long. Please compact the conversation and try again.

Na stream, status bụ 200 ugbu a, ya mere njehie ahụ na-abịa dị ka event, stream ahụ na-emechi n'ụzọ nkịtị:

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

Ihe agent loop nwere ike ịtụkwasị obi na ya

Idozi nsogbu

Key gị na balance gị nọ na peeji Keys & usage. Keys & usage