Fitaovana CLI ho an'ny coding

Ny coding tool dia mila setting telo vao mandeha miaraka amin'i Shannon: ny base URL an'ny API, ny API key-nao ary ny id an'ny model Shannon. Ity pejy ity dia manome ny setting marina ho an'i Claude Code sy Codex CLI, manazava ny fomba ikajiana ny model coding shannon-coder-1, ary mitanisa ny hadisoana mihatra amin'ireto tool ireto.

Ny endpoint ampiasain'ny tool tsirairay

Ireo endpoint telo dia mampiasa API key iray ihany, na amin'ny endrika Authorization: Bearer na x-api-key. Ekena ny header anthropic-version, anthropic-beta ary openai-beta alefan'ireto tool ireto.

Misafidiana model Shannon

Ny fangatahana rehetra dia tsy maintsy manonona id model navoakan'i Shannon. Ny coding tool dia mandefa ny anaran'ny model default-ny raha tsy lazainao hafa, ary ny anarana tsy navoakan'i Shannon dia valiana amin'ny 400 miaraka amin'ny hafatra unknown model: <name>. Tsy misy anarana hafa voafantina ho model Shannon, ka apetraho ao amin'ny tool ny model alohan'ny fangatahana voalohany.

GET /v1/models dia mitanisa ny id rehetra miaraka amin'ny context window-ny. Tsy mila key izy io. Model & vidiny

Ny coding tool dia mitarika ny model amin'ny system prompt lava. Ny system prompt dia ampiharin'ny shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro ary ny model open-weight hosted, ka misafidiana iray amin'ireo ho an'ny coding tool.

Claude Code

Claude Code dia mamaky ny fifandraisany avy amin'ny environment variables. Apetraho ao amin'ny shell izay manomboka azy izy ireo, na ao amin'ny blocks env ao amin'ny ~/.claude/settings.json mba hitazonana azy ho an'ny session rehetra.

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

• Apetraho ny variable telo rehetra ANTHROPIC_DEFAULT_…_MODEL. Ny subagent sy ny baiko sasany dia mangataka model amin'ny anarany built-in, ary ny anarana tsirairay dia tsy maintsy mitondra mankany amin'id Shannon.
• Ny santionany dia mitondra ny fangatahana ao ambadika any amin'ny shannon-1.6-lite, izay isaina amin'ny tokens. Ny lohatenin'ny session sy ny fangatahana mitovy aminy dia tsy mampiasa antso Coder.
• Claude Code dia mangataka ny POST /v1/messages/count_tokens ho an'ny haben'ny context. Ny endpoint dia manisa ho an'ny model open-weight hosted. Amin'ny id Shannon dia mamaly 400 izy; Claude Code dia mihevitra ny fanisana tokens ho tsy voatery ary manombana ny habeny samy hafa. Fanisana token

Raha hizaha ny adiresy, ny key ary model id alohan'ny hanombohanao ny fitaovana, alefaso tanana ny fangatahana iray:

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 dia miresaka amin'ny Responses API. Faritana ho model provider i Shannon ao amin'ny ~/.codex/config.toml, fidio eo ny model id Shannon, ary apetraho ao amin'ny environment variable voatondron'ny provider ny API key-nao.

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

• Ny /v1/responses dia tsy mitahiry resaka ao amin'ny server: ny fangatahana tsirairay dia mitondra ny resaka ao amin'ny input. Ekena ny previous_response_id ho fifanarahana.
• Ny function tools (type: "function") dia atolotra amin'ny model amin'ny /v1/responses.
• Amin'ny /v1/responses, ny shannon-coder-1 dia isaina amin'ny tokens avy amin'ny balance-nao, fa tsy amin'ny antso Coder.

Ny fanamarinana mitovy ho an'ny endpoint 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."
  }'

Ny model coding sy ny fomba ikajiana azy

Ny shannon-coder-1 dia ny model Shannon ho an'ny coding agents. Ny GET /v1/models dia milaza azy miaraka amin'ny context window 131,072 tokens, tool calls, reasoning ary text input. Isaina amin'ny fomba iray amin'ny roa izy, arakaraka ny endpoint ampiasain'ny fitaovana.

Ny antso dia fangatahana iray, na inona na inona ny habeny. Isaina rehefa ekena ny fangatahana, alohan'ny hamaliany ny model. Ny agent session dia mandefa fangatahana iray isaky ny dingana ataony, ka ny asa lava dia mampiasa antso maro. Miankina amin'ny plan-nao ny allowance ary manomboka indray isaky ny 4 ora, amin'ny 00:00, 04:00, 08:00, 12:00, 16:00 ary 20:00 UTC.

Ny pejy plan dia mampiseho ny isa ankehitriny. Plans

Rehefa lany ny antso amin'ny fe-potoana iray, ny fangatahana dia valiana 429. Amin'ny /v1/messages dia tonga amin'ny endrika Anthropic ny hadisoana mitovy.

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

Rehefa lehibe noho ny context window an'ny model ny resaka, ny /v1/chat/completions sy /v1/messages dia mamaly amin'ny 400, ny type invalid_request_error, ny code context_length_exceeded ary hafatra manomboka amin'ny prompt is too long. Vakian'ny coding tool io hadisoana io mba hanamafohizany ny session ary handefasany indray ny fangatahana. Avoakan'ny shannon-coder-1, shannon-1.6-lite ary shannon-1.6-pro izy.

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

Ny hafatra dia prompt is too long: <sent> tokens > <limit> maximum. Raha tsy fantatra ireo isa roa dia prompt is too long. Please compact the conversation and try again.

Amin'ny stream dia efa 200 ny status, ka tonga ho event ny hadisoana ary mikatona amin'ny fomba mahazatra ny stream avy eo:

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

Izay azon'ny agent loop iankinana

Famahana olana

Ny key sy ny balance-nao dia ao amin'ny pejy Keys & usage. Keys & usage