Tool coding CLI

Tool coding membutuhkan tiga pengaturan agar berfungsi dengan Shannon: base URL API, API key Anda, dan id model Shannon. Halaman ini memberikan pengaturan yang tepat untuk Claude Code dan Codex CLI, menjelaskan cara model coding shannon-coder-1 dihitung, dan mencantumkan error yang ditemui tool-tool ini.

Endpoint mana yang dipakai setiap tool

Ketiga endpoint menerima API key yang sama, sebagai Authorization: Bearer atau sebagai x-api-key. Header anthropic-version, anthropic-beta, dan openai-beta yang dikirim tool-tool ini diterima.

Pilih model Shannon

Setiap permintaan harus menyebutkan id model yang dipublikasikan Shannon. Tool coding mengirim nama model default-nya sendiri kecuali Anda mengatakan lain, dan nama yang tidak dipublikasikan Shannon dijawab dengan 400 dan pesan unknown model: <name>. Tidak ada nama lain yang dipetakan ke model Shannon, jadi atur model di tool sebelum permintaan pertama.

GET /v1/models mencantumkan setiap id beserta jendela konteksnya. Tidak memerlukan kunci. Model & harga

Tool coding mengarahkan model dengan system prompt yang panjang. System prompt diterapkan oleh shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro, dan model open-weight hosted, jadi pilih salah satunya untuk tool coding.

Claude Code

Claude Code membaca koneksinya dari environment variable. Atur di shell yang memulainya, atau di blok env pada ~/.claude/settings.json agar berlaku untuk setiap sesi.

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

• Atur ketiga variabel ANTHROPIC_DEFAULT_…_MODEL. Subagent dan beberapa perintah meminta model dengan nama bawaannya, dan setiap nama harus diarahkan ke id Shannon.
• Contoh mengarahkan permintaan latar belakang ke shannon-1.6-lite, yang dihitung dalam token. Judul sesi dan permintaan serupa kemudian tidak memakai panggilan Coder.
• Claude Code meminta POST /v1/messages/count_tokens untuk ukuran konteks. Endpoint ini menghitung untuk model open-weight hosted. Dengan id Shannon, endpoint menjawab 400; Claude Code menganggap penghitungan token opsional dan memperkirakan ukurannya sendiri. Penghitungan token

Untuk memeriksa alamat, kunci, dan id model sebelum Anda memulai tool, kirim satu permintaan secara manual:

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 berbicara ke Responses API. Deskripsikan Shannon sebagai model provider di ~/.codex/config.toml, pilih id model Shannon di sana, dan taruh API key Anda di environment variable yang disebut 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

• /v1/responses tidak menyimpan percakapan di server: setiap permintaan membawa percakapan di input. previous_response_id diterima demi kompatibilitas.
• Tool fungsi (type: "function") ditawarkan ke model di /v1/responses.
• Di /v1/responses, shannon-coder-1 dihitung dalam token dari saldo Anda, bukan dalam panggilan Coder.

Pemeriksaan yang sama untuk 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."
  }'

Model coding dan cara penghitungannya

shannon-coder-1 adalah model Shannon untuk agen coding. GET /v1/models melaporkannya dengan jendela konteks 131,072 token, panggilan tool, reasoning, dan input teks. Penghitungannya ada dua cara, tergantung endpoint yang dipakai tool.

Satu panggilan adalah satu permintaan, berapa pun ukurannya. Panggilan dihitung ketika permintaan diterima, sebelum model menjawab. Sesi agen mengirim satu permintaan untuk setiap langkah yang diambilnya, sehingga tugas panjang memakai banyak panggilan. Kuota bergantung pada paket Anda dan dimulai lagi setiap 4 jam, pada pukul 00:00, 04:00, 08:00, 12:00, 16:00, dan 20:00 UTC.

Halaman paket menampilkan angka terkini. Paket

Ketika panggilan dalam satu jendela habis, permintaan dijawab dengan 429. Di /v1/messages, error yang sama datang dalam bentuk 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"
  }
}

Konteks melebihi batas

Ketika percakapan lebih besar daripada jendela konteks model, /v1/chat/completions dan /v1/messages menjawab dengan 400, tipe invalid_request_error, kode context_length_exceeded, dan pesan yang diawali prompt is too long. Tool coding membaca error ini untuk meringkas sesi dan mengirim permintaan sekali lagi. Error ini dihasilkan oleh shannon-coder-1, shannon-1.6-lite, dan 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
  }
}

Pesannya adalah prompt is too long: <sent> tokens > <limit> maximum. Ketika kedua angka tidak diketahui, pesannya prompt is too long. Please compact the conversation and try again.

Pada stream, statusnya sudah 200, jadi error tiba sebagai event dan stream kemudian ditutup secara 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"}

Yang dapat diandalkan oleh loop agen

Pemecahan masalah

Kunci dan saldo Anda ada di halaman Keys & usage. Keys & usage