OpenAI Codex 实战指南⑤：高级技巧——上下文管理、多轮对话、自定义技能包、模型选择

前言

前四篇我们完成了Codex的安装配置、核心功能和工作流集成。这篇聊高级技巧：如何管理上下文、优化多轮对话、自定义技能包、选择合适的模型——帮你把Codex用到极致。

一、上下文管理

1.1 为什么上下文管理很重要

Codex的上下文窗口有限（GPT-4.1为128K token）。如果对话历史太长，早期信息会被截断，导致回答质量下降。有效管理上下文是高质量使用Codex的关键。

1.2 手动清理上下文

# 清除当前会话的所有上下文
/clear

# 只保留最近N轮对话
/trim 5

# 查看当前上下文用量
/context-info

1.3 自动上下文压缩

Codex支持自动压缩早期对话，保留关键信息：

# 在配置中启用自动压缩
codex config set auto_compress true
codex config set compress_threshold 0.7  # 上下文使用70%时触发压缩

1.4 选择性保留上下文

使用/pin命令固定重要信息，不被压缩：

# 固定某条消息
/pin msg_abc123

# 固定当前项目的架构说明
/pin "本项目使用FastAPI+PostgreSQL，分层架构：api/→service/→repository/"

# 查看所有固定内容
/pins

二、多轮对话优化

2.1 分步骤描述复杂需求

不要一次性扔给Codex一个超长需求。拆分步骤：

# ❌ 不推荐：一次性扔大需求
> 帮我写一个完整的电商系统，包含用户注册、商品管理、订单处理、支付集成...

# ✅ 推荐：分步骤
> 第一步：设计一个用户注册API（FastAPI），包含邮箱验证
[Codex输出]
> 第二步：在上面的基础上，添加JWT认证中间件
[Codex输出]
> 第三步：添加商品CRUD接口...

2.2 用文件名锚定对话

在对话中引用具体文件名，帮助Codex精准定位：

> 参考 src/models/user.py 中的User类定义，
> 在 src/services/auth.py 中实现JWT认证逻辑

2.3 及时纠正方向

如果Codex的回答偏离了你的预期，立即纠正，不要继续：

> 你刚才的实现用了SQLAlchemy Core，我项目用的是ORM风格，
> 请改用ORM方式重写

三、自定义技能包

3.1 创建技能包目录结构

mkdir -p .codex/skills/my-team/
touch .codex/skills/my-team/skill.json
touch .codex/skills/my-team/prompt.md

3.2 编写skill.json

{
  "name": "my-team-review",
  "description": "我团队专用的代码审查技能",
  "version": "1.0.0",
  "triggers": ["review", "审查"],
  "prompt_file": "prompt.md",
  "examples": [
    "review src/api/user.py",
    "审查以下代码：[paste code]"
  ]
}

3.3 编写prompt.md（核心）

你是一个有10年经验的后端工程师。审查代码时：

1. 安全性优先：检查SQL注入、XSS、敏感信息泄露
2. 性能其次：N+1查询、不必要的循环、同步阻塞
3. 可读性：命名规范、函数长度、嵌套深度
4. 本项目规范：
   - 使用async/await，禁止同步阻塞
   - 所有数据库操作通过repository层
   - 错误处理统一返回{success, data, error}

输出格式：
### 问题1：[严重/一般/建议]
**位置**：文件名:行号
**问题**：具体描述
**建议**：修复方案

3.4 加载自定义技能包

# 临时加载（当前会话有效）
codex skill load .codex/skills/my-team/

# 永久加载（写入配置）
codex config add skill_path .codex/skills/my-team/

# 查看已加载技能
codex skills list

四、模型选择策略

4.1 不同任务用不同模型

任务类型	推荐模型	原因
简单代码生成（函数级别）	GPT-4.1 mini	速度快、成本低，质量够用
复杂重构（跨文件）	GPT-4.1	上下文大、推理能力强
数学/算法问题	Claude Opus 4.8	推理能力强， hallucination少
超大项目理解（>50个文件）	GPT-4.1 128K	上下文窗口最大

4.2 在Codex中切换模型

# 查看可用模型
codex models list

# 临时切换（当前会话）
/model gpt-4.1

# 为特定任务指定模型
codex --model claude-opus-4.8 "解释这段递归算法的复杂度"

# 写入配置（永久）
codex config set default_model gpt-4.1

4.3 成本优化建议

• 日常开发用GPT-4.1 mini，成本只有完整版的1/20
• 关键架构决策才用GPT-4.1或Claude Opus
• 启用cache_prompt减少重复计费
• 定期清理不需要的会话，释放上下文占用

五、高级技巧汇总

5.1 代码解释增强

# 不仅解释"是什么"，还要解释"为什么"
> 解释src/auth/jwt_handler.py中的decode_token函数，
> 重点说明：为什么用try-except包裹jwt.decode？不包会有什么后果？

5.2 批量处理

# 一次性让Codex处理多个文件
> 检查以下文件的性能问题：
> - src/api/user.py
> - src/api/order.py  
> - src/services/payment.py

5.3 与Git Blame联动

> 运行 git blame src/auth/jwt_handler.py，
> 针对每一行代码，告诉我这段代码是谁写的、什么时候写的，
> 并分析当时的上下文（结合commit message）

下篇预告

下一篇是Codex团队使用指南：如何统一管理团队的Codex配置、共享技能包、设置使用配额、审计AI生成代码——适合技术Leader和团队负责人。

📌 OpenAI Codex实战指南系列：①开篇介绍 → ②安装配置与快速上手 → ③核心功能详解 → ④工作流集成 → ⑤高级技巧（本篇） → ⑥团队使用指南 → ⑦实战案例