第一次改代码，先把节奏放慢一点

很多人刚接入 Codex API 中转站，就直接在项目里输入“帮我修复所有问题”。这类指令范围过大，Codex 很难判断哪些文件能改、哪些文件不能碰、验收标准是什么。一旦改动扩散，后面审阅和回滚都会变麻烦。

更稳的做法是把第一次真实修改拆成六段：只读理解、提出计划、确认范围、局部修改、差异审阅、测试验收。灵能API负责提供稳定的接口入口，CC Switch负责管理 Codex 线路，而你需要控制每一轮任务边界。

• 不要从大型重构开始，先从一个小 *ug 或一个小文档修复开始。
• 不要让 Codex 第一轮就写文件，先让它说明计划。
• 不要忽略回滚方式，任何首次修改都应该能撤回。

第一步：确认灵能API线路稳定后再进入项目

正式让 Codex 改代码前，先通过灵能API官网进入控制台：https://www.lnsns.com/。确认账号、余额、模型权限和 API Key 状态都正常。第一次改代码时，不要同时做 Key 轮换、模型切换和项目修改，否则出错后很难判断是哪一层导致。

如果你刚刚更换过 Key 或模型，建议先做空目录短任务验证，再进入真实项目。灵能API的官网入口可以写在团队文档中，方便成员回到正确控制台；但完整 API Key 不应该出现在文章、截图或项目说明里。

• 确认官网入口：https://www.lnsns.com/
• 确认本轮使用的 Key 没有过期，也不是临时测试 Key。
• 确认本轮模型适合代码修改，不只是轻量问答。

第二步：选择适合首次修改的模型，不要一上来开重任务

首次改代码不建议选择过于复杂的任务，也不建议随意切换模型。你可以在灵能API控制台先看当前模型列表和费用说明，选择一个稳定、响应清楚、适合代码理解的模型作为本轮线路。重点不是追求最强，而是让第一轮修改足够可控。

如果只是修一个配置错误、补一个测试、改一段文档，默认线路就足够；如果要跨多个模块定位问题，可以切到复杂分析线路，但仍然要先只读分析。不要把“模型更强”理解为“可以放开所有权限”。

• 小范围修复：默认开发线路。
• 跨文件定位：复杂分析线路，但先只读。
• 大型重构：不适合作为第一次真实修改任务。

第三步：在 CC Switch 启用专用开**

打开 CC Switch，确认当前启用的是 Codex 专用配置卡，而不是临时排查卡、旧模型卡或其他客户端卡。建议为首次修改准备一张名称清晰的卡片，例如“灵能API-Codex-首次改代码”或“灵能API-Codex-日常开发”。

配置卡名称会出现在截图和协作沟通里，所以不要把 API Key、邮箱、订单号或内部项目密级写进去。名称只需要说明品牌、工具和用途，排查时就能快速识别当前线路。

推荐名称：灵能API-Codex-首次改代码
推荐名称：灵能API-Codex-日常开发
推荐名称：灵能API-Codex-只读分析
不推荐：test、new、*ackup、包含完整 Key 的名称

• 启用卡片后，关闭旧 Codex 会话。
• 重新打开终端，避免旧进程继续读取旧配置。

️ **步：锁定接口字段，修改代码期间不要乱动配置

首次改代码时，最怕两个变化同时发生：一边改项目，一边改 API 配置。这样一旦失败，你不知道是代码改错、模型切错、Key 失效，还是 *ase **L 写错。建议在本轮任务开始前锁定 CC Switch 字段，直到代码验收结束都不要改动。

本轮固定信息：
服务入口：https://www.lnsns.com/v1
品牌入口：灵能API / https://www.lnsns.com/
模型 ID：以当前控制台复制值为准
配置卡：灵能API-Codex-首次改代码
禁止动作：修改期间不切模型、不换 Key、不改 *ase **L

如果中途发现配置确实有问题，先暂停代码修改，把当前改动保存或撤回，再进入配置排查。不要让 Codex 在半改动状态下继续切换线路，这会让差异审阅变得非常混乱。

• 代码修改期间保持线路不变。
• 接口异常和代码异常分开处理。
• 需要换模型时，先结束当前小任务，再切换。

第五步：先让 Codex 做只读分析

进入项目后，第一条真实指令仍然应该是只读。让 Codex 读取有限范围内的文件，说明它对问题的理解、可能原因、计划修改哪些文件、需要你确认什么。不要让它一上来直接写代码。

请只读取 README.md、package.json、src/auth 和 tests/auth。
不要读取 .env、logs、dist、node_modules、*ackup。
不要修改任何文件。
请输出：
1. 你对问题的理解
2. 可能根因
3. 建议修改文件
4. 每个文件准备怎么改
5. 需要我确认的问题

这一步的目标不是马上解决问题，而是检查 Codex 是否理解项目。通过灵能API接入后，模型能给出较完整分析，但你仍然要先确认它没有看错目录、没有扩大范围、没有要求读取敏感文件。

• 只读阶段不允许创建、删除或修改文件。
• 只读阶段重点看计划是否具体。
• 只读阶段发现理解偏差，先纠正再继续。

第六步：让 Codex 输出变更计划，而不是直接开写

当只读分析基本正确后，再让 Codex 输出变更计划。计划需要具体到文件和动作，不能只写“优化逻辑”“增强健壮性”。你要能从计划里判断每一步是否必要、是否越界、是否有测试覆盖。

