NeCodeX API 設定教學

第一步、準備 API Key

1. 打開後台：

2. 登入賬號。

3. 進入“令牌管理”或“API Key”頁面。

4. 新建一個 API Key。

5. 複製完整 Key，先保存到記事本。

檢查 Key

Key 不能只複製一半。

Key 前後不能有空格。

Key 中間不能換行。

如果提示 401，優先重新複製 Key。

如果提示餘額不足或模型無權限，聯繫賣家處理，不要反覆重裝軟體。

第二步、安裝基礎環境

Windows

1. 打開 Node.js 官網。

2. 下載 LTS 版本。

3. 正常下一步安裝。

4. 安裝完成後，關閉所有 PowerShell / CMD 窗口。

5. 重新打開 PowerShell。

6. 輸入下面兩行檢查：

node -v
npm -v

能顯示版本號，就說明環境正常。

macOS

1. 打開 Node.js 官網。

2. 下載 macOS LTS 安裝包。

3. 正常安裝。

4. 打開 Terminal。

5. 輸入下面兩行檢查：

node -v
npm -v

Linux / Ubuntu / Debian

1. 打開 Terminal。

2. 安裝 Node.js 和 npm。

sudo apt update
sudo apt install -y nodejs npm

3. 輸入下面兩行檢查：

node -v
npm -v

Windows 注意

不要用管理員窗口。

不要在 C:\Windows\System32 裡面操作。

建議先在桌面新建一個文件夾，例如 codex-workspace。

打開文件夾後，在地址欄輸入 powershell，再回車。

第三步、地址規則

OpenAI 相容地址

Claude Code 地址

圖片介面完整地址

判斷規則

Codex、OpenCode、Cherry、OpenClaw、OpenAI 相容插件，地址一般填帶 /v1 的地址。

Claude Code 填根地址，不帶 /v1。

圖片介面 BASE_URL 用根地址，請求路徑用 /v1/images/generations。

Sora2 模型名填 sora2；Claude Code 預設用 claude-opus-4-7。

第四步、Codex CLI / Codex App / VS Code / Cursor / Trae

適用情況

使用 Codex CLI。

使用 Codex App。

稻版windows使用者用以下連結一鍵安裝

或使用一鍵設定腳本

VS Code / Cursor / Trae 裡裝的是 Codex 相關插件。

4.1 安裝 Codex

Windows / Linux：

npm install -g @openai/codex
codex --version

macOS

npm install -g @openai/codex
codex --version

如果 macOS 已安裝 Homebrew，也可以用：

brew install --cask codex
codex --version

能顯示版本號，再繼續下一步。

4.2 打開 Codex 設定檔

Windows PowerShell 輸入：

mkdir "$env:USERPROFILE\.codex" -Force
notepad "$env:USERPROFILE\.codex\config.toml"

macOS / Linux Terminal 輸入：

mkdir -p ~/.codex
nano ~/.codex/config.toml

4.3 複製下面內容到 config.toml

把 “這裡換成你的APIKey” 換成後台複製的完整 Key。

model = "gpt-5.4"
model_provider = "necodex"
model_reasoning_effort = "high"
approval_policy = "on-request"
sandbox_mode = "danger-full-access"
disable_response_storage = true
[model_providers.necodex]
name = "NeCodeX API"
base_url = "https://fast.sbbbbbbbbb.xyz/v1"
experimental_bearer_token = "這裡換成你的APIKey"
wire_api = "responses"
supports_websockets = false

4.4 保存文件

Windows 記事本：點保存，然後關閉。

macOS / Linux nano：按 Ctrl + O，回車保存；再按 Ctrl + X 退出。

4.5 啟動測試

進入項目文件夾，再輸入：

codex

看到輸入框後，發送：

4.6 VS Code / Cursor / Trae

如果用的是 Codex 插件：

1. 先按上面的 Codex 設定完成。

2. 完全退出 VS Code / Cursor / Trae。

3. 重新打開軟體。

4. 打開項目文件夾後再測試。

如果用的是普通 OpenAI 相容插件，不看這一節，直接看“Cherry / OpenClaw / 通用軟體”那一節。

第五步、Claude Code

可以使用腳本一鍵設定

適用情況

使用 Claude Code 命令行。

使用 Claude Code 的 VS Code 插件。

使用 Claude Code 桌面端並需要本地設定。

5.1 安裝 Claude Code

Windows PowerShell 推薦：

winget install Anthropic.ClaudeCode
claude --version

macOS 如果已安裝 Homebrew：

brew install --cask claude-code
claude --version

Windows / macOS / Linux 都可以使用 npm 安裝：

npm install -g @anthropic-ai/claude-code
claude --version

能顯示版本號，再繼續下一步。

5.2 打開 Claude Code 設定檔

Windows PowerShell 輸入：

mkdir "$env:USERPROFILE\.claude" -Force
notepad "$env:USERPROFILE\.claude\settings.json"

macOS / Linux Terminal 輸入：

mkdir -p ~/.claude
nano ~/.claude/settings.json

5.3 複製下面內容到 settings.json

把 “這裡換成你的APIKey” 換成後台複製的完整 Key。

{
"effortLevel": "high",
"env": {
"ANTHROPIC_AUTH_TOKEN": "這裡換成你的APIKey",
"ANTHROPIC_BASE_URL": "https://fast.sbbbbbbbbb.xyz",
"ANTHROPIC_MODEL": "claude-opus-4-7",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-7",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4-7",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
}
}

5.4 保存文件

Windows 記事本：點保存，然後關閉。

macOS / Linux nano：按 Ctrl + O，回車保存；再按 Ctrl + X 退出。

5.5 啟動測試

進入項目文件夾，再輸入：

