Ferramentas de código CLI

Unha ferramenta de programación necesita tres axustes para funcionar con Shannon: a URL base da API, a túa clave API e un id de modelo de Shannon. Esta páxina dá os axustes exactos para Claude Code e Codex CLI, explica como se conta o modelo de código shannon-coder-1 e lista os erros que atopan estas ferramentas.

Que endpoint usa cada ferramenta

Os tres endpoints aceptan a mesma clave API, como Authorization: Bearer ou como x-api-key. Acéptanse as cabeceiras anthropic-version, anthropic-beta e openai-beta que envían estas ferramentas.

Seleccionar un modelo de Shannon

Cada solicitude debe nomear un id de modelo que Shannon publique. Unha ferramenta de programación envía o nome do seu propio modelo predeterminado a menos que lle indiques outra cousa, e un nome que Shannon non publica recibe 400 e a mensaxe unknown model: <name>. Ningún outro nome se asigna a un modelo de Shannon, así que define o modelo na ferramenta antes da primeira solicitude.

GET /v1/models lista todos os ids coa súa ventá de contexto. Non necesita clave. Modelos e prezos

As ferramentas de programación guían o modelo cun system prompt longo. O system prompt aplícano shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro e os modelos open-weight alojados, así que selecciona un destes para unha ferramenta de programación.

Claude Code

Claude Code le a súa conexión de variables de contorna. Defínas no shell que o inicia, ou no bloque env de ~/.claude/settings.json para conservalas en todas as sesións.

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

• Define as tres variables ANTHROPIC_DEFAULT_…_MODEL. Os subagentes e algúns comandos piden un modelo polo seu nome integrado, e cada nome debe resolverse a un id de Shannon.
• O exemplo dirixe as solicitudes en segundo plano a shannon-1.6-lite, que se conta en tokens. Así, os títulos de sesión e solicitudes semellantes non usan chamadas de Coder.
• Claude Code pregunta a POST /v1/messages/count_tokens polo tamaño do contexto. O endpoint conta para os modelos open-weight alojados. Con un id de Shannon responde 400; Claude Code trata o reconto de tokens como opcional e estima el mesmo o tamaño. Reconto de tokens

Para comprobar o enderezo, a clave e un id de modelo antes de iniciar a ferramenta, envía unha solicitude a man:

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 comunícase coa API Responses. Describe Shannon como provedor de modelos en ~/.codex/config.toml, selecciona alí un id de modelo de Shannon e pon a túa clave API na variable de contorna que nomea o provedor.

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 non garda ningunha conversa no servidor: cada solicitude leva a conversa en input. previous_response_id acéptase por compatibilidade.
• As ferramentas de función (type: "function") ofrécense ao modelo en /v1/responses.
• En /v1/responses, shannon-coder-1 cóntase en tokens do teu saldo, non en chamadas de Coder.

A mesma comprobación para o 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."
  }'

O modelo de código e como se conta

shannon-coder-1 é o modelo de Shannon para axentes de programación. GET /v1/models infórmao cunha ventá de contexto de 131,072 tokens, chamadas a ferramentas, razoamento e entrada de texto. Cóntase de dúas maneiras, segundo o endpoint que use unha ferramenta.

Unha chamada é unha solicitude, sexa cal sexa o seu tamaño. Cóntase cando se acepta a solicitude, antes de que responda o modelo. Unha sesión de axente envía unha solicitude por cada paso que dá, así que unha tarefa longa usa moitas chamadas. A cota depende do teu plan e comeza de novo cada 4 horas, ás 00:00, 04:00, 08:00, 12:00, 16:00 e 20:00 UTC.

A páxina de planes mostra as cifras actuais. Planes

Cando se esgotan as chamadas dunha xanela, a solicitude recibe 429. En /v1/messages o mesmo erro vén coa forma de 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"
  }
}

Desbordamento de contexto

Cando unha conversa é máis grande que a ventá de contexto do modelo, /v1/chat/completions e /v1/messages responden con 400, o tipo invalid_request_error, o código context_length_exceeded e unha mensaxe que comeza por prompt is too long. As ferramentas de programación len este erro para compactar a sesión e enviar a solicitude de novo. Prodúceno shannon-coder-1, shannon-1.6-lite e 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
  }
}

A mensaxe é prompt is too long: <sent> tokens > <limit> maximum. Cando non se coñecen os dous números, é prompt is too long. Please compact the conversation and try again.

Nun stream o estado xa é 200, así que o erro chega como un evento e despois o stream péchase de forma normal:

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

En que pode confiar un bucle de axente

Resolución de problemas

A túa clave e o teu saldo están na páxina Claves e uso. Claves e uso