CLAUDE.md

Codex调用方式

基本格式

cd "项目根目录" && /c/Users/y/AppData/Roaming/npm/codex exec "提示词"

注意: 本项目已是 git 仓库，无需添加 --skip-git-repo-check 参数

成功连接的关键经验

1. 使用简短提示词 - 提示词越简短，连接成功率越高

   #  推荐：简短明确
   "请简要总结XXX，用中文回答，不超过100字。"
   
   # 避免：提示词太长容易超时
   "请阅读文件A、B、C，然后分析..."

2. 无需 --skip-git-repo-check

   • 本项目已是 git 仓库
   • 直接调用即可，codex 会自动识别

3. 使用后台运行模式

   • 在Agent工具中设置 run_in_background=True
   • 避免因等待而超时

4. 网络fallback机制

   • codex会自动从WebSocket降级到HTTPS
   • 如果看到"Reconnecting"是正常现象，等待即可

5. 复杂任务分步进行

   • 将复杂任务拆分成多个简单步骤
   • 每步使用简短的提示词

示例

# 快速验证类（推荐）
/c/Users/y/AppData/Roaming/npm/codex exec "用中文简短总结当前项目的核心功能"

# 如果提示词太长，先写入文件
echo "长提示词内容" > tests/prompt.txt
# 然后在提示词中引用文件路径

项目结构维护：

使用不同文件夹来归类不同的文件！保持项目结构整洁清晰！

以下文件夹如果项目目录下没有，则创建！

docs 文件夹：所有用户和agent输出的技术文档和经验总结都放在这里

tests文件夹：所有单独测试或问题验证代码都需要放到这个文件夹

包括但不限于：

• 验证类文件（如 verify_*.txt）
• 测试脚本
• 问题验证代码
• 给codex/agent看的验证提示文件

本机配置说明！

本机CPU为4核8线程， 不要一次性运行多个占用CPU的实验！