繁中 ▾
取得 API 金鑰

Codex VS Code API 金鑰:使用自訂端點

正在尋找 codex vscode api key 設定方法?關鍵在於三個值:金鑰、基礎 URL 與模型 ID。以下說明如何將這些值填入 Codex 擴充功能、Continue 及其他接受 OpenAI 相容端點的 VS Code 程式碼工具中。

更新於

程式碼編輯器視窗透過發光的金鑰與電纜連接至伺服器機櫃,說明 VS Code API 金鑰設定
發光的電纜連接筆記型電腦與伺服器機櫃,說明將客戶端指向 API 基礎 URL

重點摘要

  • 基礎 URL:https://api.getcodexapi.com/v1. 模型 ID:uncensored。驗證:您的金鑰作為 Bearer token。
  • Codex 會讀取設定檔以設定自訂提供者;其他擴充功能則在設定中有基礎 URL 欄位。
  • 請檢查各擴充功能的最新文件,因為設定名稱會隨版本變更。
  • 這是一般用途的 uncensored 文字模型,並非 OpenAI 產品,因此在依賴其輸出前,請先在您自己的程式碼上進行測試。

你正在設定的內容

VS Code 中的程式碼助手會透過 HTTP 與模型通訊。大多數助手採用 OpenAI API 格式,這表示它們接受自訂基礎 URL 和金鑰,而非供應商預設值。此服務與 OpenAI 相容,因此可插入任何提供該選項的工具。

清楚了解另一端的情況。這是一個由獨立供應商營運的開放權重模型,針對合法成人用途調整為無內容審查。它不是 OpenAI 的 Codex 模型,也不是其他供應商官方的 API。僅支援文字,具備 100,000 token 上下文視窗、函式呼叫與 JSON 模式。若需 OpenAI 風格路由的詳細資訊,請閱讀 文件;若只需地址,請參閱 Codex API 基礎 URL頁面。

以下是所有地方都需要使用的三個值:

設定說明
Base URLhttps://api.getcodexapi.com/v1
模型uncensored
標頭Authorization: Bearer YOUR_KEY

取得金鑰並先進行測試

在 API 金鑰頁面使用 Google 或電子郵件與密碼建立帳戶。新用戶可一鍵領取 $0.50 的試用額度,有效期 7 天,無需信用卡。接著在終端機中測試金鑰,再開始設定 VS Code。成功的 curl 呼叫可證明金鑰與 URL 有效,此後若出現錯誤,表示問題出在擴充功能。

# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"

# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'

回覆為 chat completions JSON,回應會附上 X-Balance-USD標頭,顯示你的剩餘額度。將金鑰保留在環境變數或擴充功能的機密儲存區中,不要放在程式碼庫裡。

Codex 擴充功能與 CLI:設定檔

OpenAI 的 Codex 工具透過主目錄中的 TOML 設定檔支援自訂模型提供者,且文件指出 VS Code 擴充功能會與 CLI 共用該設定。請根據您的版本查閱最新的 Codex 文件進行確認,因為格式已有所變更。

# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"

