HoRain云--Codex 配置与定制

HoRain云小助手个人主页 个人专栏: 《Linux 系列教程》《c语言教程》⛺️生活的理想就是为了理想的生活!⛳️ 推荐前些天发现了一个超棒的服务器购买网站性价比超高大内存超划算忍不住分享一下给大家。点击跳转到网站。专栏介绍专栏名称专栏介绍《C语言》本专栏主要撰写C干货内容和编程技巧让大家从底层了解C把更多的知识由抽象到简单通俗易懂。《网络协议》本专栏主要是注重从底层来给大家一步步剖析网络协议的奥秘一起解密网络协议在运行中协议的基本运行机制《docker容器精解篇》全面深入解析 docker 容器从基础到进阶涵盖原理、操作、实践案例助您精通 docker。《linux系列》本专栏主要撰写Linux干货内容从基础到进阶知识由抽象到简单通俗易懂帮你从新手小白到扫地僧。《python 系列》本专栏着重撰写Python相关的干货内容与编程技巧助力大家从底层去认识Python将更多复杂的知识由抽象转化为简单易懂的内容。《试题库》本专栏主要是发布一些考试和练习题库涵盖软考、HCIE、HRCE、CCNA等目录⛳️ 推荐专栏介绍Codex App 的设置配置文件位置配置合并规则基础配置项基础配置AGENTS.md文件发现顺序AGENTS.md 示例项目 AGENTS.md子目录覆盖子目录规则Skills技能技能目录位置技能结构创建技能技能定义技能触发Subagents子代理内置代理类型配置子代理子代理配置自定义代理自定义代理Rules规则规则文件规则定义决策类型Hooks钩子启用 Hooks启用 HooksHook 事件配置 HookHook 配置常见问题Q: 配置修改后如何生效Q: AGENTS.md 应放在哪里Q: Skills 和 Rules 的区别Q: 如何查看当前配置Codex 提供丰富的配置选项让你定制 Agent 的行为以适应不同的工作需求。默认情况下 Codex App 会根据你的系统设置语言如果没有可以通过 Settings 设置 选择 General常规 常规选项修改你需要的语言同样如果要中文改英文勾选英文即可Codex App 的设置打开方式点击应用菜单中的设置 Settings 或按 Cmd ,设置界面如下所示常规General配置文件的打开方式、命令输出在对话线程中的显示量。还可设置多行提示需要 CmdEnter 确认以及防止任务运行期间系统休眠。通知Notifications设置任务完成通知的触发时机以及是否由应用主动请求系统通知权限。Agent 配置Agent ConfigurationApp 中的 Codex Agent 与 IDE 和 CLI 扩展共享同一套配置。常用选项可在 App 内直接调整高级选项需编辑 config.toml 文件后文说明。外观Appearance支持选择基础主题调整强调色、背景色和前景色以及更换 UI 字体和代码字体。可将自定义主题分享给他人。Codex 宠物Codex Pets:可选的动态陪伴角色路径Settings设置 Appearance外观 Pets宠物可选择内置宠物或从本地 Codex 主目录加载自定义宠物。操作方式在输入框中输入/pet使用Settings Appearance中的Wake Pet或Tuck Away Pet按CmdK/CtrlK后运行同名命令宠物悬浮窗可在使用其他应用时持续显示当前 Codex 工作状态运行中 / 等待输入 / 待审查并附有简短进度提示。自定义宠物创建流程$skill-installer hatch-pet安装后在命令菜单中选择Force Reload Skills再执行$hatch-pet create a new pet inspired by my recent projectsGit: 统一分支命名规范配置是否启用强制推送force push并设置 Codex 自动生成提交信息commit message和 PR 描述时所用的提示语。环境可以查看项目目录及添加项目。工作树利用 Git worktree 让 Codex 在同一项目中并行处理多个任务。浏览器使用Browser Use安装或启用内置 Browser 插件管理网站白名单和黑名单。默认情况下Codex 使用任何网站前都会先询问用户将网站从黑名单移除后Codex 将恢复询问行为。详见应用内浏览器文档。电脑操控Computer Use仅限 macOS。可查看桌面应用访问权限及相关偏好设置。如需撤销系统级权限请前往 macOS 隐私与安全性 中修改屏幕录制或辅助功能权限。已归档的项目Archived Threads列出所有已归档的对话显示日期和项目上下文。点击取消归档 Unarchive 可恢复指定线程。配置文件位置Codex 配置文件分层管理层级路径作用范围用户级~/.codex/config.toml全局默认配置项目级.codex/config.toml项目特定配置托管级企业下发企业统一配置配置合并规则配置按优先级合并托管配置优先级最高项目配置覆盖用户配置用户配置作为默认值基础配置项基础配置# ~/.codex/config.toml# 默认模型model gpt-5.4# 推理强度model_reasoning_effort medium # minimal | low | medium | high | xhigh# 推理摘要详细程度model_reasoning_summary auto # auto | concise | detailed | none# 服务层级service_tier flex # flex | fast# 审批策略approval_policy suggest # suggest | auto-edit | full-autoAGENTS.mdAGENTS.md 是项目级的 Agent 指令文件定义 Codex 在该项目中的行为规范。文件发现顺序读取全局~/.codex/AGENTS.md从项目根目录向下搜索每个目录更近目录的规则覆盖更远的AGENTS.md 示例项目 AGENTS.md# 项目开发规范## 技术栈- 前端React TypeScript- 后端Python FastAPI- 数据库PostgreSQL## 代码规范- 使用 4 空格缩进- 每行最多 100 字符- 所有函数必须有类型注解## 测试要求- 新功能必须包含测试- 使用 pytest 运行测试## Git 提交- 使用 Conventional Commits 格式- 提交信息描述为什么## Review guidelines- Dont log PII- Verify authentication middleware- Check for SQL injection子目录覆盖可以在子目录放置 AGENTS.override.md子目录规则# src/auth/ 模块规则## 安全要求- 所有密码必须 bcrypt 加密- 添加审计日志- 检查 SQL 注入AGENTS.md 大小限制为 32 KiB超过会被截断。Skills技能Skills 是可复用的自定义能力封装常用任务逻辑。技能目录位置位置路径作用REPO.agents/skills/项目级技能USER~/.agents/skills/用户级技能ADMIN/etc/codex/skills/系统级技能SYSTEM内置官方预置技能技能结构skill-name/ ├── SKILL.md # 技能定义必需 ├── scripts/ # 可选脚本 ├── references/ # 可选参考文档 └── assets/ # 可选资源创建技能技能定义---name: code-review-standarddescription: 执行团队标准代码审查---# 代码审查标准## 审查项目1. 代码可读性2. 潜在 Bug3. 安全漏洞4. 性能问题5. 测试覆盖## 输出格式- 问题列表按严重程度- 改进建议- 评分1-10技能触发触发方式示例显式调用$skill-name或/skill-name隐式匹配任务描述匹配技能 descriptionSubagents子代理Subagents 允许将复杂任务拆分给多个 Agent 并行处理。内置代理类型代理功能default通用代理worker执行导向适合实现和修复explorer探索导向适合代码库分析配置子代理子代理配置# ~/.codex/config.toml[agents]# 最大并行线程max_threads 6# 最大嵌套深度max_depth 1# 单任务超时job_max_runtime_seconds 1800自定义代理自定义代理# ~/.codex/agents/reviewer.tomlname reviewerdescription 专注代码审查和质量问题nickname_candidates [Reviewer, QualityBot]developer_instructions 专注于代码质量审查- 检查代码风格一致性- 发现潜在 Bug- 评估测试覆盖Rules规则Rules 定义命令执行策略控制哪些命令可以自动执行。规则文件规则使用 Starlark 语言类似 Python规则定义# ~/.codex/rules/default.rules# 允许 Git 命令prefix_rule(pattern [git],decision allow,justification Git commands are safe)# 禁止 rm -rf /prefix_rule(pattern [rm, -rf, /],decision forbidden,justification Prevent system damage)# 询问 npm 命令prefix_rule(pattern [npm],decision prompt,justification npm may modify dependencies)决策类型决策行为allow自动批准prompt询问确认forbidden禁止执行Hooks钩子Hooks 在特定事件时执行自定义脚本。启用 Hooks启用 Hooks[features]codex_hooks trueHook 事件事件触发时机SessionStart会话启动PreToolUse工具调用前PostToolUse工具调用后配置 HookHook 配置{hooks: [{event: PostToolUse,matcher: {toolName: Bash},hooks: [{type: command,command: echo Command executed,timeout: 10}]}]}常见问题Q: 配置修改后如何生效修改配置后需要重启 Codex 才能生效。Q: AGENTS.md 应放在哪里项目根目录或需要特殊规则的子目录。Q: Skills 和 Rules 的区别Skills 定义任务执行逻辑Rules 控制命令权限。Q: 如何查看当前配置使用/status命令查看当前会话配置。❤️❤️❤️本人水平有限如有纰漏欢迎各位大佬评论批评指正如果觉得这篇文对你有帮助的话也请给个点赞、收藏下吧非常感谢! Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