结论先说
- 一条内置子命令搞定四大主流 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 条评论
还没有评论,来抢沙发~