Codex初学食用说明

本文经作者授权后转发，供参考学习

用Codex最该先知道的基础概念

1.工作区/当前文件夹

2.读取文件

3.写入文件/修改文件

4.工具调用

5.终端/命令行

6.沙盒/权限

7.网络访问

8.Git

9.远程仓库

10. .gitignore

11. .agents

12.脚本

13.依赖/环境

14.Markdown

15.README

16.绝对路径/相对路径

17.临时文件

18.skill

1. 工作区/当前文件夹

就是Codex当前能看到、能处理的项目目录。

2. 读取文件

Codex可以查看工作区里的文件内容，用来理解项目、修改文档、分析数据。但对医学资料要注意：如果让Codex读取原始敏感文件，内容可能会被发送到模型服务处理。高敏数据建议先本地脱敏。

更稳妥的做法是：让codex帮你写一个本地脱敏工具，先在本地生成脱敏文件，然后再让codex分析脱敏后的文件。

也就是说，敏感医学资料建议按这个顺序：原始文件→本地脱敏→脱敏副本→分析/写论文/做报告

3. 写入文件/修改文件

Codex可以在允许的目录里新建、修改文件。

可以明确和codex说：不要覆盖原文件；只生成副本；修改前先告诉我会动哪些文件

4. 工具调用

Codex不只是聊天，它可以调用本地工具完成任务，例如：

· 查看文件列表

· 运行数据处理脚本

· 生成Excel/Word/图表

· 检查代码或文档

· 做Git版本管理

你看到它“正在运行命令”时，大多是在本机工作区里操作。

5.终端/命令行

终端就是让电脑执行具体操作的地方。比如查文件、运行程序、处理表格。你不需要自己会命令行，可以直接用自然语言让codex做。

6.沙盒/权限

沙盒是安全边界。它限制Codex能访问和修改哪些文件。通常Codex只能操作当前工作区，不能随意改电脑其他地方的文件。

如果某个操作需要更高权限，系统会要求你确认。

7.网络访问

Codex有时可以联网查资料，有时网络被限制。你如果处理隐私资料，可以明确说：不要联网；只在本地处理；不要上传第三方服务

但要注意：你和Codex对话、让我读取文件，本身仍可能经过OpenAI服务处理，不等于完全离线。

8.Git

Git是版本管理工具。作用是保存项目历史，方便撤销。

常见词：

· git init：把当前文件夹变成可版本管理的项目。

· git add：把改动放进“准备保存区”。

· git commit：正式保存一个版本。

· git status：查看哪些文件改了。

· .git：Git的隐藏文件夹，保存历史记录。

你可以把Git理解成“项目存档系统”。

9.远程仓库

远程仓库就是GitHub、Gitee等网上仓库。本地有.git不代表上传了；只有执行“推送”之后，才会上传到远程仓库。

关键词：

· push：上传到远程仓库。

· pull：从远程仓库拉取更新。

· remote：远程仓库地址。

医学资料项目要特别小心，不要把原始数据推到远程仓库。

10. .gitignore

这是告诉Git“哪些文件不要纳入版本管理”的清单。例如可以把原始病例数据、脱敏前Excel、临时文件排除掉。

但注意：.gitignore只影响Git，不会阻止Codex读取文件。

11. .agents

这是Codex/代理系统可能生成的本地状态文件夹。一般用于记录任务状态或内部协作信息。它不是你的医学资料，也不是Git历史。

12.脚本

脚本就是一小段自动化程序。例如“批量脱敏Excel”“生成统计表”“整理随访记录”。它可以反复运行，比手工操作稳定。

13.依赖/环境

依赖就是脚本运行需要的工具包。比如处理Excel可能需要Python的表格库。环境就是这些工具是否已经安装好。

你不需要掌握细节，但如果运行失败，常见原因就是“缺少依赖”。

14.Markdown

Markdown是一种轻量文档格式。常用于写说明、报告草稿、项目记录。文件名常见为：README.md、说明.md

15.README

README是项目说明书。它通常写：

· 这个项目做什么

· 文件结构

· 怎么运行

· 数据放哪里

· 注意事项

你的项目可以建一个README，避免以后自己也忘了结构。

16.绝对路径/相对路径

绝对路径是完整地址：D:\xx疾病\随访数据.xlsx

相对路径是相对于当前文件夹的地址：随访数据.xlsx

给codex文件位置时，绝对路径最清楚。

17.临时文件

很多软件会生成临时文件，比如Word、Excel、Codex、统计软件。它们不一定有用，也不一定要纳入Git。常见处理方式是放进.gitignore。

18.skill

Codex 里的 Skill 可以理解成“可安装的专项能力包”，例如专门处理图片、安装插件、查 OpenAI 文档、生成某类项目模板等。

现阶段可以先不用自己研究目录结构，直接让codex做：帮我列出当前可安装的 Codex skills，并标出哪些已经安装。

然后从列表里选，codex再安装。安装任何新 Skill 前，它会告诉你它来自哪里、是否需要联网、安装后是否需要重启。

Take-home message

第一，涉及临床数据时，优先说：不要覆盖原文件，先脱敏，生成副本。

第二，涉及项目修改时，优先说：修改前先说明会改哪些文件，修改后告诉我怎么撤销。

第三，涉及上传风险时，优先说：不要联网，不要推送到远程仓库，不要读取原始敏感文件内容，先写本地处理工具。

常用口令：

“让Codex修改文件前的固定口令”：请先说明你准备修改哪些文件、为什么修改、是否会覆盖原文件。未经我确认，不要删除、移动、覆盖原始文件。

“结果如何检查”：处理Excel后，要抽查几行；脱敏后，要搜索姓名、手机号、身份证号是否残留；统计分析后，要核对样本量、缺失值、分组是否正确；论文引用要人工核对题名、期刊、年份、DOI。

常用提问模板：

-请先只阅读文件结构，不要修改任何文件。

-请生成副本，不要覆盖原文件。

-请帮我检查这个Excel是否适合做统计分析，先不要改数据。

-请把这个研究问题整理成：研究目的、研究对象、观察指标、统计方法。

-请帮我写一份README，说明这个项目的文件结构和使用方法。

今天，你学习了吗？

谢谢你的推荐，祝你学有所获♥