[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"

檢查重點:

  • base_url 以 /v1 結尾,不含 /chat/completions。
  • env_key 是環境變數的名稱,而非金鑰本身。
  • wire_api 用於選擇請求格式。此服務同時接受 POST /v1/chat/completions 與 POST /v1/responses。請先嘗試 "chat";若您的 Codex 版本需要,則使用 "responses"。
  • 從已設定變數的殼層啟動 VS Code,或在將變數加入設定檔後重新啟動。macOS 上的圖形介面啟動通常無法讀取殼層匯出的變數。

Agent 樣式的工具依賴工具呼叫。這裡支援此功能,包括串流輸出的工具呼叫,但品質因模型而異,因此建議先執行小型任務測試。在 Cursor 中使用 API相關頁面涵蓋了另一個編輯器的類似設定。

Continue、Cline 及其他擴充功能

第三方擴充功能各有其設定畫面,但模式一致:選擇 OpenAI 或「OpenAI 相容」提供者,然後填入基礎 URL、金鑰與模型。Continue 使用 YAML 設定:

# Continue (config.yaml), model entry
models:
  - name: Hosted uncensored
    provider: openai
    model: uncensored
    apiBase: https://api.getcodexapi.com/v1
    apiKey: YOUR_KEY

Cline 與 Roo Code 在設定面板中提供「OpenAI Compatible」提供者,包含相同的三個欄位。名稱與選單經常變更,請在擴充功能自身的文件中搜尋 "OpenAI compatible" 或 "custom base URL"。若擴充功能沒有基礎 URL 欄位,則無法使用此端點。

節省時間的技巧:

  • 除非希望每次暫停都發送請求,否則請針對託管模型停用分頁自動完成。聊天與編輯動作成本較低。
  • 在擴充功能中設定較小的上下文視窗用於日常編輯。將整個程式庫傳送給模型會每次消耗輸入 token。
  • 為每個工具使用獨立的金鑰,以便追蹤哪個工具使用了您的額度。

哪些編輯器任務適合此模型

具有大型上下文視窗的通用文字模型適合幾項日常任務:解釋不熟悉的程式碼、為函式撰寫單元測試、在不同語言之間轉換腳本、撰寫文件註解與正則表達式,以及在貼上整個檔案時重寫模組。100,000 token 的上下文視窗意味著幾個中型檔案加上你的提示詞可以放在一個請求中,而完成結果可以使用剩餘的任何 token 容量。

對其餘部分保持務實。這不是經過編輯器感知訓練的專門程式碼模型,因此大型多檔案 Agent 執行可能需要比針對它們設計的更多指導與檢查。要求提供差異(diffs)而非整個檔案,在接受每個變更前進行審查,並執行測試。如果任務需要過濾助手拒絕的內容,例如撰寫成熟小說的架構或用於合法用途的安全研究文字,使用這個無審查模型的端點是原因。

編輯器的費用

價格為每 1M 輸入 token $0.15,每 1M 輸出 token $0.50。程式碼工具會發送大量上下文,因此請先關注輸入部分。

範例:包含 8,000 token 檔案上下文與 600 token 回答的編輯請求,成本為 8,000 x $0.15 / 1M + 600 x $0.50 / 1M = $0.0012 + $0.0003 = $0.0015。一天 150 次此類請求的成本為 150 x $0.0015 = $0.225。二十個工作天:$4.50。

讀取多個檔案的 Agent 每個步驟可發送 40,000 token。在該大小下,一個步驟的成本為 $0.006 加上輸出,因此 100 個步驟的成本約為 $0.60 加上輸出。請留意 Agent 迴圈。失敗或被拒絕的請求不會收費,且額度永不過期。$20 至 $500 的儲值可使用信用卡(Visa、Mastercard、Apple Pay、Google Pay)或加密貨幣支付。目前方案列於定價頁面。

故障排除

401 未授權

金鑰遺失、含有意外空格,或環境變數對 VS Code 不可見。請從已設定變數的終端機重新啟動編輯器。

404 或「找不到模型」

使用確切的模型 uncensored 以及包含 /v1 結尾的基礎 URL。

429 錯誤

完整金鑰允許 8 個並行請求與每分鐘 300 次請求;試用金鑰允許 2 個與每分鐘 60 次。同時觸發多個並行請求的擴充功能(如自動完成與聊天)可能會達到並行限制。錯誤代碼為 concurrency(同時過多)與 rate_limited(每分鐘限制)。Retry-After: 5 標頭表示暫時過載。

串流輸出停滯

某些企業代理伺服器會緩衝伺服器發送的事件。請在不同網路下測試,或在擴充功能中關閉串流輸出。

回答與您在其他助手看到的結果不同

這是預期的。這是具有不同優勢的模型。請提供清晰、具體的指示詞,並在您專案的程式碼上進行測試。

問答

這與 OpenAI Codex API 金鑰相同嗎?

不相同。這是用於不同服務的金鑰,該服務提供 OpenAI 相容的 API 與單一模型 uncensored。僅適用於允許設定自訂基礎 URL 的工具。

我應該輸入哪個基礎 URL?

https://api.getcodexapi.com/v1. 不要附加 /chat/completions。

我可以不用付費就試試看嗎?

是的。新用戶在註冊後可一鍵領取 $0.50 的試用額度。有效期為 7 天,且無需信用卡。

我使用的 VS Code 擴充功能支援自訂端點嗎?

請檢查其設定與文件,確認是否提供基礎 URL 或 OpenAI 相容選項。若無,則無法連接到此服務。

只差一個步驟,即可取得金鑰

建立帳號、複製金鑰、更改基礎 URL。這就是整個設定過程。

取得 API 金鑰