先定目标：不要一上来就让 Codex 改全项目

很多人第一次把 Codex 接到中转站后，会直接抛出一句“帮我优化整个项目”。这类任务听起来省事，实际很容易失控：上下文太大、目标不清、文件范围不明，最后生成的结果很难验证。

更稳的方式，是把一次 Codex 任务控制在一个明确目标内。例如修复一个报错、补充一个接口、重构一个模块、生成一份测试报告。目标越具体，中转 API 的消耗越可控，结果也越容易验收。

• 目标明确：这次只解决一个问题。
• 范围明确：指定文件、目录或模块。
• 边界明确：哪些文件不能动，哪些命令不能执行。
• 验收明确：用测试、截图、日志或输出文件判断是否完成。

第一步：确认灵能API线路适合当前任务

不同项目任务对模型能力和响应速度的要求不一样。轻量问答、错误解释、单文件修改，可以选择响应更快的模型；涉及跨目录理解、长代码**、复杂重构时，再切换到上下文更强的模型。开始前先进入灵能API入口确认模型和账户状态：https://www.lnsns.com/

如果这次任务只是修一个小 *ug，不必直接使用最重的模型。把模型能力和任务难度匹配起来，才是长期使用灵能API更舒服的方式。

• 轻量任务：优先响应速度和成本可控。
• 复杂任务：优先上下文能力和稳定性。
• 长任务：提前确认额度，避免中途被打断。

第二步：在 CC Switch 里准备项目专用卡

项目实战不建议长期混用同一张配置卡。你可以为不同项目建立不同卡片，例如“灵能API-Codex-前端项目”“灵能API-Codex-后端服务”“灵能API-Codex-文档整理”。这样用量、模型和排错记录都更容易追踪。

项目卡不是越多越好，但至少要把“日常开发”和“排错测试”分开。前者追求稳定工作，后者用于验证线路，互不干扰。

• 卡片名称写清楚项目和用途。
• 模型选择与项目任务类型匹配。
• 备注里记录创建日期和适用场景。
• 不要把测试 Key 和正式项目 Key 混在同一张卡里。

第三步：把需求写成可执行任务单

给 Codex 的需求不要只写结论，要写清楚**、目标、输入、输出和限制。这样它能先分析，再给计划，而不是直接开始改文件。

任务**：用户列表页筛选条件失效
目标：修复状态筛选，并补充最小测试
允许读取：src/pages/users、src/api/users.ts、tests/users
禁止修改：支付模块、登录模块、数据库迁移文件
验收方式：本地测试通过，并说明修改点

这一步看似多写了几行，但能明显减少反复沟通。尤其是使用中转 API 处理长项目时，清楚的任务单也能减少无效上下文消耗。

• **告诉 Codex 为什么要做。
• 目标告诉 Codex 做到什么程度。
• 允许范围减少无关文件读取。
• 禁止范围避免误改关键模块。

**步：先让 Codex 输出修改计划

进入真实项目后，不要马上让 Codex 动手改代码。先让它只读分析，输出将要检查的文件、怀疑的问题点、计划修改的位置和验证方法。确认计划合理后，再进入修改阶段。

请先不要修改文件。
阅读我指定的目录后，输出：
1. 你会检查哪些文件
2. 可能的问题位置
3. 准备如何修改
4. 修改后如何验证
等我确认后再执行。

如果计划里出现无关目录、危险命令或过大的读取范围，先让它缩小范围。计划阶段的几分钟，通常能换来后面几十分钟的稳定执行。

第五步：把真实修改拆成小批次

一次性修改十几个文件，很容易让**和回滚变得困难。建议把 Codex 的工作拆成小批次：先修主逻辑，再补测试，最后整理文档或注释。每一批都能单独检查和验证。

小批次还有一个好处：如果中途遇到超时、限流或响应异常，你能知道任务停在哪一步，不会把整个项目改到一半却不知道该从哪里恢复。

• 第一批：只改核心逻辑，避免顺手重构。
• 第二批：补充最小测试或验证脚本。
• 第三批：整理说明、注释和边界处理。
• **批：根据测试结果做小范围修正。

⚙️ 第六步：命令执行要分级确认

项目实战中，Codex 可能会建议安装依赖、运行测试、执行构建、清理缓存或迁移数据库。不是所有命令都应该自动执行。建议按风险分级：只读命令可以宽松，写入和外部访问必须确认。

你可以让 Codex 先给出命令和原因，再决定是否执行。这样既能利用灵能API中转线路的效率，也不会把项目安全交给一次未经确认的自动操作。

• 低风险：查看文件、列目录、运行只读检查。
• 中风险：本地测试、构建、格式化。
• 高风险：删除文件、写数据库、上传内容、修改生产配置。

第七步：验收不靠感觉，靠测试和差异

Codex 修改完成后，不要只看它的总结。真正的验收应该包括文件差异、测试结果、运行日志和人工检查。尤其是中转 API 长任务，模型可能总结得很顺，但细节仍然需要你确认。

验收清单：
1. 查看修改了哪些文件
2. 阅读关键差异
3. 运行相关测试
4. 检查是否误改无关模块
5. 记录失败点或通过结果

如果测试失败，不要让 Codex 重新大改一轮。先把失败日志贴给它，让它只分析失败原因，再指定小范围修复。

• 差异能看出是否越界修改。
• 测试能验证核心功能是否恢复。
• 日志能定位执行中出现的问题。

第八步：让 Codex 输出交付说明

项目实战的最后一步，是让 Codex 输出一份交付说明。说明不需要很长，但要包括修改点、验证方式、影响范围、未处理风险和后续建议。这样你后面写提交记录或交接给同事时会轻松很多。

请根据本次修改输出交付说明：
- 修改了什么
- 为什么这样改
- 如何验证
- 是否有风险
- 后续建议是什么

这份说明也可以作为团队知识库的一部分。下次遇到类似需求，只要把任务单和交付说明放在一起，就能形成可复用的项目工作流模板。

项目实战中最常见的五个坑

这些坑多数不是工具本身的问题，而是工作流没有设计好。灵能API和 CC Switch 解决的是线路与配置，项目质量仍然要靠清晰任务、边界控制和验收习惯。

• 需求太宽：一次要求优化整个项目，导致上下文和改动失控。
• 范围不清：没有指定允许读取和禁止修改的目录。
• 跳过计划：Codex 直接改代码，后面很难**原因。
• 不跑测试：只看模型总结，不看实际结果。
• 日志泄密：把完整 Key、Cookie 或内部配置贴进记录。

✅ 一份可复用的项目工作流模板

当 Codex 中转站进入真实项目后，效率来自一套稳定流程，而不是一次很长的提示词。把灵能API线路、CC Switch 配置、任务单、计划、执行和验收串起来，Codex 才能从“能回答”变成“能交付”。

• 确认灵能API账户、模型和额度状态。
• 在 CC Switch 中启用项目专用卡。
• 把需求写成**、目标、范围、限制和验收方式。
• 先让 Codex 只读分析并输出修改计划。
• 确认计划后分批执行修改。
• 高风险命令必须人工确认。
• 用差异、测试和日志完成验收。
• 最后输出交付说明，沉淀为下次任务模板。