Peke ki ngā ihirangi
Ngā taputapu CLI mō te tuhi code

Ngā taputapu CLI mō te tuhi code

Hou

Whakamahia a Shannon hei model i muri i a Claude Code, Codex CLI me ētahi atu CLI kaiwhakahaere.

E toru ngā tautuhinga e hiahiatia ana e tētahi taputapu whakawaehere kia mahi ai me Shannon: te base URL o te API, tō API key me tētahi id model Shannon. Ka hoatu e tēnei whārangi ngā tautuhinga tika mō Claude Code me Codex CLI, ka whakamārama i te tatau o te model whakawaehere shannon-coder-1, ā, ka whakarārangi i ngā hapa e pāngia ana e ēnei taputapu.

Ko tēhea endpoint e whakamahia ana e ia taputapu

Taputapu Endpoint Base URL hei tautuhi Tuhipoka
Claude Code POST /v1/messages
POST /v1/messages/count_tokens
https://api.shannon-ai.com Ka tāpiri te taputapu i te /v1/messages ki te base URL mā tōna ake.
Codex CLI POST /v1/responses https://api.shannon-ai.com/v1 Ka tāpiri te taputapu i te /responses ki te base URL.
Ētahi atu taputapu kaiwhakahaere e kōrero ana i te hōputu chat OpenAI POST /v1/chat/completions https://api.shannon-ai.com/v1 Tautuhia te base URL, te key me tētahi model id Shannon i ngā tautuhinga ake a te taputapu.

Ka whakaae ngā endpoint e toru ki te API key ōrite, hei Authorization: Bearer hei x-api-key rānei. Ka whakaaetia ngā header anthropic-version, anthropic-beta me openai-beta e tukuna ana e ēnei taputapu.

Kōwhiria tētahi model Shannon

Me whakaingoa e ia tono tētahi id model e whakaputaina ana e Shannon. Ka tuku tētahi taputapu whakawaehere i te ingoa o tōna ake model taunoa mēnā kāore koe e kī atu ki a ia, ā, ka whakautua tētahi ingoa kāore Shannon e whakaputa ki te 400 me te karere unknown model: <name>. Kāore tētahi atu ingoa e mahia ki tētahi model Shannon, nō reira tautuhia te model i roto i te taputapu i mua i te tono tuatahi.

Ka rārangi te GET /v1/models i ia id me tōna matapihi horopaki. Kāore he key e hiahiatia. Ngā model me ngā utu

Model Ka tatauria hei Tāna e kawe mai ai
shannon-coder-1 Kotahi karanga mō ia tono i runga i te /v1/messages me te /v1/chat/completions. Ko ngā tokens i runga i te /v1/responses. Te model whakawaehere. Input kuputuhi, ngā karanga tool, matapihi horopaki 131,072 token.
shannon-1.6-lite
shannon-1.6-pro
Ngā tokens mai i tō toenga. Ngā model whānui me ngā karanga tool. He pai te shannon-1.6-lite mō ngā tono poto i muri i te atamira e whakahaerehia ana e tētahi taputapu.
Ngā model open-weight hosted Ngā tokens mai i tō toenga, ka whai te input cached i te 25% o te utu input. Ngā karanga tool, prompt caching mō ngā wā roa, me ngā tatau tika mai i te /v1/messages/count_tokens.

Ka arahi ngā taputapu whakawaehere i te model mā tētahi system prompt roa. Ka whakamahia te system prompt e te shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro me ngā model open-weight hosted, nō reira kōwhiria tētahi o ēnei mō tētahi taputapu whakawaehere.

Claude Code

Ka pānui a Claude Code i tōna hononga mai i ngā environment variable. Tautuhia i te shell e tīmata ana i a ia, i te poraka env rānei o te ~/.claude/settings.json kia mau mō ia hui.

# 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
Variable Whakaahuatanga
ANTHROPIC_BASE_URL Te wāhi e tuku ai a Claude Code i āna tono. Whakamahia te wāhitau kāore he /v1.
ANTHROPIC_AUTH_TOKEN Tō Shannon API key, i tukuna hei Authorization: Bearer. Ka mahi hoki te ANTHROPIC_API_KEY: ka tuku i te key hei x-api-key, ā, ka pātai te Claude Code kia kotahi te wā hei whakaae.
ANTHROPIC_MODEL Te model o te hui. Ka tautuhi te claude --model <id> me te /model <id> i te mea ōrite.
ANTHROPIC_DEFAULT_HAIKU_MODEL Te model mō ngā tono i muri mai pērā i ngā taitara hui, me mō ngā mea katoa e tono ana i te haiku.
ANTHROPIC_DEFAULT_SONNET_MODEL Te model ka whakamahia ina tono tētahi subagent, tētahi whakahau rānei i te sonnet.
ANTHROPIC_DEFAULT_OPUS_MODEL Te model ka whakamahia ina tono tētahi subagent, tētahi whakahau rānei i te opus.
CLAUDE_CODE_MAX_CONTEXT_TOKENS Te matapihi horopaki e whakaaro ana a Claude Code mō te model. Whakamahia te context_window e pūrongo ana te GET /v1/models mō te id i kōwhiria e koe.
  • Tautuhia ngā variable ANTHROPIC_DEFAULT_…_MODEL e toru katoa. Ka tono ngā subagent me ētahi whakahau i tētahi model mā tōna ingoa kua hanga-ki-roto, ā, me whakatau ia ingoa ki tētahi id Shannon.
  • Ka tohu te tauira i ngā tono i muri mai ki te shannon-1.6-lite, e tatauria ana i ngā tokens. Kāore ngā taitara hui me ngā tono pēnei e whakamahi i ngā karanga Coder.
  • Ka tono a Claude Code i te POST /v1/messages/count_tokens mō te rahi o te horopaki. Ka tatau te endpoint mō ngā model open-weight hosted. Me tētahi id Shannon ka whakautu ki te 400; ka whakaaro a Claude Code he kōwhiringa te tatau token, ā, ka whakatau i te rahi mā ōna ake tātai. Te tatau token

