使用教學
AI 程式設計工具安裝與設定指南
平台 API 位址
v1OPENAI · COMPATIBLE · ENDPOINT
$https://your-domain.com/api/nexura/v1select · tools
選擇您要使用的工具
目前僅 Claude Code 已上線,其他工具敬請期待
install · script
安裝指令碼
請在終端機中執行此指令碼
curl -s https://nexura.startupper.space/setup-claudecode.sh | bash -s -- --url https://nexura.startupper.space/api/nexura --key nxr-xxxxxxxxxxxx本指令碼會自動偵測系統環境,安裝必要的相依套件,並完成環境變數的設定。指令碼執行成功後,請重新開啟終端機,開始使用。
請在 PowerShell 中以系統管理員身分執行
& { $url="https://nexura.startupper.space/api/nexura"; $key="nxr-xxxxxxxxxxxx"; iex ([Text.Encoding]::UTF8.GetString((New-Object Net.WebClient).DownloadData('https://nexura.startupper.space/setup-claudecode.ps1'))) }本指令碼會自動偵測系統環境,安裝必要的相依套件,並完成環境變數的設定。指令碼執行成功後,請重新開啟 PowerShell,開始使用。如果提示無權限,請以系統管理員身分執行【Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force】,再重新執行指令碼。
catalog · models
可用模型列表
以下為平台目前可用的模型,在工具中使用時請填寫對應的模型識別碼(Model ID)。
reference · errors
錯誤碼參考
| 錯誤碼 | HTTP | 含義 | 常見原因 | 解決建議 |
|---|---|---|---|---|
AI0001 | 400 | 無效請求 | 請求體格式錯誤或缺少必填欄位 | 檢查請求體 JSON 格式和必填參數 |
AI0002 | 401 | 無效的 API Key | API Key 不存在或格式錯誤 | 檢查 API Key 是否正確,確認環境變數設定 |
AI0003 | 403 | API Key 已停用 | Key 被管理員停用或已撤銷 | 聯繫管理員或建立新的 API Key |
AI0004 | 403 | 額度已耗盡 | 帳戶可用額度不足 | 購買套餐或儲值額度 |
AI0005 | 429 | 請求頻率超限 | 超過 API Key 或分組的 RPM 限制 | 降低請求頻率或升級分組 |
AI0006 | 400 | 模型不存在 | 請求的模型識別碼不在平台模型列表中 | 檢查模型名稱拼寫,參考下方可用模型列表 |
AI0007 | 403 | 無權使用該模型 | 目前分組或套餐不包含該模型 | 升級套餐或聯繫管理員開通權限 |
AI0008 | 502 | 上游服務錯誤 | 供應商 API 回傳錯誤 | 稍後重試,若持續出現請聯繫管理員 |
AI0009 | 504 | 上游服務逾時 | 供應商 API 回應逾時 | 減少輸入長度或稍後重試 |
AI0010 | 503 | 無可用頻道 | 所有頻道均不可用或維護中 | 稍後重試,若持續出現請聯繫管理員 |
AI0011 | 400 | 參數校驗失敗 | 請求參數不符合要求 | 檢查參數類型和取值範圍 |
AI0012 | 413 | 內容過大 | 請求體超過大小限制 | 減少輸入內容長度 |
AI0013 | 500 | 內部服務錯誤 | 平台內部異常 | 稍後重試,若持續出現請聯繫管理員 |
AI0014 | 402 | 餘額不足 | 預扣額度時發現餘額不夠 | 儲值或購買套餐 |
AI0015 | 429 | 並發數超限 | 同時進行的請求數超過分組限制 | 等待目前請求完成後再發起新請求 |
help · faq
常見問題
執行 claude 命令提示「找不到命令」怎麼辦?
Windows 使用者請確認 PowerShell 以系統管理員身分執行安裝指令碼;macOS/Linux 使用者請重新開啟終端機或執行 source ~/.zshrc(或 ~/.bashrc)。如果使用 npm 安裝,請確認 Node.js 全域 bin 目錄在 PATH 中。
執行 codex 命令提示「找不到命令」怎麼辦?
請確認 Node.js 版本 ≥ 18(執行 node --version 檢查),並確認 npm 全域安裝目錄在系統 PATH 中。Windows 使用者可嘗試重啟 PowerShell,macOS/Linux 使用者可執行 npm config get prefix 查看全域目錄。
工具連線平台失敗怎麼辦?
請檢查:1) 環境變數 OPENAI_API_KEY 和 OPENAI_BASE_URL 是否正確設定;2) API Key 是否有效(未被撤銷);3) 網路是否能存取平台位址。可以用 curl 命令測試連通性。
如何在工具中指定使用的模型?
Claude Code 使用 --model 參數指定模型(如 claude --provider openai --model gpt-4o);Codex CLI 使用 --model 參數(如 codex --model gpt-4o)。可用模型請參考上方模型列表。
使用過程中提示額度不足怎麼辦?
進入平台「儀表板」查看剩餘額度,如已耗盡可購買套餐或使用兌換碼儲值。AI 程式設計工具消耗 Token 較多,建議選擇額度充足的套餐。
遇到限流 (429) 錯誤怎麼處理?
工具通常會自動重試。如果頻繁出現,說明請求頻率超過分組限制,建議:1) 減少並發操作;2) 升級到更高分組取得更高 RPM 限制。