Lisebelisoa tsa CLI tsa ho ngola code

Tool ea ho ngola code e hloka litlhophiso tse tharo ho sebetsa le Shannon: base URL ea API, senotlolo sa hau sa API, le id ea model ea Shannon. Leqephe lena le fana ka litlhophiso tse nepahetseng bakeng sa Claude Code le Codex CLI, le hlalosa hore na model ea ho ngola code shannon-coder-1 e baloa joang, le ho thathamisa liphoso tseo lisebelisoa tsena li kopanang le tsona.

Hore na tool e 'ngoe le e 'ngoe e sebelisa endpoint efe

Li-endpoint tse tharo tsohle li amohela senotlolo se tšoanang sa API, e le Authorization: Bearer kapa e le x-api-key. Li-header anthropic-version, anthropic-beta le openai-beta tseo lisebelisoa tsena li li romelang lia amohelwa.

Khetha model ea Shannon

Kopo e 'ngoe le e 'ngoe e tlameha ho reha id ea model eo Shannon e e phatlalatsang. Tool ea ho ngola code e romela lebitso la model ea eona ea default ntle le haeba u e joetsa ka tsela e 'ngoe, mme lebitso leo Shannon e sa le phatlalatseng le arajoa ka 400 le molaetsa unknown model: <name>. Ha ho lebitso le leng le fetoleloang ho model ea Shannon, kahoo beha model ho tool pele ho kopo ea pele.

GET /v1/models e thathamisa id e 'ngoe le e 'ngoe le context window ea eona. Ha e hloke senotlolo. Li-model le litheko

Lisebelisoa tsa ho ngola code li laola model ka system prompt e telele. System prompt e sebelisoa ke shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro le li-model tse hosted tsa open-weight, kahoo khetha e 'ngoe ea tsena bakeng sa tool ea ho ngola code.

Claude Code

Claude Code e bala connection ea eona ho li-environment variable. Li behe ho shell e e qalang, kapa ho block ea env ea ~/.claude/settings.json ho li boloka bakeng sa session e 'ngoe le e 'ngoe.

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

• Beha li-variable tsohle tse tharo tsa ANTHROPIC_DEFAULT_…_MODEL. Li-subagent le li-command tse ling li kopa model ka lebitso la eona le kenyellelitsoeng, mme lebitso le leng le le leng le tlameha ho fetoloa ho id ea Shannon.
• Sampole e supa likopo tsa ka morao ho shannon-1.6-lite, e baloang ka tokens. Mabitso a session le likopo tse tšoanang ha li sebelise likopo tsa Coder.
• Claude Code e kopa POST /v1/messages/count_tokens boholo ba context. Endpoint e bala bakeng sa li-model tse hosted tsa open-weight. Ka id ea Shannon e araba ka 400; Claude Code e nka ho bala tokens e le ho sa hlokahaleng mme e lekanya boholo ka boeona. Ho bala tokens

Ho hlahloba aterese, senotlolo le id ea model pele u qala tool, romela kopo e le 'ngoe ka letsoho:

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 e bua le Responses API. Hlalosa Shannon e le model provider ho ~/.codex/config.toml, khetha id ea model ea Shannon moo, mme u behe senotlolo sa hau sa API ho environment variable eo provider e e rehang.

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 ha e boloke moqoqo ho server: kopo e 'ngoe le e 'ngoe e nka moqoqo ho input. previous_response_id e amohelwa bakeng sa compatibility.
• Lisebelisoa tsa function (type: "function") li fuoa model ho /v1/responses.
• Ho /v1/responses, shannon-coder-1 e baloa ka tokens ho tsoa ho balance ea hau, eseng ka likopo tsa Coder.

Hlahlobo e tšoanang bakeng sa endpoint ea 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."
  }'

Model ea ho ngola code le hore e baloa joang

shannon-coder-1 ke model ea Shannon bakeng sa li-agent tsa ho ngola code. GET /v1/models e e tlaleha e nang le context window ea tokens tse 131,072, likopo tsa tool, reasoning le input ea mongolo. E baloa ka mekhoa e 'meli, ho latela endpoint eo tool e e sebelisang.

Kopo ke kopo e le 'ngoe, ho sa tsotellehe boholo ba eona. E baloa ha kopo e amoheloa, pele model e araba. Session ea agent e romela kopo e le 'ngoe bakeng sa mohato o mong le o mong o o nkang, kahoo mosebetsi o molelele o sebelisa likopo tse ngata. Allowance e itšetlehile ka plan ea hau mme e qala hape lihora tse 4 tse ling le tse ling, ka 00:00, 04:00, 08:00, 12:00, 16:00 le 20:00 UTC.

Leqephe la plan le bontša linomoro tsa hajoale. Li-plan

Ha likopo tsa fensetere li fela, kopo e arajoa ka 429. Ho /v1/messages phoso e tšoanang e fihla ka sebopeho sa 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

Ha moqoqo o le moholo ho feta context window ea model, /v1/chat/completions le /v1/messages li araba ka 400, mofuta invalid_request_error, code context_length_exceeded le molaetsa o qalang ka prompt is too long. Lisebelisoa tsa ho ngola code li bala phoso ena ho compact session le ho romela kopo hape. E hlahisoa ke shannon-coder-1, shannon-1.6-lite le 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
  }
}

Molaetsa ke prompt is too long: <sent> tokens > <limit> maximum. Ha linomoro tse peli li sa tsejoe ke prompt is too long. Please compact the conversation and try again.

Ho stream boemo bo se bo le 200, kahoo phoso e fihla e le event mme stream e ntan e koala ka tsela e tloaelehileng:

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

Seo agent loop e ka itšetlehang ka sona

Ho rarolla mathata

Senotlolo sa hau le balance ea hau li leqepheng la Keys & usage. Keys & usage