CLI 코딩 도구

코딩 도구가 Shannon과 작동하려면 세 가지 설정이 필요합니다: API의 base 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을 모델 provider로 기술하고, 그곳에서 Shannon 모델 id를 선택하고, provider가 지정한 환경 변수에 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시간마다 00:00, 04:00, 08:00, 12:00, 16:00, 20:00 UTC에 다시 시작됩니다.

현재 수치는 플랜 페이지에서 확인할 수 있습니다. 플랜

한 구간의 호출 횟수를 모두 사용하면 요청에 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"}

에이전트 루프가 의존할 수 있는 것

문제 해결

키와 잔액은 Keys & usage 페이지에서 확인할 수 있습니다. Keys & usage