必须完成补全脚本生成与shell加载两步:先执行codex completion zsh > ~/.codex-completion.zsh生成zsh专用脚本,再在~/.zshrc中前置autoload -uz compinit && compinit后source ~/.codex-completion.zsh;oh my zsh用户则存为~/.oh-my-zsh/completions/_codex。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Zsh中让Codex CLI支持Tab键自动补全命令、子命令和参数,必须完成补全脚本生成与Shell加载两步,缺一不可,否则输入codex后按Tab只会光标停住或报错。
生成Zsh补全脚本
在终端中执行以下命令,将补全脚本写入标准位置:
codex completion zsh > ~/.codex-completion.zsh
这一步必须用zsh类型显式指定,不能省略参数。如果只运行codex completion,默认输出bash脚本,后续加载到Zsh中会直接失效。
配置Zsh加载补全
根据你的Zsh环境选择对应方式:
方法一:原生Zsh(无Oh My Zsh)
编辑~/.zshrc,在文件末尾添加两行:
autoload -Uz compinit && compinit
source ~/.codex-completion.zsh
注意:compinit必须在source补全脚本之前执行,否则补全函数注册失败,Tab键完全无响应。
方法二:使用Oh My Zsh
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
创建专属目录并写入脚本:
mkdir -p ~/.oh-my-zsh/completions
codex completion zsh > ~/.oh-my-zsh/completions/_codex
无需修改.zshrc,Oh My Zsh启动时会自动扫描completions目录下的下划线开头文件。
验证补全是否生效
执行以下操作链确认完整通路:
source ~/.zshrc → 输入codex r → 按Tab键
若成功,应立即补全为codex resume;若仍无反应,大概率是compinit未执行或补全脚本路径错误。
此时可手动检查补全函数是否注册:
echo $fpath | grep codex
如果输出为空,说明FPATH未包含补全目录,需回溯上一步配置。










