本文把 Codex 官方的配置文檔、xAI 官方 API 文檔和 Cursor 官方文檔拼在一起整理,資料核對於 2026-10-25。官方沒有專門的「Grok 接入 Codex」頁面,配置字段以 Codex 官方文檔為準,本站沒有逐項運行驗證。價格為「2026-10 查詢」。圖為本站整理的示意圖。
適用於誰
- 搜「grok怎麼接入codex」「grok cursor」的人;
- 想在 Codex 裏換成 Grok 模型的開發者;
- 已經訂閱 Grok、想知道 Cursor 是不是一起送的人。
結論先說
- Codex 可以接 Grok,走 xAI API Key。Codex 官方支持「自定義模型提供方」:在
config.toml裏寫一個提供方,指定base_url、讀密鑰的環境變量env_key,以及通信協議wire_api。xAI 官方的接口地址是https://api.x.ai/v1,主力模型grok-4.7支持 Responses 接口,所以字段可以對上。 - 這條路按 API 計費。xAI 定價頁的 FAQ 說,API 用量按標準價另行計費,不佔訂閱的周用量池。API Key 怎麼拿、價格多少,見 /guides/grok-api-pricing-api-key。
- Cursor 是 Grok 訂閱自帶的。官方說,新的合併訂閱 The X Subscription 把 Grok、Cursor、X 放在一起,Plus 起就包含 Cursor,Cursor 裏的 Grok 模型(Grok 4.7、4.6、4.5 和 Composer 2.5)從訂閱的共享周用量池裏扣。訂閱價格和檔位見 /guides/grok-how-to-subscribe-download,要開通可看 /chongzhi/grok-super。
- 要在 Cursor 裏用 Claude、GPT 這類第三方模型:官方說不包含在訂閱裏,Premium 起可以按 API 標價用,從預付餘額里扣。

圖:本站根據 docs.x.ai 訂閱文檔 與 Cursor 官方文檔 整理的示意圖
一、Codex 接入 Grok

圖:本站根據 Codex 配置文檔 與 xAI Quickstart 整理的示意圖
1. 先拿 xAI API Key
在 console.x.ai 註冊、充值,到 API Keys 頁面創建,再把它放進環境變量(官方示例的名字是 XAI_API_KEY)。注意官方寫明 API 充值不可退款。
2. 修改用戶級 config.toml
Codex 官方文檔的要求:
- 自定義提供方不能佔用內置的 id(
openai、ollama、lmstudio),自己起個名字,比如xai; - 提供方設定要寫在用戶級的
~/.codex/config.toml,項目裏的.codex/config.toml不能覆蓋model_provider和model_providers; - 讀密鑰推薦用
env_key,直接寫令牌的experimental_bearer_token官方標為不推薦。
按這些字段,配置大致是這樣(模型名與地址來自 xAI 官方文檔,寫法來自 Codex 官方示例):
toml
model = "grok-4.7"
model_provider = "xai"
[model_providers.xai]
name = "xAI"
base_url = "https://api.x.ai/v1"
env_key = "XAI_API_KEY"
wire_api = "responses"
字段含義:
| 字段 | 作用 |
|---|---|
model | 要用的模型名,xAI 官方文檔寫的是 grok-4.7 |
model_provider | 使用哪個提供方,對應 [model_providers.<id>] 的 id |
base_url | xAI API 地址 https://api.x.ai/v1 |
env_key | 存放 API Key 的環境變量名 |
wire_api | 通信協議,Codex 官方參考裏的取值是 responses |
3. 啟動並核對
重新啟動 Codex,看模型顯示是不是 grok-4.7,再發一條簡單消息確認能正常回復。如果報鑑權錯誤,先確認環境變量在啟動 Codex 的那個終端裏確實存在;報模型找不到,核對模型名拼寫與你帳號可用的模型(控制台的 Models 頁面能看)。
幾個提醒
- 別把 Key 寫進倉庫:用
env_key讀環境變量就是為了這個; - 模型能力以官方為準:官方說 grok-4.7 上下文 500k,推理強度可配置(low、medium、high、xhigh),具體在 Codex 裏怎麼選,取決於 Codex 當前版本對自定義提供方的支持,字段可能隨版本變化;
- 費用:grok-4.7 每百萬 tokens 輸入 2 美元、緩存輸入 0.5 美元、輸出 6 美元,提示詞達到 200k 以上整條請求按 4 / 1 / 12 美元計(2026-10 查詢);
- 想用 Codex 官方模型:需要 ChatGPT 套餐,見 /chongzhi/chatgpt-plus。DeepSeek 接入 Codex 的寫法見 /guides/deepseek-codex-setup,兩篇思路相同,只是地址和密鑰不同。
二、Cursor:訂閱裏自帶,也可以單獨看用量
官方 X Subscription 文檔的要點:
- Grok 和 Cursor 共享一個每週的包含用量池,用 Cursor 自家模型(含 Grok)的用量從這裏扣;
- 第三方模型(Claude、GPT 等)不在池裏,按 API 標價從預付餘額扣;
- 訂閱是在 grok.com/dashboard 統一管理;
- Cursor 官方文檔給的 Plus 說明:Agent 用 Cursor 自家模型,設定固定(Fast 關閉、effort 為 medium、Grok 4.7 用 256k 上下文),不含 Auto、雲端智能體、Bugbot 和第三方模型,也不能用自己的 API Key;Premium 起加上雲端智能體、第三方模型等。
所以想在 Cursor 裏用 Grok:不需要額外申請接入,訂閱後用同一個帳號登入即可;想要更多用量,就是升檔或買額外額度,見 /guides/grok-usage-limit-weekly-pool-why。
三、怎麼選
| 你的情況 | 選擇 |
|---|---|
| 已經習慣 Codex,只想換模型 | Codex + xAI API Key,按 API 單價計費 |
| 想直接用 Grok 的編程模型,不想折騰配置 | Cursor,訂閱自帶 |
| 想用 xAI 自家的命令行 | Grok Build,官方文檔裏寫了安裝與自定義模型的方法 |
| 想對比 Codex、Claude Code、Cursor 和 Gemini 一側的工具 | 見 /guides/ai-coding-tools-codex-claude-code-cursor-gemini |
常見問題
Q:Grok 訂閱能不能直接當 Codex 的額度用?
官方沒有這樣的說明。訂閱的用量池只覆蓋官方自家產品(Grok、Cursor)裏的 Grok 模型;API 另行計費,Codex 走的是 API。
Q:接口要用 chat completions 還是 responses?
xAI 官方示例用的是 Responses 接口,Codex 官方參考裏 wire_api 只列了 responses,所以按 responses 配。
Q:為什麼 Cursor 裏看不到我要的模型?
Plus 檔只有 Cursor 自家模型,第三方模型從 Premium 起,以官方文檔當前說明為準。
參考資料
- OpenAI:Codex 高級配置 — https://developers.openai.com/codex/config-advanced
- OpenAI:Codex 配置參考 — https://developers.openai.com/codex/config-reference
- docs.x.ai:Quickstart — https://docs.x.ai/developers/quickstart
- docs.x.ai:Pricing — https://docs.x.ai/developers/pricing
- docs.x.ai:What is The X Subscription? — https://docs.x.ai/x-subscription/overview
- Cursor:Models & Pricing — https://cursor.com/docs/models-and-pricing
0 條評論
還沒有評論,來搶沙發~