User guide

快速開始使用 Nocory LLM Gateway

這份指南說明如何查看 credit、測試 API Key，以及把 Claude Code 指向 Nocory Gateway。文件中的 API Key 一律以 xxx 表示，實際操作時請換成你的完整 key。

Open Customer PortalTest API Key

1. 你會收到什麼

Nocory 團隊會提供 Customer Portal 登入 email、password，以及 API Key。

API Key 範例格式xxx

請不要把真實 API Key 貼到公開文件、GitHub、Notion、Slack 公開頻道、截圖或任何不需要知道的人可以看到的地方。

2. 查看額度與使用紀錄

打開 Customer Portal，使用 Nocory 提供的 email 和 password 登入。

https://llm-gateway.nocory.ai/customer/login
  • 查看目前剩餘 credit、已使用 credit 和充值總額。
  • 查看可使用模型、每個模型的價格和 API 使用紀錄。
  • 查看充值紀錄、扣款紀錄和 request id。

3. 測試 API Key

以下範例中的 xxx 都要換成你的完整 API Key。

測試服務是否正常

curl https://llm-gateway.nocory.ai/healthz

查看可用模型

curl https://llm-gateway.nocory.ai/v1/models \
  -H "Authorization: Bearer xxx"

呼叫模型

curl -X POST https://llm-gateway.nocory.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer xxx" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "user", "content": "Hello, please reply with one short sentence."}
    ]
  }'

4. 設定 Claude Code

在 terminal 執行以下設定，讓 Claude Code 透過 Nocory LLM Gateway 使用 gpt-5.5。

export ANTHROPIC_BASE_URL=https://llm-gateway.nocory.ai
export ANTHROPIC_AUTH_TOKEN=xxx
export ANTHROPIC_MODEL=gpt-5.5
export ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5.5
export ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.5
export CLAUDE_CODE_SUBAGENT_MODEL=gpt-5.5
claude

這組設定也會把 Claude Code 內部的 alias 與 subagent 固定導向同一個 Nocory 模型。

進入 Claude Code 後輸入 /status，確認 base URL 是否為 https://llm-gateway.nocory.ai。

目前相容層支援文字對話、工具呼叫、工具結果回傳、streaming，以及 Claude Code 預設的 thinking payload。Image 與 document blocks 目前不支援，送出時會直接回錯誤。

恢復原本設定

unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_API_KEY
unset ANTHROPIC_MODEL
unset ANTHROPIC_DEFAULT_SONNET_MODEL
unset ANTHROPIC_DEFAULT_OPUS_MODEL
unset ANTHROPIC_DEFAULT_HAIKU_MODEL
unset CLAUDE_CODE_SUBAGENT_MODEL
unset ANTHROPIC_CUSTOM_MODEL_OPTION
unset ANTHROPIC_CUSTOM_MODEL_OPTION_NAME
unset ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION

5. 常見錯誤

invalid customer api key
API Key 錯誤或沒有複製完整。請確認 header 使用 Authorization: Bearer xxx，並把 xxx 換成你的完整 key。
model is not enabled for this customer
你的帳號尚未開通該模型。請聯絡 Nocory 團隊開通或改用已開通模型。
customer balance is below the configured threshold
Credit 不足。請聯絡 Nocory 團隊充值。
404 或連不到服務
請確認 URL 是否為 https://llm-gateway.nocory.ai，並先用 /healthz 測試服務是否正常。

6. 安全提醒

  • API Key 等同於使用憑證，請妥善保管。
  • 不要把 API Key commit 到 GitHub。
  • 不要把 API Key 貼到公開文件或公開頻道。
  • 不要在截圖中露出完整 API Key。
  • 如果懷疑 API Key 外洩，請立刻聯絡 Nocory 團隊重新產生 key。

7. 需要協助時請提供什麼

  • Customer email。
  • 使用的模型，例如 gpt-5.5。
  • 錯誤訊息截圖或文字。
  • 大約發生時間。
  • Request id，如果 Customer Portal 有顯示。

請不要提供完整 API Key。若需要辨識 key，最多只提供遮蔽格式 xxx...xxx。