Mac版Codex Shell补全配置指南：Bash和Zsh终端Tab键极速提示技巧
在 macOS 上启用 Codex Shell（即 GitHub Copilot CLI 的本地终端工具）的 Tab 补全前，核心是搞清楚它依赖的补全机制。实测表明，Codex CLI（截至 2026 年 6 月）官方并未单独提供 bash 或 zsh 补全包。但好消息是，Codex CLI 基于 .NET 构建，自动继承了 dotnet completions 系统。因此，配置好 .NET 原生补全，Codex 的 Tab 补全也就一并生效了。
第一步：确认 Codex 安装状态与环境兼容性
打开终端，运行 codex --version。若返回类似 codex 1.2.0 的信息，说明 CLI 已就绪；若提示 command not found，则需执行 dotnet tool install -g github.copilot.cli，再跑 dotnet tool restore 完成全局注册。
硬性前提：dotnet CLI 版本需 ≥ 10.0.100。低于此版本时，系统无法生成原生补全脚本，Tab 补全将回退至缓慢的动态模式，体验大打折扣。
Zsh 用户：手动注入原生补全脚本
Zsh 下启用原生补全，无法依赖 oh-my-zsh 的自动插件；必须手动将 .NET 补全脚本嵌入 shell 初始化流程。
第一步，生成并激活补全脚本：在终端执行 eval "$(dotnet completions script zsh)"。
第二步，持久化配置：运行 echo 'eval "$(dotnet completions script zsh)"' >> ~/.zshrc。
第三步，重载配置并验证：执行 source ~/.zshrc，接着输入 codex a 后按 Tab——此时应立刻列出 ask、auth 等子命令，而非仅补全文件名。
注意事项：若之前手动添加过 autoload -Uz compinit && compinit，务必确保该行在 eval 之前执行，否则补全函数可能注册失败。
Bash 用户：基于 Readline 的补全方案
Bash 的补全机制与 Zsh 不同，但 .NET 原生脚本同样做了适配，操作简洁。
方法一（推荐）：直接写入 .bashrc。执行 echo 'eval "$(dotnet completions script bash)"' >> ~/.bashrc && source ~/.bashrc 即可。
方法二：若使用旧版 macOS 配置（主文件为 .bash_profile），则写入该文件：echo 'eval "$(dotnet completions script bash)"' >> ~/.bash_profile && source ~/.bash_profile。
验证方式：输入 codex l 后按 Tab，应自动补全为 list 并高亮显示。
补全失效的快速排查方法
首先，运行 dotnet --list-sdks，检查输出中是否包含 10.0. 开头的 SDK 版本。若无，说明版本不足，需升级：brew update && brew upgrade dotnet-sdk。
其次，使用 complete -p codex 检查补全注册状态。若该命令无输出，表示补全未绑定。此时可临时修复：Zsh 用户执行 dotnet completions script zsh | source /dev/stdin；Bash 用户执行 source <(dotnet completions script bash)。
若问题依旧，确认 ~/.dotnet/tools 是否在 $PATH 中：运行 echo $PATH | grep dotnet。若未找到，在 ~/.zshrc 或 ~/.bash_profile 中添加 export PATH="$HOME/.dotnet/tools:$PATH"，再执行 source 刷新。