Hei tirotiro i te wāhitau, te key me tētahi model id i mua i te tīmata i te taputapu, tukuna tētahi tono ā-ringa:

cURL
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

Ka kōrero a Codex CLI ki te Responses API. Whakaahuatia a Shannon hei model provider i te ~/.codex/config.toml, kōwhiria he model id Shannon ki reira, ā, whakaurua tō API key ki te environment variable e ingoatia ana e te provider.

~/.codex/config.toml
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"
Shell
# 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
Key Whakaahuatanga
model Te model id Shannon. Ka tautuhi te codex --model <id> mō te rere kotahi.
model_provider Te ingoa o te poraka provider hei whakamahi, ko shannon i konei.
base_url Te wāhitau API me te /v1.
env_key Te ingoa o te environment variable e mau ana i tō Shannon API key.
wire_api responses: ka kōrero a Codex ki te POST /v1/responses.
model_context_window Te matapihi horopaki o te model, kia kiato a Codex i tētahi hui roa i te wā tika. Whakamahia te context_window e pūrongo ana te GET /v1/models.
  • Kāore te /v1/responses e pupuri i tētahi kōrero i te server: kei ia tono te kōrero i te input. Ka whakaaetia te previous_response_id mō te hototahi.
  • Ka tukuna ngā tools function (type: "function") ki te model i runga i te /v1/responses.
  • I runga i te /v1/responses, ka tatauria te shannon-coder-1 i ngā tokens mai i tō toenga, kaua i ngā karanga Coder.

Te tirotiro ōrite mō te endpoint Responses:

cURL
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."
  }'

Te model whakawaehere me te āhua o tana tatau

Ko te shannon-coder-1 te model Shannon mō ngā kaiwhakahaere code. Ka pūrongo te GET /v1/models i a ia me tētahi matapihi horopaki o 131,072 tokens, tool call, reasoning me te input kuputuhi. Ka tatauria mā tētahi o ngā tikanga e rua, i runga i te endpoint e whakamahia ana e tētahi taputapu.

Endpoint Te utu o tētahi tono Tangohia mai i
/v1/messages 1 karanga mō ia tono Te whakaaetanga karanga Coder o tō mahere. Kāore he tokens e tangohia mai i tō toenga.
/v1/chat/completions 1 karanga mō ia tono Te whakaaetanga karanga Coder o tō mahere. Kāore he tokens e tangohia mai i tō toenga.
/v1/responses Tokens, ki te $8.00 mō ia 1M Tō toenga, pēnei i ētahi atu model. Kāore te whakaaetanga karanga e whakamahia.

Ko te karanga he tono kotahi, ahakoa tōna rahi. Ka tatauria ina whakaaetia te tono, i mua i te whakautu a te model. Ka tuku tētahi hui kaiwhakahaere i tētahi tono mō ia hikoi ka mahia, nō reira ka whakamahi tētahi mahi roa i ētahi karanga maha. Ka whakawhirinaki te whakaaetanga ki tō mahere, ā, ka tīmata anō ia 4 hāora, i te 00:00, 04:00, 08:00, 12:00, 16:00 me te 20:00 UTC.

Mahere Ngā karanga mō ia matapihi 4-hāora
Free 3
Plus 20
Standard 40
Pro 60

Ka whakaatu te whārangi mahere i ngā tau o nāianei. Ngā mahere

Ina pau ngā karanga o tētahi matapihi, ka whakautua te tono ki te 429. I runga i te /v1/messages ka tae mai te hapa ōrite i te āhua Anthropic.

429 /v1/chat/completions
{
  "error": {
    "type": "rate_limit_error",
    "message": "Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan"
  }
}
429 /v1/messages
{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan"
  }
}

Te kapi ake o te horopaki

Ina nui ake tētahi kōrero i te matapihi horopaki o te model, ka whakautu te /v1/chat/completions me te /v1/messages ki te 400, te momo invalid_request_error, te waehere context_length_exceeded me tētahi karere e tīmata ana ki te prompt is too long. Ka pānui ngā taputapu whakawaehere i tēnei hapa hei whakamāmā i te wā, ā, ka tuku anō i te tono. Ka puta mai i te shannon-coder-1, shannon-1.6-lite me te shannon-1.6-pro.

