如果你最近在用 Codex 做科研，大概率已经有过一种很别扭的感觉。

今天问它综述怎么搭结构，明天贴一段数据问怎么分析，后天再让它帮你改摘要。乍一看它什么都能答，但来回几轮之后，你会发现一件事：它总像一个临时拉进群的实习生，每次都要你重新交代背景，最后产出的东西假大空，你还是得自己大改。

很多人第一反应是，模型还不够聪明。 其实真不是。

Codex 在科研场景里最常见的翻车，不是因为模型不行，而是你把它当成“命令行版 ChatGPT”来用了。开个对话框，想到什么问什么，材料全散在聊天记录里。这样它手头根本没有“现场”——也就是它看不到你的项目文件、背景和规则。没有现场，它就只能靠猜；靠猜，返工就一定会多。

但如果你换个思路，把 Codex 当成一个能读你项目文件、按你写的规则做事、还能回头帮你核查问题的研究协作者，体验会完全不一样。

我把 OpenAI 的 Codex 官方最佳实践，以及最近不少人开始关注的一套学术科研技能包 Academic Research Skills for Codex 都啃了一遍，结合我自己平时折腾论文的血泪史，整理了这篇实操。

不讲大道理，直接上干货，教你一步步把这个工具配好、用对。

第一部分：别急着打字，先在本地把规矩立了

相信我，不建个规矩，聊到第十轮你就会找不到之前的文献，AI 也会开始胡言乱语。

要让 Codex 真正进入你的研究流程，第一步是给它一个清晰的工作区，把材料放到固定位置。最简单可以长这样：

my-research/
├── AGENTS.md
├── research-question.md
├── literature/
├── data/
├── drafts/
└── outputs/

这个结构不需要多复杂，重点是让你的研究材料有固定位置。文献笔记放 literature/，草稿放 drafts/。

如果你懒得手动建，直接在 Codex 里选好工作目录后，发一句：

请在这个工作目录下，帮我建一套学术研究用的文件夹结构：literature/ 放文献笔记，data/ 放数据分析，drafts/ 放论文和报告草稿，outputs/ 放最终交付；再建一个 research-question.md 记录研究问题和进展。先只建空目录和文件，不要写内容。建完告诉我每个文件夹打算放什么。

目录建好后，最关键的一步来了：写 AGENTS.md。

它是 Codex 会自动读取的一份规则文件。你可以把它理解成你给 AI 定的“员工守则”。

很多人容易把这个文件写成口号，比如“请认真严谨地协助我”。这种话对模型来说等于废话。

我们要写具体的行为约束。比如我个人最常用的一条规则是：“如果我没提供具体页码，绝对不要在引用里编造页码，宁可留空。”这一条帮我省了无数次核对文献的时间。

你可以直接抄我这个学术场景的最小可用版本：

# AGENTS.md

## 角色
你是我的学术研究协作助手。不编造事实，不虚构引用，不替我做最终学术判断。

## 工作边界
- 所有文献结论必须能回到 literature/ 中的笔记或我提供的来源。
- 不编造论文、作者、DOI、期刊名、页码。如果我没提供具体页码，绝对不要在引用里编造页码，宁可留空。
- 证据不足的地方标记为“待核实”，不要补写成确定结论。
- 写草稿前，先确认研究问题、方法、材料是否足够。
- 不一次性重写全文，先给修改计划。

## 文件规则
- 文献笔记放 literature/
- 草稿放 drafts/
- 最终导出放 outputs/

规则尽量短，遇到重复错误再往里补。边界立住了，你才敢信它后面的产出。

第二部分：逼它反问你，直到把选题范围缩到极窄

这是写作型研究里最容易踩的大坑。

很多人手里只有一个模糊主题，比如“我想研究 AI 对写作的影响”，就直接让 AI 写大纲、写正文。结果就是它在一个根本没收敛的问题上，帮你写出一篇结构看起来完整、但方向其实发虚的废话。

在 Codex 里，最好的做法不是让它赶紧写，而是先让它问你。

你可以直接用这段指令：

请先用提问的方式帮我收敛研究问题。一次只问一个问题，并在每个问题后写一句“这个问题会影响什么决策”。先不要给方案，也不要写大纲。我的初始主题是：AI 工具对研究生论文写作训练的影响。

它可能会反问你：你更关心“写作质量有没有提升”，还是“写作能力是如何被训练出来的”？

别小看这种问题。前者可能走实验评估，后者可能要走教学设计或访谈，方法完全是两条路。先把模糊方向逼成可研究的问题，远比抢着出草稿重要。

