一、这篇文章和上一篇Codex介绍的区别

上篇讲了Codex是什么、跟Claude Code有什么不同。这篇不讲概念了——直接动手。

我们要搭建的工作流是：批量证据材料整理。 这是诉讼律师最高频的重复性工作之一。一个案子可能有几十份甚至上百份证据材料——合同、聊天记录、转账凭证、邮件往来——你需要把它们逐份分类、提取关键信息、标注证据来源、生成证据目录。

手工做这件事，一个中等复杂度的案子可能要花半天到一天。用Codex搭一个工作流，把这个时间压缩到一个小时以内。

全程不需要写代码。跟着做，你会在一个小时内拥有一个能自动整理证据材料的AI助手。

二、安装和登录

第一步：装Node.js

Codex需要Node.js 22以上。打开终端——Windows按Win+R，输入powershell回车。

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      node --version
     
     
     
     
    
    
    
    
   
   
   
   

如果显示v22.x.x或更高，跳过。如果版本不够或没装，去nodejs.org下载LTS版本，一路默认安装。装完关掉终端重开。

注意：Codex对Node版本要求比Claude Code高（Codex要22+，Claude Code要18+）。如果你之前装了Claude Code但Node版本在18-21之间，需要升级Node。

第二步：安装Codex

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      npm install -g @openai/codex
     
     
     
     
    
    
    
    
   
   
   
   

安装完验证：

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      codex --version
     
     
     
     
    
    
    
    
   
   
   
   

第三步：登录

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      codex login
     
     
     
     
    
    
    
    
   
   
   
   

浏览器会自动打开OpenAI登录页面。用你的ChatGPT账号登录即可——Plus订阅（$20/月）就能用。登录成功后终端显示确认信息。

如果你更习惯用API Key而非账号登录：

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      setx OPENAI_API_KEY "你的API密钥"
     
     
     
     
    
    
    
    
   
   
   
   

关掉终端重开。

验证安装

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      codex -- "你好，请用一句话介绍你自己"
     
     
     
     
    
    
    
    
   
   
   
   

正常回复就说明环境OK。到这里，Codex已经可以用了。接下来建工作流。

三、创建你的第一个工作流：批量证据整理

3.1 建工作目录

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
     
     
     
     

      2
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      mkdir C:\legal-codex
cd C:\legal-codex
     
     
     
     
    
    
    
    
   
   
   
   

3.2 写AGENTS.md——告诉Codex你是谁

在C:\legal-codex下新建一个文本文件，命名为AGENTS.md，写入以下内容：

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
     
     
     
     

      2
     
     
     
     
     
     
     
     

      3
     
     
     
     
     
     
     
     

      4
     
     
     
     
     
     
     
     

      5
     
     
     
     
     
     
     
     

      6
     
     
     
     
     
     
     
     

      7
     
     
     
     
     
     
     
     

      8
     
     
     
     
     
     
     
     

      9
     
     
     
     
     
     
     
     

      10
     
     
     
     
     
     
     
     

      11
     
     
     
     
     
     
     
     

      12
     
     
     
     
     
     
     
     

      13
     
     
     
     
     
     
     
     

      14
     
     
     
     
     
     
     
     

      15
     
     
     
     
     
     
     
     

      16
     
     
     
     
     
     
     
     

      17
     
     
     
     
     
     
     
     

      18
     
     
     
     
     
     
     
     

      19
     
     
     
     
     
     
     
     

      20
     
     
     
     
     
     
     
     

      21
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      # AGENTS.md
 
## 我的身份
我是一名中国执业律师，主要从事民商事诉讼。

## 工作风格
- 使用简明中文
- 法律引用必须标注准确条目
- 不确定的地方标注"待确认"
- 输出使用结构化的表格和清单

## 证据整理标准
- 证据分类：合同类 / 沟通记录类 / 财务凭证类 / 官方文件类 / 其他
- 每份证据标注：名称、来源、日期、证明目的
- 证据目录按时间顺序排列
- 关键信息高亮标注

## 输出格式
- 先生成证据材料总清单
- 再按类别分组输出详细清单
- 最后生成标准证据目录
     
     
     
     
    
    
    
    
   
   
   
   

3.3 创建证据整理Skill