400 /v1/chat/completions
{
  "error": {
    "type": "invalid_request_error",
    "code": "context_length_exceeded",
    "message": "prompt is too long: 140211 tokens > 131072 maximum",
    "param": null
  }
}
400 /v1/messages
{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "code": "context_length_exceeded",
    "message": "prompt is too long: 140211 tokens > 131072 maximum",
    "param": null
  }
}

Ko te karere ko prompt is too long: <sent> tokens > <limit> maximum. Ina kāore e mōhiotia ngā tau e rua, ko prompt is too long. Please compact the conversation and try again. tērā.

I runga i tētahi stream kua 200 kē te tūnga, nō reira ka tae mai te hapa hei kaupapa, ā, ka kati te stream i te tikanga noa:

/v1/chat/completions, 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]
/v1/messages, stream
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"}

Ngā mea e taea te whakawhirinaki e tētahi agent loop

Kaupapa Whanonga
Ngā schema tool Ka tangohia ngā tautuhinga tool pērā i tā te tool e tuku ai. I runga i te shannon-coder-1 me te shannon-1.6-*, ka waiho ngā kupu matua JSON Schema kāore te model e whakamahi, pērā i te $schema, $ref, additionalProperties, default me title, ki waho i tā te model e pānui ai, ā, ka pānuitia te oneOf hei anyOf. Kāore he tono e whakakāhoretia mō rātou.
Ngā tohenga tool call I roto i tētahi stream, ka tae mai ngā tohenga o tētahi tool call oti i tētahi delta: tool_calls[].function.arguments, input_json_delta.partial_json he response.function_call_arguments.delta rānei.
Te mutunga o tētahi tahuri tool finish_reason: "tool_calls" i runga i Chat Completions, stop_reason: "tool_use" i runga i Messages.
Keep-alive I te wā e mahi ana te model, ka tuku te /v1/messages i te event: ping, ā, ka tuku te /v1/chat/completions i tētahi rārangi kōrero : ping ia 15 hekona.
Te whakamutu i tētahi tono Ka mutu te stream i te katinga o te hononga. Ka rere tonu te tahuri ki tōna mutunga, ā, ka tatauria.

Te whakatika raruraru

Tohu Take Whakatika
400 me unknown model: claude-… he unknown model: gpt-… rānei I tukuna e te taputapu tōna ake ingoa model taunoa. Ko ngā id Shannon kua whakaputaina anake e ratoa ana, ā, kāore tētahi atu ingoa e mahia ki tētahi. Kōwhiria tētahi id Shannon: ANTHROPIC_MODEL me ngā taurangi e toru ANTHROPIC_DEFAULT_…_MODEL i Claude Code, te model i te whirihora Codex.
400 me unknown model: ā, kāore he ingoa, mai i Codex CLI Kāore he model i whakaingoatia e te tono. Me whai tētahi te /v1/responses. Tautuhia te model i roto i te ~/.codex/config.toml, tukuna rānei te --model.
401 me Missing authentication he Invalid API key rānei Kāore te key i tae ki te API, ehara rānei i te key o nāianei. Ka tīmata te key Shannon ki te sk-. Tirohia kua tautuhia te taurangi i roto i te shell e whakaoho ana i te taputapu. Tāruatia anō te key mai i Keys & usage.
404 i ia tono Kotahi te /v1 e nui rawa ana, e iti rawa ana rānei i te base URL mō te taputapu. Claude Code: te wāhitau kāore he /v1. Codex CLI: te wāhitau me te /v1.
429 me Shannon Coder call quota reached Kua pau ngā karanga Coder o te matapihi 4 hāora o nāianei. Tatari ki te matapihi e whai ake nei, neke ki tētahi mahere me ētahi atu karanga, kōwhiri rānei i tētahi model e tatauria ana ki ngā tokens.
429 me Quota exceeded Kāore tō toenga e kapi i te tono. Tāpiria he nama, tatari rānei ki te whakaaetanga ia rā o tō mahere i te 00:00 UTC.
400 me prompt is too long Nui ake te kōrero i te matapihi horopaki o te model. Whakamāmāhia te wā (/compact i ngā taputapu e rua). Whakaaturia ki te taputapu te matapihi horopaki o te model kia whakamāmā wawe ia.
Ka whakaatu a Claude Code i ngā tau horopaki whakatau Ka tatau te /v1/messages/count_tokens mō ngā model open-weight hosted. Ki tētahi id Shannon ka whakautu ia ki te 400, ā, ka whakatau a Claude Code i te rahi mā tōna ake. Kāore he mea hei whakatika. Kōwhiria tētahi model open-weight hosted mēnā e hiahia ana koe ki ngā tatau tika.
Kāore e whakaarohia tētahi whakaahua mata kua whakapiri Ka whakaae te shannon-coder-1 ki te input kuputuhi. Kōwhiria tētahi model e whakaae ana ki ngā whakaahua mō taua wā.

Kei te whārangi Keys & usage tō key me tō toenga. Keys & usage