当你要给它派具体任务时，记住交代清楚四件事：目标、上下文、约束、完成标准。

比如，不要说“帮我整理一下这些文献”，换成这样：

目标：从 literature/ 目录下的笔记中找出关于“AI 写作训练”的研究空白。

上下文：相关文献笔记都在 literature/ 文件夹。

约束：只允许使用现有笔记中的文献，不准新增引用，不准编造来源。

完成标准：输出三部分，分别是“已被充分研究的”、“存在争议的”、“几乎没人系统做过的”。

这样一来，它就很难糊弄你，因为任务边界已经被你框死了。

第三部分：给 Codex 装上一套学术科研技能包 ARS

当你熟悉了上面的工作流，你会发现自己开始需要更专业的学术工具，比如系统查文献、模拟审稿。

这时候，你可以给 Codex 装上 Academic Research Skills（简称 ARS）技能包。

这套工具最让我受用的一点是：它不是替你写论文的自动驾驶，而是帮你干脏活累活的副驾驶。它能帮你搜材料、搭结构、查逻辑、排格式、补审稿视角。至于研究问题怎么定义、数据怎么解释，这些最终决策还是在你手里。

这里必须先提醒一句：ARS 有两个版本。原版是给 Claude Code 设计的，如果你在 Codex 里用，应该装的是 Codex 原生打包版，仓库名叫：academic-research-skills-codex。装错版本的话，后面调用各种报错，非常折腾。

怎么安装？

如果你用的是 Codex App，连终端都不用切，直接在对话里让 Codex 跑官方安装器就行。

把下面这段发给它：

python "$HOME/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
--repo Imbad0202/academic-research-skills-codex \
--ref main \
--path skills/academic-research-suite \
--method git

配上一句：

请帮我安装 academic-research-skills-codex 这个 skill。用官方安装器跑上面这条命令。装完告诉我结果。

运行时它会请求你确认执行命令，点同意即可。

演示环境与配置说明

在配置此类工具时，很多人卡在 API 登录或网络环境上。

工具在进行自定义模型服务配置或使用 OpenAI Compatible API 时，主要关注三个核心字段：Base URL、Key 和 Model。

在实际配置时，你可以参考如下固定配置块：

Base URL：https://token.ithinkai.cn/v1
Key：YOUR_KEY
Model：以服务文档为准，最新模型 gpt-5.5、claude-opus-4-8、
gpt-image-2 等可按文档查看；涉及图片生成时，以 0.05¥/图起、2k/4k 支持等服务文档说明为准。

装完怎么验证？

在新对话里输入 /skills，看看当前能识别到哪些 skill。

重点只看一件事：列表里应该只能看到一个 ARS 相关条目（通常是 academic-research-suite）。如果你看到一堆散装的条目（如 academic-paper、deep-research），说明版本装混了，建议删了重装。

怎么调用？

最稳妥的调用方式，就是在对话里显式写出 $academic-research-suite，然后直接描述你的任务。

比如：

Use $academic-research-suite to help me plan a systematic literature review on AI adoption in higher education quality assurance.

它会根据你的描述，把任务自动路由到最合适的工作流。

不过这里也要泼一盆冷水：虽然 ARS 很好用，但它对中文文献的检索能力依然很弱。遇到知网导出的文献，你最好还是手动转成 Markdown 格式喂给它，别指望它能一键帮你搞定所有中文综述。

避坑与排错指南

折腾这套系统，有几个高频报错你迟早会遇到，提前存好这套排错方案：

这通常是路径没配对。在 App 设置里检查 Skills Path 是否指向了正确的 $HOME/.codex/skills/ 目录。如果改了路径，记得重启 App 刷新缓存。

1. 调用 Skill 时提示 Command not found 或无响应

ARS 的联网检索依赖外部学术 API。如果你没配特定的 API Key，它走的是公共接口，很容易被限流。建议在 AGENTS.md 里明确限制它只检索本地 literature/ 目录下的已有 PDF 或 Markdown 笔记。

1. 文献检索时返回一堆 403 Forbidden

这是典型的上下文爆了。学术对话很容易变长，建议一个连贯任务只在一个独立线程里聊。文献整理开一个线程，草稿写作开另一个线程。不要一个窗口从头聊到尾。

1. 对话到后期，Codex 开始“胡言乱语”或遗忘前文

说白了，工具可以帮你少返工、少翻车，但问题意识、证据判断、最终署名和责任，永远都在你自己手里。