CLI tools dzekunyora code

Coding tool inoda settings nhatu kuti ishande neShannon: base URL ye-API, API key yako, ne-Shannon model id. Peji iyi inopa settings chaizvo dze-Claude Code ne-Codex CLI, inotsanangura kuti coding model shannon-coder-1 inoverengwa sei, uye inoratidza ma-error anosangana nawo tools idzi.

Endpoint inoshandiswa ne-tool imwe neimwe

Ma-endpoint ese matatu anogamuchira API key imwechete, se-Authorization: Bearer kana se-x-api-key. Headers anthropic-version, anthropic-beta ne-openai-beta dzinotumirwa ne-tools idzi dzinogamuchirwa.

Sarudza Shannon model

Request imwe neimwe inofanira kutumidza model id inoburitswa neShannon. Coding tool inotumira zita re-default model yayo pachayo kana usina kuiudza zvimwe, uye zita risingaburitswi neShannon rinopindurwa ne-400 ne-message unknown model: <name>. Hapana zita rimwe rinoendeswa kune Shannon model, saka isa model mu-tool usati watumira request yekutanga.

GET /v1/models inoratidza id imwe neimwe ine context window yayo. Haidi key. Ma-model nemitengo

Coding tools dzinotungamira model ne-system prompt refu. System prompt inoshandiswa ne-shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro ne-hosted open-weight models, saka sarudza imwe yadzo ye-coding tool.

Claude Code

Claude Code inoverenga connection yayo kubva ku-environment variables. Dzise mu-shell inoitanga, kana mu-env block ye-~/.claude/settings.json kuti dzirambe dziripo pa-session imwe neimwe.

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

• Isa ma-variable ese matatu e-ANTHROPIC_DEFAULT_…_MODEL. Subagents nemamwe commands dzinokumbira model nezita rayo rakavakirwa mukati, uye zita rimwe nerimwe rinofanira kuenda ku-Shannon id.
• Sample inotarisa background requests ku-shannon-1.6-lite, inoverengwa mu-tokens. Session titles nema-request akafanana haashandisi Coder calls.
• Claude Code inokumbira POST /v1/messages/count_tokens kuti iwane size ye-context. Endpoint inoverenga pa-hosted open-weight models. Ne-Shannon id inopindura 400; Claude Code inotora token counting seisina kudiwa uye inofungidzira size pachayo. Kuverenga tokens

Kuti utarise address, key ne-model id usati watanga tool, tumira request imwe nemaoko:

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 inotaura ne-Responses API. Tsanangura Shannon se-model provider mu-~/.codex/config.toml, sarudza Shannon model id ipapo, uye isa API key yako mu-environment variable inotumidzwa ne-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 haichengeti hurukuro pa-server: request imwe neimwe inotakura hurukuro mu-input. previous_response_id inogamuchirwa kuti zvienderane.
• Function tools (type: "function") dzinopiwa ku-model pa-/v1/responses.
• Pa-/v1/responses, shannon-coder-1 inoverengwa mu-tokens kubva mu-balance yako, kwete mu-Coder calls.

Check imwechete ye-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 uye kuti inoverengwa sei

shannon-coder-1 i-Shannon model ye-coding agents. GET /v1/models inoiratidza ine context window ye-131,072 tokens, tool calls, reasoning ne-text input. Inoverengwa nenzira mbiri, zvichienderana ne-endpoint inoshandiswa ne-tool.

Call i-request imwe, chero size yayo. Inoverengwa kana request yagamuchirwa, model isati yapindura. Agent session inotumira request imwe pa-danho rimwe nerimwe rainotora, saka basa refu rinoshandisa calls dzakawanda. Allowance inoenderana ne-plan yako uye inotanga zvakare maawa 4 ega ega, pa-00:00, 04:00, 08:00, 12:00, 16:00 ne-20:00 UTC.

Peji re-plan rinoratidza nhamba dzazvino. Plans

Kana calls dzewindow dzapera, request inopindurwa ne-429. Pa-/v1/messages error imwechete inouya mu-Anthropic shape.

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

Kana hurukuro yakakura kupfuura context window ye-model, /v1/chat/completions ne-/v1/messages dzinopindura ne-400, type invalid_request_error, code context_length_exceeded ne-message inotanga ne-prompt is too long. Coding tools dzinoverenga error iyi kuti dzidimbure session ndokutumira request zvakare. Inogadzirwa ne-shannon-coder-1, shannon-1.6-lite ne-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
  }
}

Message ndi-prompt is too long: <sent> tokens > <limit> maximum. Kana nhamba mbiri dzisingazikanwi i-prompt is too long. Please compact the conversation and try again.

Pa-stream status yatova 200, saka error inouya se-event uye stream inobva yavhara nenzira yakajairika:

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

Zvinogona kuvimbwa ne-agent loop

Kugadzirisa matambudziko

Key yako ne-balance yako ziri papeji reKeys & usage. Keys & usage