CLI コーディングツール

コーディングツールを Shannon で動かすには、三つの設定が必要です。API のベース URL、API キー、Shannon のモデル ID です。このページでは、Claude Code と Codex CLI の具体的な設定を示し、コーディングモデル shannon-coder-1 の計上方法を説明し、これらのツールで発生するエラーを一覧にしています。

ツールごとに使うエンドポイント

三つのエンドポイントはすべて、同じ API キーを Authorization: Bearer または x-api-key で受け付けます。これらのツールが送信する anthropic-version、anthropic-beta、openai-beta ヘッダーも受け付けられます。

Shannon モデルを選択する

すべてのリクエストで、Shannon が公開しているモデル ID を指定する必要があります。コーディングツールは、指示しない限り自身のデフォルトモデルの名前を送信し、Shannon が公開していない名前には 400 とメッセージ unknown model: <name> が返されます。他の名前が Shannon のモデルに対応付けられることはないため、最初のリクエストの前にツールでモデルを設定してください。

GET /v1/models は、すべての ID をコンテキストウィンドウとともに一覧表示します。キーは不要です。 モデルと料金

コーディングツールは、長いシステムプロンプトでモデルを制御します。システムプロンプトは shannon-coder-1、shannon-1.6-lite、shannon-1.6-pro、shannon-2-lite、shannon-2-pro、ホスト型オープンウェイトモデルで適用されるため、コーディングツールにはこれらのいずれかを選択してください。

Claude Code

Claude Code は、接続設定を環境変数から読み取ります。起動するシェルで設定するか、すべてのセッションで保持するには ~/.claude/settings.json の env ブロックに設定します。

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

• 三つの ANTHROPIC_DEFAULT_…_MODEL 変数をすべて設定してください。サブエージェントや一部のコマンドは組み込みの名前でモデルを要求するため、どの名前も Shannon の ID に解決される必要があります。
• このサンプルは、バックグラウンドリクエストをトークンで計上される shannon-1.6-lite に向けています。そのため、セッションタイトルなどのリクエストで Coder 呼び出しは消費されません。
• Claude Code は、コンテキストのサイズを POST /v1/messages/count_tokens に問い合わせます。このエンドポイントはホスト型オープンウェイトモデルで数えます。Shannon の ID では 400 を返しますが、Claude Code はトークンカウントを任意のものとして扱い、サイズを自分で見積もります。 トークンカウント

ツールを起動する前に、アドレス、キー、モデル ID を確認するには、手動でリクエストをひとつ送信します。

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 は Responses API と通信します。~/.codex/config.toml で Shannon をモデルプロバイダーとして記述し、そこで Shannon のモデル ID を選択して、プロバイダーが指定する環境変数に API キーを設定します。

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 はサーバー側に会話を保持しません。各リクエストは input に会話を含めます。previous_response_id は互換性のために受け付けられます。
• 関数ツール（type: "function"）は、/v1/responses でモデルに提示されます。
• /v1/responses では、shannon-coder-1 は Coder 呼び出しではなく、残高からトークンで計上されます。

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

コーディングモデルと計上方法

shannon-coder-1 は、コーディングエージェント向けの Shannon モデルです。GET /v1/models は、131,072 トークンのコンテキストウィンドウ、ツール呼び出し、推論、テキスト入力に対応するモデルとして報告します。ツールが使うエンドポイントに応じて、二通りの方法のどちらかで計上されます。

一回の呼び出しは、サイズに関係なく一件のリクエストです。リクエストが受け付けられた時点、モデルが応答する前に計上されます。エージェントセッションは、一ステップごとにリクエストを送信するため、長いタスクでは多くの呼び出しが使われます。枠の量はプランによって異なり、4 時間ごと、UTC の 00:00、04:00、08:00、12:00、16:00、20:00 にリセットされます。

現在の数値はプランのページで確認できます。 プラン

枠の呼び出し回数を使い切ると、リクエストには 429 が返されます。/v1/messages では、同じエラーが 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"
  }
}

コンテキストの超過

会話がモデルのコンテキストウィンドウより大きい場合、/v1/chat/completions と /v1/messages は、400、タイプ invalid_request_error、コード context_length_exceeded、prompt is too long で始まるメッセージで応答します。コーディングツールはこのエラーを読み取って、セッションを圧縮し、リクエストを再送信します。このエラーを返すのは shannon-coder-1、shannon-1.6-lite、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
  }
}

メッセージは prompt is too long: <sent> tokens > <limit> maximum です。二つの数値が分からない場合は prompt is too long. Please compact the conversation and try again. になります。

ストリームでは、ステータスはすでに 200 なので、エラーはイベントとして届き、その後ストリームは通常どおり閉じられます。

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

エージェントループが前提にできること

トラブルシューティング

キーと残高は、キーと使用量のページで確認できます。 キーと使用量