結論先說
- 一條內置子命令搞定四大主流 Shell。Codex CLI 自帶
codex completion <shell>生成器,原生支持bash、zsh、fish與powershell,不需要額外裝第三方插件。 - 先確認版本再配補全。補全腳本會隨 CLI 新參數演進;先運行
codex --version和codex completion --help確認當前二進制正常可用,升級大版本後如果用的是靜態落盤文件,記得重新生成一次。 - 動態
source最省事,靜態落盤冷啟動更快。Bash / Zsh 直接把source <(codex completion ...)寫進配置文件最簡單,但如果特別在意終端秒開速度,把腳本輸出到 Zsh 的$fpath或 Fish 的completions/目錄即可實現按需懶加載。 - Windows PowerShell 常見攔路虎是執行策略。如果改完
$PROFILE重開終端報腳本禁止運行,通常是 Windows 預設執行策略攔截了本地 Profile 文件,按需放行當前用戶的RemoteSigned即可恢復。 - 把 CLI 終端工作流配順後,日常編碼頻率上來更建議配好合適會員檔位。國內若無外幣支付渠道,可在本站自助選購 ChatGPT Plus 或配額更高的 ChatGPT Pro,團隊統一部署也可了解 ChatGPT Business 團隊定製。

圖:本站根據 OpenAI Codex 官方文檔:Codex CLI reference 整理的示意圖
本文根據 OpenAI Codex 官方文檔《Codex CLI reference》整理,資料核對於 2026-11-19。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。
適用於誰
- 每天高頻敲
codex exec、--sandbox、--output-last-message、--profile等長參數,希望按一下Tab就能自動補全的開發者; - 在 macOS(Zsh)、Linux(Bash / Fish)與 Windows(PowerShell)多台電腦之間切換,想一次性配齊規範補全腳本的用戶;
- 按網上教學配完
codex completion後發現按 Tab 沒反應、或感覺新開終端變慢需要調優的工程師。
一、四大主流 Shell 一步到位配置命令
在開始前,請確認本機已經正確安裝並可調用 codex(安裝與升級方法可參考 /guides/codex-cli-install-update),在終端輸入 codex --version 能正常打印版本號即可繼續。
1. Zsh(macOS 預設 / Linux 常用)
先確保 ~/.zshrc 中已經初始化了 Zsh 補全系統(autoload -Uz compinit && compinit),再追加加載語句:
zsh
# 方式 A:動態加載(最省事,升級 CLI 自動同步新參數)
echo 'autoload -Uz compinit && compinit' >> ~/.zshrc
echo 'source <(codex completion zsh)' >> ~/.zshrc
source ~/.zshrc
如果你同時裝了 Oh My Zsh 或在意終端冷啟動毫秒級延遲,本站建議改用靜態落盤方式,讓 Zsh 按需懶加載:
zsh
# 方式 B:靜態寫入獨立補全目錄(啟動更快)
mkdir -p ~/.zsh/completions
codex completion zsh > ~/.zsh/completions/_codex
# 確保 ~/.zshrc 中在 compinit 之前加入:fpath=(~/.zsh/completions $fpath)
2. Bash(Linux 預設 / Git Bash)
在 Linux 上建議先確保系統已安裝 bash-completion 包,然後寫入 ~/.bashrc(macOS 若用 Bash 登入終端則寫入 ~/.bash_profile):
bash
echo 'source <(codex completion bash)' >> ~/.bashrc
source ~/.bashrc
如果使用較老版本 Bash 3.2(例如 macOS 系統自帶的舊版 /bin/bash),進程替換 source <(...) 偶爾會失效,可改為 eval "$(codex completion bash)"。
3. Fish
Fish 原生支持按目錄自動懶加載補全文件,直接導出一次即可永久生效,不需要改 config.fish:
fish
mkdir -p ~/.config/fish/completions
codex completion fish > ~/.config/fish/completions/codex.fish
如果偏好每次啟動實時生成,也可以在 ~/.config/fish/config.fish 中添加 codex completion fish | source。
4. PowerShell(Windows PowerShell 5.1 / PowerShell 7 pwsh)
在 PowerShell 終端中先確保個人 $PROFILE 文件存在,再寫入補全腳本加載語句:
powershell
if (!(Test-Path -Path $PROFILE)) {
New-Item -ItemType File -Force -Path $PROFILE
}
Add-Content -Path $PROFILE -Value 'codex completion powershell | Out-String | Invoke-Expression'
. $PROFILE
配置完成後,任意打開一個新終端窗口,輸入 codex ex 按 Tab 自動補成 codex exec,或輸入 codex -- 連按兩次 Tab 看到完整參數候選列表,即說明補全已經生效(完整 CLI 參數速查見 /guides/codex-cli-commands-cheatsheet)。
訂閱與帳號準備提示:終端補全順手之後,日常調用codex exec、--profile與高推理檔位排查代碼的頻率通常會明顯提高(配額與省額技巧參考 /guides/codex-usage-limits 與 /guides/codex-save-usage-quota-model-reasoning-context-tips)。如果高頻觸及限額,可在本站開通 ChatGPT Pro 充值 或 ChatGPT Pro 20x 高額度檔;新帳號註冊遇到手機驗證難題,可查看 Codex 註冊手機驗證服務。
二、配完 Tab 沒反應或報錯怎麼排查
如果按上述命令執行後按 Tab 依然只補全文件名、甚至新開終端直接報紅,按下面分流逐一排查:

