Ferramentas de código em CLI

Uma ferramenta de código precisa de três configurações para funcionar com a Shannon: a base URL da API, sua chave de API e um id de modelo Shannon. Esta página traz as configurações exatas para o Claude Code e o Codex CLI, explica como o modelo de código shannon-coder-1 é contado e lista os erros que essas ferramentas encontram.

Qual endpoint cada ferramenta usa

Os três endpoints aceitam a mesma chave de API, como Authorization: Bearer ou como x-api-key. Os headers anthropic-version, anthropic-beta e openai-beta que essas ferramentas enviam são aceitos.

Selecione um modelo Shannon

Toda requisição deve indicar um id de modelo que a Shannon publica. Uma ferramenta de código envia o nome do seu próprio modelo padrão, a menos que você diga o contrário, e um nome que a Shannon não publica é respondido com 400 e a mensagem unknown model: <name>. Nenhum outro nome é mapeado para um modelo Shannon, então defina o modelo na ferramenta antes da primeira requisição.

GET /v1/models lista todos os ids com a sua janela de contexto. Não exige chave. Modelos e preços

As ferramentas de código conduzem o modelo com um prompt de sistema longo. O prompt de sistema é aplicado por shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro e pelos modelos open-weight hospedados, então selecione um deles para uma ferramenta de código.

Claude Code

O Claude Code lê sua conexão de variáveis de ambiente. Defina-as no shell que o inicia, ou no bloco env de ~/.claude/settings.json para mantê-las em todas as sessões.

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

• Defina as três variáveis ANTHROPIC_DEFAULT_…_MODEL. Subagentes e alguns comandos pedem um modelo pelo nome embutido, e cada nome precisa resolver para um id Shannon.
• O exemplo aponta as requisições em segundo plano para shannon-1.6-lite, que é contado em tokens. Assim, títulos de sessão e requisições semelhantes não usam chamadas Coder.
• O Claude Code consulta POST /v1/messages/count_tokens para saber o tamanho do contexto. O endpoint conta para os modelos open-weight hospedados. Com um id Shannon, ele responde 400; o Claude Code trata a contagem de tokens como opcional e estima o tamanho por conta própria. Contagem de tokens

Para verificar o endereço, a chave e um id de modelo antes de iniciar a ferramenta, envie uma requisição manualmente:

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

O Codex CLI fala com a API Responses. Descreva a Shannon como um provedor de modelos em ~/.codex/config.toml, selecione ali um id de modelo Shannon e coloque sua chave de API na variável de ambiente que o provedor indica.

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 não guarda nenhuma conversa no servidor: cada requisição leva a conversa em input. previous_response_id é aceito por compatibilidade.
• Ferramentas de função (type: "function") são oferecidas ao modelo em /v1/responses.
• Em /v1/responses, shannon-coder-1 é contado em tokens do seu saldo, não em chamadas Coder.

A mesma verificação 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 ele é contado

shannon-coder-1 é o modelo Shannon para agentes de código. GET /v1/models o informa com uma janela de contexto de 131,072 tokens, chamadas de ferramenta, raciocínio e entrada de texto. Ele é contado de uma de duas formas, dependendo do endpoint que uma ferramenta usa.

Uma chamada é uma requisição, seja qual for o seu tamanho. Ela é contada quando a requisição é aceita, antes de o modelo responder. Uma sessão de agente envia uma requisição para cada passo que dá, então uma tarefa longa usa muitas chamadas. A cota depende do seu plano e recomeça a cada 4 horas, às 00:00, 04:00, 08:00, 12:00, 16:00 e 20:00 UTC.

A página de planos mostra os números atuais. Planos

Quando as chamadas de uma janela se esgotam, a requisição é respondida com 429. Em /v1/messages, o mesmo erro vem no formato da 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"
  }
}

Estouro de contexto

Quando uma conversa é maior que a janela de contexto do modelo, /v1/chat/completions e /v1/messages respondem com 400, o tipo invalid_request_error, o código context_length_exceeded e uma mensagem que começa com prompt is too long. As ferramentas de código leem esse erro para compactar a sessão e enviar a requisição de novo. Ele é produzido por 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 mensagem é prompt is too long: <sent> tokens > <limit> maximum. Quando os dois números não são conhecidos, é prompt is too long. Please compact the conversation and try again.

Em um stream, o status já é 200, então o erro chega como um evento e o stream então se fecha normalmente:

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

No que um loop de agente pode confiar

Solução de problemas

Sua chave e seu saldo estão na página Chaves e uso. Chaves e uso