快速開始
使用文件
通過環境變數配置 API 地址和密鑰，無需改動程式碼即可接入 Nodebyt。
API 端點
Anthropic SDK（Claude Code 等）
bash
ANTHROPIC_BASE_URL=https://api.nodebyt.comOpenAI SDK / HTTP
bash
base_url=https://api.nodebyt.com/v1Windows 配置
僅當前終端視窗有效，關閉後失效。適合臨時測試。
powershell
# PowerShell (valid for current session only)
$env:ANTHROPIC_BASE_URL = "https://api.nodebyt.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-api-key"macOS / Linux 配置
僅當前終端視窗有效，關閉後失效。適合臨時測試。
bash
# bash / zsh (valid for current session only)
export ANTHROPIC_BASE_URL="https://api.nodebyt.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"Claude Code CLI
Anthropic 官方命令列工具，透過環境變數連線 Nodebyt，無需改動程式碼。
前往「API Key 管理」頁面一鍵下載配置腳本 →或手動設置環境變數：
bash
# bash / zsh (valid for current session only)
export ANTHROPIC_BASE_URL="https://api.nodebyt.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"設定完成後啟動：
bash
claudeCodex CLI
OpenAI 官方 Codex 命令列工具，走 /v1/responses 介面。注意 base_url 必須包含 /v1。
前往「API Key 管理」頁面一鍵下載配置腳本 →編輯 ~/.codex/config.toml：
toml
model_provider = "nodebyt"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.nodebyt]
name = "nodebyt"
base_url = "https://api.nodebyt.com/v1"
wire_api = "responses"
env_key = "NODEBYT_API_KEY"然後將 API Key 設置到環境變數：
bash
# bash / zsh
export NODEBYT_API_KEY="sk-your-api-key"設定完成後啟動：
bash
codex調用示例
使用 Anthropic 官方 SDK，通過環境變數自動讀取 base_url 和 api_key。
python
from anthropic import Anthropic
# Automatically reads ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN from env
client = Anthropic()
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content[0].text)安裝：pip install anthropic
串流回應
請求體加入 stream: true 即可啟用 SSE 串流輸出，適合聊天介面即時渲染。
python
from anthropic import Anthropic
client = Anthropic()
with client.messages.stream(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[{"role": "user", "content": "Write a haiku about Go."}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)錯誤處理
/v1/* 路徑遵循 OpenAI 錯誤格式，錯誤 JSON 包含 type / code / message。
json
{
"error": {
"type": "invalid_request_error",
"code": "insufficient_quota",
"message": "余额不足"
}
}常見錯誤碼
| HTTP | Message |
|---|---|
401 | API Key 無效或未提供 |
402 | 餘額不足，請前往充值 |
429 | 觸發限流或每日配額耗盡 |
503 | 上游渠道全部不可用（熔斷中） |