CLI 自定义#

Codex 中文站说明： 本页围绕“CLI 自定义”重新补充了中文使用场景和验证重点。界面名称可能随 Codex 版本更新，请以当前客户端为准。

自定义 Codex 终端界面、编辑器、补全和快捷键

Codex CLI 提供终端专用选项，用来调整交互式会话的显示方式，以及命令和提示词的输入方式。

语法高亮与主题#

终端 UI（TUI）会为 Markdown 围栏代码块和文件差异添加语法高亮。运行 /theme 打开主题选择器，预览主题，并把选择保存到 $CODEX_HOME/config.toml 的 tui.theme。

若要添加自定义主题，把 .tmTheme 文件放入 $CODEX_HOME/themes，再从主题选择器中选中它。

Shell 补全#

为 Bash、Z shell、Fish 或 PowerShell 生成补全脚本：

codex completion zsh

在 shell 配置中加载脚本。对于 Z shell，添加：

eval "$(codex completion zsh)"

如果 Z shell 报告 command not found: compdef，请先初始化补全系统，再加载 Codex 补全：

autoload -Uz compinit && compinit
eval "$(codex completion zsh)"

重启 shell，输入 codex 并按 Tab，确认补全可用。

提示词编辑器#

对于较长的提示词，在输入框中按 Ctrl+G，即可打开 VISUAL 指定的编辑器；如果未设置 VISUAL，则使用 EDITOR。保存并关闭编辑器后，文本会返回输入框，随后再发送。

交互式键盘控制以及完整命令和选项列表，请参阅开发者命令。

本站实践建议#

处理“CLI 自定义”相关配置前，建议先备份现有配置文件，并在测试项目中逐项启用。每次只改变一个设置，便于出现异常时快速定位和回滚。

Codex API 与国内使用#

在实践“CLI 自定义”相关功能时，如需为 Codex 配置 OpenAI-compatible API，可以前往 APIBest 获取 API Key。第三方服务的模型映射、价格、额度和数据处理方式以 APIBest 当前说明为准。