codex安装、配置、使用备忘

1. 安装与登录

# 使用 npm 安装：
npm install -g @openai/codex

# 检查是否安装成功：
codex --version

# 登录：
codex login 
codex login --device-auth # 如果是在远程服务器没用ui的情况登陆

# 完全权限执行
codex --dangerously-bypass-approvals-and-sandbox

2. 最常用的启动方式

# 进入项目目录后启动交互界面：
cd /path/to/project
codex

# 直接附带任务：
codex "分析这个项目的结构，并告诉我如何启动"

# 指定工作目录：
codex -C /path/to/project

3. 非交互执行

# 适合脚本和 CI：
codex exec "运行测试，定位失败原因并给出修复建议"

4. 代码审查

codex review

# 也可以附带审查要求：
codex review "重点检查安全漏洞、并发问题和破坏性 API 变更"

5. 恢复历史会话

# 打开会话选择器：
codex resume

# 继续最近一次会话：
codex resume --last

从已有会话创建新分支：
codex fork
codex fork --last

6. 模型、图片和联网搜索

# 指定模型：
codex -m MODEL_NAME

7. 沙箱与审批

# 只读模式，适合分析和审查：
codex -s read-only

# 允许修改当前工作区：
codex -s workspace-write

# 完全访问模式风险较高：
codex -s danger-full-access

# 审批策略：
codex -a untrusted
codex -a on-request
codex -a never

一般建议：

codex -s workspace-write -a on-request

谨慎使用以下选项，它会绕过审批和沙箱：

codex --dangerously-bypass-approvals-and-sandbox

只应在外层已经有可靠隔离的临时环境中使用。

8. 配置文件

全局配置通常位于：
~/.codex/config.toml

9. 项目级指令：AGENTS.md

可以在仓库根目录添加 AGENTS.md，告诉 Codex 项目的长期约定：

10. MCP 与插件

# 管理外部 MCP 服务：
codex mcp --help

# 管理 Codex 插件：
codex plugin --help

# 生成终端自动补全脚本：
codex completion bash
codex completion zsh
codex completion fish

11. Codex CLI 全部斜杠命令完整释义

### 一、模型与推理控制
/model
选择使用的大模型，同时调整推理力度（reasoning effort）。
可以切换不同模型版本、设置思考深度，平衡代码准确度、思考耗时。

/fast
极速模式：推理速度提升 1.5 倍，代价是会消耗更多额度 /token，适合简单、快速的代码查询。

### 二、IDE 上下文相关

/ide
自动读取 IDE 上下文：编辑器选中代码、当前打开文件、项目目录、编辑器配置全部传给 Codex，不用手动粘贴代码。

### 三、权限、安全管控

/permissions
配置 Codex 可执行操作的权限：是否允许读写本地文件、运行终端命令、访问网络、修改 Git 等，限制高危操作。

### 四、界面、快捷键、操作模式

/keymap
自定义终端 TUI 界面所有快捷键，修改绑定按键。

/vim
切换输入框编辑区的 Vim 编辑模式，程序员习惯 Vim 操作时开启。

/theme
切换代码语法高亮配色主题，自定义终端代码显示样式。

/pets
终端小宠物，选择显示 / 隐藏侧边可爱小动画形象，纯装饰功能。

/title
自定义终端窗口标题展示内容，可配置显示项目名、对话名、token 用量等。

/statusline
自定义底部状态栏显示信息：模型、token 消耗、权限状态、任务进度等。

/raw
原始回滚模式开关，开启后终端输出无格式化，方便直接复制纯文本日志、命令输出。

### 五、实验功能、插件、MCP 工具

/experimental
开关实验性功能，官方未稳定上线的新特性在此切换启用 / 关闭。

/plugins
浏览、查看、管理所有已安装 / 可安装插件（包含你之前问的 remote_plugin 远程插件）。

/mcp
查看当前配置的 MCP 工具列表；/mcp verbose 输出完整详细配置、日志、权限信息。
MCP：Model Context Protocol，外部工具标准协议，用来连接本地工具、服务器、第三方程序。

### 六、记忆、技能、迁移导入

/memories
配置记忆功能：开启 / 关闭长期记忆、调整记忆生成规则、查看历史记忆内容，让 Codex 记住你的项目规范、编码习惯。

/skills
启用 / 管理技能集，针对特定开发任务优化 Codex 表现（如前端打包、数据库 SQL、Linux 运维、Go 编译等专用技能）。

/import
从 Claude Code 导入配置：项目设置、历史对话、自定义指令一键迁移到 Codex。

### 七、生命周期钩子、自动化脚本

/hooks
查看和管理生命周期钩子脚本，可配置对话启动、代码修改完成、会话退出等时机自动执行自定义脚本。

### 八、代码审查、项目修改

/review
自动审查当前项目代码变更，扫描 bug、不规范写法、安全漏洞、性能问题，给出修改方案。

/diff
展示完整 Git 差异，包含未跟踪新文件，快速查看代码改动内容。

/mention
快捷引用项目文件，等同于手动输入文件路径，让 Codex 读取指定文件分析。

### 九、会话 / 线程管理（对话控制）

/rename
重命名当前对话线程，方便区分多个项目对话。

/new
当前对话不中断，新开一条独立聊天会话。

/archive
归档当前会话并退出，归档会话不会删除，可后续恢复。

/delete
永久删除当前对话，数据不可恢复，然后退出会话。

/resume
恢复之前保存 / 归档的历史对话。

/fork
分支当前对话：复制当前完整上下文生成一条新会话，适合基于当前方案做多版本尝试，互不干扰。

/side
开启临时侧边对话分支（一次性临时会话），用于临时小查询，不污染主对话上下文。

/agent
切换当前活跃 Agent 智能体线程，多任务并行时切换不同任务智能体。

/subagents
切换子智能体线程，复杂长任务会拆分多个子 Agent 分工执行，该命令用于切换、查看或控制子 Agent。

/init
自动生成 AGENTS.md 文件，写入自定义指令、项目规范，所有 Agent 都会读取该文件并遵循其中的编码规则。

### 十、对话压缩、规划、任务目标

/compact
压缩总结超长对话上下文，精简历史记录，减少 token 占用，防止触发上下文长度上限。

/plan
切换至规划模式，Codex 会先输出完整分步开发计划，再分步编写代码，适合大型开发需求。

/goal
设置 / 查看长期运行任务的目标描述，为打包、重构、项目迁移等长耗时任务定义核心目标，防止 AI 偏离需求。

### 十一、复制、导出内容

/copy
将上一轮 AI 输出内容自动复制为 Markdown 格式，方便粘贴到文档、笔记。

### 十二、状态、用量、账号

/status
查看当前会话完整配置：使用模型、已消耗 token、权限状态、插件、上下文信息。

/usage
查看账号额度 / token 消耗总量，也可重置用量统计上限。

/logout
退出当前 Codex 登录账号，切换其他账号使用。

### 十三、终端后台任务管理

/ps
列出所有后台运行的终端进程、脚本、编译任务。

/stop
强制停止全部后台运行的终端任务、长时间执行命令。

/clear
清空当前终端所有输出，同时新建干净的对话上下文。

### 十四、交互风格、反馈、退出

/personality
切换 Codex 沟通风格：简洁干练、详细注释、口语化、严谨正式等。

/approve
批准最近一次被自动审核拦截的重试操作。当 Codex 的高危操作被系统拒绝后，可手动放行并重试一次。

/feedback
将本地运行日志、报错信息发送给官方维护人员，用于提交 bug 反馈。

/exit
退出 Codex CLI 程序，关闭终端助手。