在C:\legal-codex下新建文件夹skills，在里面新建文件evidence-organizer.md：

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
     
     
     
     

      2
     
     
     
     
     
     
     
     

      3
     
     
     
     
     
     
     
     

      4
     
     
     
     
     
     
     
     

      5
     
     
     
     
     
     
     
     

      6
     
     
     
     
     
     
     
     

      7
     
     
     
     
     
     
     
     

      8
     
     
     
     
     
     
     
     

      9
     
     
     
     
     
     
     
     

      10
     
     
     
     
     
     
     
     

      11
     
     
     
     
     
     
     
     

      12
     
     
     
     
     
     
     
     

      13
     
     
     
     
     
     
     
     

      14
     
     
     
     
     
     
     
     

      15
     
     
     
     
     
     
     
     

      16
     
     
     
     
     
     
     
     

      17
     
     
     
     
     
     
     
     

      18
     
     
     
     
     
     
     
     

      19
     
     
     
     
     
     
     
     

      20
     
     
     
     
     
     
     
     

      21
     
     
     
     
     
     
     
     

      22
     
     
     
     
     
     
     
     

      23
     
     
     
     
     
     
     
     

      24
     
     
     
     
     
     
     
     

      25
     
     
     
     
     
     
     
     

      26
     
     
     
     
     
     
     
     

      27
     
     
     
     
     
     
     
     

      28
     
     
     
     
     
     
     
     

      29
     
     
     
     
     
     
     
     

      30
     
     
     
     
     
     
     
     

      31
     
     
     
     
     
     
     
     

      32
     
     
     
     
     
     
     
     

      33
     
     
     
     
     
     
     
     

      34
     
     
     
     
     
     
     
     

      35
     
     
     
     
     
     
     
     

      36
     
     
     
     
     
     
     
     

      37
     
     
     
     
     
     
     
     

      38
     
     
     
     
     
     
     
     

      39
     
     
     
     
     
     
     
     

      40
     
     
     
     
     
     
     
     

      41
     
     
     
     
     
     
     
     

      42
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      # 批量证据材料整理 Skill
 
## 触发条件
当用户要求整理证据、归纳证据、生成证据目录时使用。

## 处理流程

### 第一步：扫描材料
读取目录下所有证据文件（支持PDF、DOCX、图片、TXT）。
对扫描件/图片类文件启用OCR识别（Codex支持图像输入）。

### 第二步：逐份提取关键信息
对每份证据材料提取：
- 文件名称
- 证据类型（合同/聊天记录/转账凭证/邮件/官方文件/照片/其他）
- 涉及主体（哪些当事人/机构）
- 关键日期
- 金额信息（如有）
- 核心内容一句话概括
- 证明目的（这份证据想证明什么）

### 第三步：生成结构化清单
按以下格式输出三份清单：

**清单A：证据总览表**
| 序号 | 证据名称 | 类型 | 日期 | 来源 | 证明目的 |
|------|---------|------|------|------|---------|

**清单B：按类别分组**
- 📋 合同类（共X份）
- 💬 沟通记录类（共X份）
- 💰 财务凭证类（共X份）
- 🏛️ 官方文件类（共X份）
- 📎 其他（共X份）

**清单C：标准证据目录**
按照法院要求的证据目录格式输出：编号、证据名称、页数、证明对象、证据来源

### 第四步：交叉校验
- 检查是否有同一事件的多份证据可以相互印证
- 标注证据链中的缺口（缺失的关键证据）
- 标注存在矛盾的证据（同一事实有不同版本的说法）
     
     
     
     
    
    
    
    
   
   
   
   

四、实操：用工作流整理一个案子的证据材料

4.1 准备材料

把你要整理的证据材料（PDF、DOCX、图片、文本文件）全部放到C:\legal-codex\evidence\目录下。可以先拿一个你手头正在办的案子——用几份材料试试效果。

4.2 启动Codex

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
     
     
     
     

      2
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      cd C:\legal-codex
codex
     
     
     
     
    
    
    
    
   
   
   
   

进入Codex的交互模式后（你会看到一个终端UI），输入：

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      请按照 skills/evidence-organizer.md 中定义的流程，整理 evidence/ 目录下的所有证据材料，生成完整的证据清单和证据目录。
     
     
     
     
    
    
    
    
   
   
   
   

4.3 观察Codex的工作过程

Codex会逐步执行：

1. 扫描evidence/目录，列出所有文件
2. 逐个读取文件内容，提取关键信息
3. 按Skill定义的分类标准进行归类
4. 生成三份清单

由于Codex默认运行在Suggest模式下，每一步操作都会征求你的确认——你可以看到它在做什么，确认后继续。如果你信任这个流程，可以切换到Auto-edit模式：

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      /approvals auto-edit
     
     
     
     
    
    
    
    
   
   
   
   

这样文件读取和分析会自动进行，只有危险操作才需要确认。

4.4 拿到输出

整理完成后，Codex会在工作目录下生成结果文件（通常是你指定的格式）。你会得到：

• 一份证据总览表——所有材料的“快照”
• 按类型分组的详细清单——方便按类别查阅
• 一份标准格式的证据目录——可以直接附在起诉状或代理词后面