圖:本站根據 OpenAI Codex 官方文檔:Codex CLI reference 整理的示意圖
- Zsh 報
command not found: compdef:說明source <(codex completion zsh)排在了compinit之前。把autoload -Uz compinit && compinit(或 Oh My Zsh 初始化行)挪到補全語句前面即可;若改了靜態_codex文件不生效,刪掉~/.zcompdump*緩存後重啟終端重建索引。 - Windows PowerShell 提示「在此係統上禁止運行腳本」:這是 Windows 預設的
Restricted執行策略攔住了$PROFILE。以當前用戶身份運行Set-ExecutionPolicy -Scope CurrentUser RemoteSigned,確認後重開 PowerShell 即可加載。 - 重裝或升級 Codex 後新參數補不出來:使用靜態文件(如
~/.config/fish/completions/codex.fish或~/.zsh/completions/_codex)時,升級 CLI 後需要重新導出覆蓋舊文件;使用動態source或Invoke-Expression則會自動跟隨新版 CLI。 - Windows 同時裝了 Windows PowerShell 5.1 和 PowerShell 7:兩者的
$PROFILE路徑互相獨立(分別位於Documents\WindowsPowerShell與Documents\PowerShell),你在哪個終端裏跑 Codex,就在對應終端裏執行一次配置命令。
常見問題
問:為什麼在 Zsh 裏按 Tab 時,只補全子命令卻沒補全我在 config.toml 裏自定義的 Profile 名稱?
答:codex completion 生成的是 CLI 內置子命令與標誌位(Flags)的補全腳本,核心覆蓋子命令、長短參數與內置枚舉值;動態讀取本地自定義配置文件裏的用戶 Profile 名稱取決於具體版本實現,若未自動候選,可手動結合常用 Shell 別名(alias)簡化調用。
問:把 source <(codex completion zsh) 寫進 ~/.zshrc 會明顯拖慢終端打開速度嗎?
答:每次開新窗口都會拉起一次 codex 子進程輸出補全文本,在大多數現代電腦上只增加幾十毫秒;如果電腦上已經堆了幾十個 CLI 補全導致體感變慢,按正文方式改用靜態 _codex 文件放入 $fpath 或 Fish 原生 completions/ 目錄就能消除每次啟動的子進程開銷。
問:國內沒有外幣信用卡,或者公司研發團隊需要開增值稅發票報銷,怎麼開通能跑 Codex 的訂閱?
答:可在本站 AI 會員充值總覽 按需選購 ChatGPT Plus、ChatGPT Plus 官網直充 或高配額的 ChatGPT Pro,多人團隊統一採購可直接查看 ChatGPT Business 團隊定製。支持支付寶、微信支付與 AlipayHK,自助兌換無需交出帳號密碼,並可開具增值稅發票;實時價格以商品頁展示為準,售後執行掉訂閱按剩餘天數折退、封號不在質保範圍的政策。
相關教學
- Codex CLI 安裝與升級更新完整指南
- Codex CLI 常用命令與參數速查表
- Codex CLI 參數覆寫(-c)與 CODEX_HOME 多環境隔離教學
- Codex 節省額度的模型、推理檔位與上下文實用技巧
參考資料
- OpenAI Developers 文檔:Codex CLI reference — https://developers.openai.com/codex/cli/reference
- OpenAI Codex 官方文檔:CLI reference — https://learn.chatgpt.com/docs/cli/reference
- OpenAI Codex GitHub 倉庫 — https://github.com/openai/codex
0 條評論
還沒有評論,來搶沙發~