claude

看到輸入框後，發送：

注意：Claude Code 地址不要寫 /v1。

第六步、OpenCode

可以使用腳本一鍵設定

適用情況

使用 OpenCode 命令行。

6.1 安裝 OpenCode

Windows / macOS / Linux 都可以輸入：

npm install -g opencode-ai
opencode --version

能顯示版本號，再繼續下一步。

6.2 打開 OpenCode 設定檔

Windows PowerShell 輸入：

mkdir "$env:USERPROFILE\.config\opencode" -Force
notepad "$env:USERPROFILE\.config\opencode\opencode.json"

macOS / Linux Terminal 輸入：

mkdir -p ~/.config/opencode
nano ~/.config/opencode/opencode.json

6.3 複製下面內容到 opencode.json

把 “這裡換成你的APIKey” 換成後台複製的完整 Key。

{
"$schema": "https://opencode.ai/config.json",
"model": "necodex/gpt-5.4",
"small_model": "necodex/gpt-5.4",
"provider": {
"necodex": {
"npm": "@ai-sdk/openai",
"name": "NeCodeX API",
"options": {
"baseURL": "https://fast.sbbbbbbbbb.xyz/v1",
"apiKey": "這裡換成你的APIKey"
},
"models": {
"gpt-5.4": { "name": "gpt-5.4" },
"gpt-5.5": { "name": "gpt-5.5" },
"claude-opus-4-6": { "name": "claude-opus-4-6" },
"claude-opus-4-7": { "name": "claude-opus-4-7" },
"sora2": { "name": "sora2" }
}
}
}
}

6.4 啟動測試

進入項目文件夾，再輸入：

opencode

看到輸入框後，發送：

第七步、Cherry / OpenClaw / 其它 OpenAI 相容軟體

可以使用腳本一鍵設定

適用情況

軟體界面裡有“OpenAI 相容”、“OpenAI Compatible”、“自定義模型”、“自定義 API 地址”這類入口。

Cherry、OpenClaw、部分 VS Code / Cursor / Trae 插件都可以按這一節填寫。

填寫方式

1. 打開軟體設置。

2. 找到模型服務商、Provider、API 或 Model 設置。

3. 新增一個服務商。

4. 類型選擇 OpenAI Compatible 或 OpenAI 相容。

6. API 地址 / Base URL 填寫：

7. API Key 填寫後台複製的完整 Key。

8. 模型填寫：

9. 如果軟體要求再填一個備用模型，可以填：

可選 Claude 模型：

可選視頻模型：

10. 保存後，完全退出軟體，再重新打開。

11. 發送一句測試：

OpenClaw 注意

不同版本菜單名字可能不一樣。只要能找到 OpenAI Compatible / Base URL / API Key / Model，就按上面的字段填寫。不要手動編寫陌生字段。

第八步、GPT Image / Sora2 API

適用情況

接入圖片生成介面。

使用 Sora2 生成模型。

自己的軟體或介面工具支持填寫 HTTP 請求。

可用生成模型

圖片模型：gpt-image-2

視頻模型：sora2

圖片介面完整請求地址：

POST https://fast.sbbbbbbbbb.xyz/v1/images/generations

請求頭

Authorization: Bearer 你的APIKey
Content-Type: application/json

請求體示例

{
"model": "gpt-image-2",
"prompt": "一隻白貓，乾淨背景，寫實風格",
"size": "1024x1024"
}

如果軟體分開填寫 BASE_URL 和路徑：

BASE_URL 填：https://fast.sbbbbbbbbb.xyz

路徑填：/v1/images/generations

Sora2 注意

模型名填寫：sora2

如果軟體單獨區分圖片/視頻入口，選擇視頻生成入口後再填寫 sora2。

第九步、成功判斷

設定成功後，應該滿足下面兩點：

1. 軟體能正常回復“連接成功”。

2. 後台調用記錄裡出現新的調用。

如果軟體回覆了，但後台沒有記錄，說明它可能還在走別的賬號或別的介面。

如果後台有記錄，但軟體報錯，把後台調用記錄截圖發給賣家。

第十步、常見問題

後台 / 網站地址：

401 Unauthorized

API Key 錯、複製少了、前後有空格，或軟體還在使用舊 Key。重新複製完整 Key，再保存設定。

403 Insufficient account balance

餘額不足或模型權限未開。聯繫賣家處理，不要重裝軟體。

404 Not Found

405 Method Not Allowed / wss://.../v1/responses

Codex 走了 WebSocket。按 Codex 那節檢查 config.toml，確認有 supports_websockets = false。

Reconnecting / Timeout

網絡、代理、服務端響應慢都有可能。先換網絡，再重啟軟體測試。

missing YAML frontmatter / invalid SKILL.md

這是本機舊 Skill 文件格式不對，不是 API Key 問題。找到報錯裡顯示的 skill 文件夾，可以刪除那個不用的 skill 文件夾，或暫時忽略。

C:\Windows\System32

說明從系統目錄啟動了終端。關閉窗口，在桌面新建項目文件夾，從項目文件夾地址欄輸入 powershell 後再操作。

點擊軟體閃退：

不要反覆雙擊。打開終端輸入對應命令查看錯誤：Codex 輸入 codex，Claude Code 輸入 claude，OpenCode 輸入 opencode。把終端最後一屏截圖發給賣家。

第十一步、重新設定或恢復

如果設定亂了，按下面方式處理。

Codex

打開下面文件，重新複製 Codex 那節的 config.toml 內容。

Claude Code

打開下面文件，重新複製 Claude Code 那節的 settings.json 內容。

OpenCode

打開下面文件，重新複製 OpenCode 那節的 opencode.json 內容。