更重要的是，它会标注证据链中的缺口和矛盾——哪些关键事实缺乏证据支撑，哪些证据之间存在冲突。这对制定诉讼策略非常有价值。

五、利用Codex的特色功能让工作流更强大

5.1 图像输入——直接处理扫描件和照片

Codex支持图像输入。如果你的证据材料是纸质合同的照片或扫描件，不需要先做OCR——直接告诉Codex：

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      请读取 evidence/扫描合同.jpg，这是用手机拍的一份合同，提取其中的关键条款信息
     
     
     
     
    
    
    
    
   
   
   
   

Codex会直接“看懂”图片中的文字和结构。

5.2 管道输入——把外部数据直接喂给Codex

如果你从裁判文书网、企业信用信息公示系统下载了数据，可以先通过其他命令做预处理，然后管道传给Codex：

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
     
     
     
     

      2
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      # 先从文件中提取关键信息
cat 企业信息.txt | codex -- "从这个企业工商信息中提取：统一社会信用代码、法定代表人、注册资本、经营范围"
     
     
     
     
    
    
    
    
   
   
   
   

5.3 Goal模式——一次性整理大量材料

如果你的证据材料特别多（几百份），可以用Goal模式让它自己跑：

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
     
     
     
     

      2
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      codex
/goal 整理 evidence/ 目录下的所有证据材料，按 skills/evidence-organizer.md 的流程处理。完成后生成完整的证据清单、分类清单和标准证据目录。处理过程中遇到无法识别的文件格式，跳过并记录。
     
     
     
     
    
    
    
    
   
   
   
   

然后你就可以关掉终端做别的事了。Codex会持续工作，完成后通知你。你可以随时用/goal pause暂停、/goal resume继续。

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
     
     
     
     

      2
     
     
     
     
     
     
     
     

      3
     
     
     
     
     
     
     
     

      4
     
     
     
     
     
     
     
     

      5
     
     
     
     
     
     
     
     

      6
     
     
     
     
     
     
     
     

      7
     
     
     
     
     
     
     
     

      8
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      # 查看Goal状态
/goal status
 
# 暂停
/goal pause
 
# 继续
/goal resume
     
     
     
     
    
    
    
    
   
   
   
   

六、这个工作流和Claude Code版本的对比

如果你之前看过我用Claude Code搭的合同审查工作流，这里做一个对比——帮你在两个工具之间做选择：

建议：如果你的证据材料包含大量扫描件和照片——用Codex。如果你需要做证据链的深度法律分析（比如判断某份证据在法庭上的证明力）——把Codex整理好的材料交给Claude Code做分析。两个工具配合使用效果最好。

七、避坑指南

坑一：Node版本不够。 Codex要求Node.js 22+，但很多人的电脑上还是18或20。装完Codex如果报错，先node --version确认版本。

坑二：AGENTS.md写得太笼统。 如果你的AGENTS.md只写“我是律师”，Codex会按照它自己的理解来输出——可能不符合你的标准。花15分钟把分类标准、输出格式、标注要求写清楚。

坑三：一次性丢太多文件。 Codex有上下文窗口限制。如果证据材料特别多（几百份），不要一次性全丢给它——先分批次整理，每批控制在50份以内，最后汇总。

坑四：在Full-auto模式下不加检查。 Codex的Full-auto模式会让它自动执行所有操作。对法律文件——尤其是包含当事人隐私信息的证据材料——永远不要用Full-auto。始终用Suggest模式，每一步都确认。

坑五：忘记Git备份。 在处理重要文件前，先用Git做版本控制或简单复制一个备份文件夹。万一Codex出了意外操作，还有恢复的余地。

八、从这个工作流出发

你今天搭好的证据整理工作流，可以继续扩展：

• 加上时间线生成： 在Skill中增加一条“生成案件事实时间线，按时间顺序列出所有关键事件及其对应的证据编号”
• 加上金额汇总： 在Skill中增加“统计所有涉及金额的证据，生成金额汇总表（总金额、已支付、未支付、争议金额）”
• 加上举证责任分析： 让Codex对照你的诉讼主张，标注每项主张是否有对应证据支撑、举证责任是否完成
• 适配不同案件类型： 建多个Skill——劳动争议的证据整理逻辑和合同纠纷不一样，分类标准也不同

📚 参考文献

• OpenAI Codex CLI GitHub
• Codex CLI 官方文档
• Codex Goal 模式指南

⚠️ 免责声明：本文内容仅为提供信息之目的，不构成法律或技术建议。AI辅助证据整理的结果应经过持证律师人工复核后使用。证据材料涉及当事人隐私的，请注意数据安全。本文作者及平台不对因依赖本文内容而导致的任何损失承担责任。

📝 法律AI工具