Ngā taputapu CLI mō te tuhi code
HouWhakamahia 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/messagesPOST /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-liteshannon-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 {
"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"
}
} | 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_…_MODELe 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_tokensmō te rahi o te horopaki. Ka tatau te endpoint mō ngā model open-weight hosted. Me tētahi id Shannon ka whakautu ki te400; 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 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.
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 | 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/responsese pupuri i tētahi kōrero i te server: kei ia tono te kōrero i teinput. Ka whakaaetia teprevious_response_idmō 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 teshannon-coder-1i ngā tokens mai i tō toenga, kaua i ngā karanga Coder.
Te tirotiro ōrite mō te 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."
}' 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.
{
"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"
}
} 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.
{
"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
}
} 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:
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"} 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