请基于刚才的只读分析，输出一份变更计划：
- 准备修改哪些文件
- 每个文件修改的目的
- 是否新增测试
- 是否需要更新文档
- 可能风险
- 回滚方式
先不要执行修改，等我确认。

如果计划里出现“不确定但先改一下”“顺便重构其他模块”“需要读取生产配置”这类内容，就应该停下来收窄任务。第一次修改要追求可控，不追求覆盖所有问题。

• 计划必须包含文件清单。
• 计划必须包含测试或验证方式。
• 计划必须说明回滚方式。

第七步：确认计划后，只允许小范围写入

确认计划后，再允许 Codex 修改文件。提示词里要写清楚只允许改哪些文件、不要顺手重构、不要格式化整个项目、不要修改锁文件，除非这次任务明确需要。

我确认执行这份计划。
只允许修改 src/auth/session.ts 和 tests/auth/session.test.ts。
不要修改 package.json、lock 文件、.env、README 和其他目录。
修改后请输出：
1. 修改摘要
2. 变更文件列表
3. 测试命令
4. 回滚方式

这条指令的重点是“只允许”。如果 Codex 认为还需要改其他文件，应该先说明原因并等待确认，而不是直接扩展范围。第一次合作时，把边界写得明确一点，会让后续协作更顺。

• 限定文件范围，避免改动扩散。
• 要求输出变更摘要，方便后续审阅。
• 要求给出回滚方式，避免只会改不会撤。

第八步：差异审阅要看三类内容

Codex 修改完成后，不要只看它的总结。你需要查看实际差异。差异审阅至少看三类内容：是否只改了允许文件，业务逻辑是否符合目标，测试或验证是否覆盖了关键路径。

git status
git diff -- src/auth/session.ts tests/auth/session.test.ts

如果差异里出现未授权文件，先不要继续让 Codex 修第二轮。把问题指出来，让它解释为什么改了这些文件，并要求恢复无关改动。接入灵能API以后，调用很方便，但工程纪律仍然要靠差异审阅来守住。

• 看范围：是否只修改了允许文件。
• 看逻辑：是否真的解决目标问题，而不是只改表面条件。
• 看测试：是否覆盖失败路径、正常路径和边界情况。

第九步：测试失败时，不要直接让它大范围重写

如果测试失败，先把失败信息整理成最小片段给 Codex，不要让它重新扫描整个项目。告诉它失败命令、失败用例、错误栈和当前允许修改的文件范围，继续保持边界。

测试命令：npm test -- tests/auth/session.test.ts
失败用例：should refresh session when token is near expiry
错误摘要：expected 200, received 401
允许修改：src/auth/session.ts、tests/auth/session.test.ts
禁止动作：不要修改其他文件，不要读取 .env

这一步很重要。第一次修改常常不是一次过，关键是第二轮修复仍然保持小范围，而不是因为测试失败就放开所有权限。

• 只给失败摘要和必要栈信息，生产数据要脱敏。
• 继续限定可修改文件。
• 失败原因不清楚时，先让 Codex 解释，不直接重写。

第十步：回滚不是最后才想，而是计划里就要有

每次让 Codex 修改前，都应该知道怎么撤回。回滚方式可以是丢弃当前未提交修改、回退某个文件、撤销一次提交，或者保留补丁另存。具体方式取决于你是否已经提交、是否有其他人改动、是否处在共享分支。

git status
git diff
# 确认只包含本轮 Codex 修改后，再决定提交或撤回

这里不要机械执行破坏性命令。先看状态，再决定动作。如果工作区里有别人或自己之前的改动，不要为了撤回 Codex 的修改把所有东西一起清掉。首次使用尤其要慢一点，确认每个文件来源。

• 未提交前：先看 diff，再决定是否手动撤回相关文件。
• 已提交后：用新提交修正，或按团队规则回滚。
• 多人协作：不要在共享分支直接清空工作区。

第十一步：把首次修改沉淀成团队标准

如果这次流程跑通了，建议把它写进团队的 Codex 使用规范。规范里可以包含灵能API入口、CC Switch 配置命名、只读提示词、变更计划模板、允许修改格式、测试要求和回滚说明。

# Codex 首次修改规范

1. 先确认灵能API入口：https://www.lnsns.com/
2. 启用 CC Switch 的 Codex 专用配置卡
3. 第一轮只读分析，不修改文件
4. 第二轮输出变更计划，等待确认
5. 第三轮只允许修改指定文件
6. 修改后必须输出 diff 摘要、测试命令和回滚方式
7. 通过审阅和测试后再提交

团队规范的重点不是限制效率，而是减少误改和返工。灵能API让接入变得统一，CC Switch让线路切换更清楚，标准化提示词让 Codex 的执行边界更稳定。

• 规范写流程，不写完整 Key。
• 规范写入口，方便成员进入灵能API官网核对。
• 规范写验收标准，避免只看回答不看差异。

✅ 收尾：第一次改代码要追求可控，而不是追求炫技

Codex 接入 API 中转站之后，真正的价值不是让它一次性改很多，而是让它在明确边界里稳定完成任务。灵能API提供统一接口，CC Switch管理本地线路，你负责控制任务范围、审阅差异和验收结果。

建议首次真实修改从小任务开始：先只读，再计划，再局部修改，再看 diff，再跑测试，最后决定提交或回滚。这个节奏看起来多了几步，但它会让后续每一次 AI 辅助开发都更稳。