🛡️ 实战教程

Codex 权限与安全使用指南

用最小权限、隔离目录、版本控制和人工确认,让 AI 编程代理更安全地参与开发。

一、为什么要先限制权限

Codex 能够读取文件、提出修改并在授权后执行命令。安全目标不是禁止它工作,而是把每次任务限制在可审查、可回滚的范围内。

二、推荐工作流

  1. 在独立分支开始:git switch -c codex/task-name
  2. 确认目录和工作区:pwd、git status --short
  3. 先让 Codex 输出计划,再允许修改文件。
  4. 修改后检查:git diff --check、git diff --stat
  5. 只运行当前任务需要的测试,确认结果后再合并。

三、命令和文件权限

删除文件、修改部署配置、安装系统包、访问外部网络和写入生产目录,都应保留人工确认。可以先让 Codex 生成命令,再由人工复制执行。

pwd
git status --short
git diff --name-only
# 只运行项目已有的针对性测试
npm test

四、保护密钥和个人数据

不要把 API Key、Cookie、storage state、数据库备份或生产日志放进上下文。示例中使用环境变量名和 [REDACTED] 占位符。提交前检查差异,并使用项目已有的 secret scanning 工具。

五、完成标准

权限名称和界面会随 Codex 版本、操作系统和运行环境变化。涉及具体功能与费用时,请以当前版本和官方文档为准。