Codex CLI

設定前請先安裝 Codex CLI。整合鍵為 codex。

多重安裝安全性

本整合已宣告為多重安裝安全。請參閱共用的多重安裝規則。

設定

specify init my-project --integration codex

若是既有的 Spec Kit 專案,請使用 specify integration install codex。啟用、升級與移除方式請參閱整合管理。

已安裝的技能

技能會安裝為 .agents/skills/speckit-<command>/SKILL.md。在 Codex 的聊天中以美元符號前綴呼叫它們,例如 $speckit-specify,或已安裝 bug 擴充功能的 $speckit-bug-assess。其他整合也會以 .agents/skills/ 為目標;在安裝另一個共用此目錄的代理之前,請先檢視共用的多重安裝規則。

選項與工作流程分派

--integration-options="--skills" 會明確選取技能版式,而這已是本整合唯一支援的版式。原生事件使用 .codex/config.toml;--events false 可停用 Spec Kit 事件處理常式。請參閱執行階段事件。

工作流程步驟使用 codex exec <prompt>,並在已設定時傳入 --model、在要求結構化輸出時傳入 --json。Codex 開發模式的註冊會寫入技能檔案,而不是以符號連結指向它們。

工作流程分派設定

命令與提示詞步驟可設定 reasoning_effort 與 context_size。Codex 分派時會在 --model 之後以設定覆寫的方式傳入:

步驟設定 Codex CLI 參數 值
reasoning_effort -c model_reasoning_effort="<value>" 所選模型支援的層級,例如 low、medium、high 或 xhigh
context_size -c model_context_window=<value> Token 數量:不含前導零的正整數,最大為 9223372036854775807

Spec Kit 會原樣傳遞 reasoning_effort;Codex CLI 0.165.0 不經檢查便將其轉交給模型。Codex 會顯示收到的推理強度,因此請以字面值或工作流程輸入設定,不要使用擷取到的輸出。context_size 若不是有效的 token 數量,步驟會在 Codex 啟動前失敗。

context_size 會覆寫 Codex 為模型假設的上下文視窗。Codex 會將該值箝制在模型的最大值;低於模型預設值時,可用的上下文會縮小。