科研小白 Codex 安装入门:从下载到连上 Zotero MCP,一篇走通

大家好，这里是Zotero中文网。

如果你已经在用 Zotero 管论文，又想试试 Codex，可以试试按本文的指南配置。

在 Windows / Mac 上把 Codex 装好，再把 Zotero 通过 MCP 接入，最后跑一句测试，让你看到自己的文献条目真的能被 AI 读取。

Codex 是干什么的

可以把 Codex 理解成一个能在本机文件夹里工作的 AI 助手。

它不只是聊天窗口。它可以读取你指定的项目目录，帮你整理文件、改脚本、跑命令、检查结果。OpenAI 官方现在把 Codex 分成几种入口：桌面 App、命令行 CLI、IDE 扩展，以及云端任务。

对普通科研用户来说，推荐使用 桌面 App 门槛最低。

下载入口：

1. 官网：https://developers.openai.com/codex/app

2. 微软应用商店搜索 Codex

3. 国内镜像：

4. 夸克网盘汇总：https://pan.quark.cn/s/8619b2036bde

5. Windows：https://codexapp.agentsmirror.com/latest/win
6. Mac：
1. apple芯片 https://codexapp.agentsmirror.com/latest/mac-arm64
2. intel芯片 https://codexapp.agentsmirror.com/latest/mac-intel

初步尝试：

1. 打开上面的官方页面，下载 Windows 版 Codex App。
2. 安装后打开，用 ChatGPT 账号或 OpenAI API Key 登录 或 使用ccswitch[https://github.com/farion1231/cc-switch] 来使用国内的API。

3. 这一篇先给大家讲如何把这个流程搭起来，我们下一篇文章将给大家详细讲如何基于 C C switch 来使用国产的模型，比如 Deepseek、glm 之类的。

4. 选择一个你愿意让 Codex 工作的文件夹。
5. 新建一个任务，先问它："请看一下这个目录里有什么文件。"

能看到文件，第一步就算通了。

MCP 是什么

MCP 的全称是模型上下文协议

你可以把 Zotero 想成自己的小图书馆，里面有论文、PDF、笔记、标签和引用信息。Codex 默认并不知道这个图书馆里有什么。

MCP 就像给这个图书馆开了一扇门。装好对应的 MCP 服务以后，Codex 就能通过这扇门问 Zotero：最近有哪些文献、某篇论文的标题是什么、附件和笔记在哪里。

Zotero MCP 选哪个

现在 Zotero 相关的 MCP 项目不止一个。

这篇先用比较常见的 cookjohn/zotero-mcp 做说明。它的定位是把 Zotero 文献库接到支持 MCP 的 AI 助手里，用来查论文、做摘要、分析引用等。

项目地址：https://github.com/cookjohn/zotero-mcp

Zotero MCP 是社区项目，不是 Zotero 官方插件。不同电脑、不同 Python 环境、不同 Zotero 版本，可能会遇到不一样的问题。第一次配置时，目标不要设太高，先让它能列出文献条目。

如果你想开箱即用 可下单我们远程安装配置服务，为你安装配置好，是你开箱即用，节约你的时间。

最小配置思路

第一，Zotero 桌面端已经安装，并且能正常打开。

第二，电脑上已经有 Python 和 uv。uv 是 Python 包和命令行工具管理器，很多 MCP 项目会用它来运行。

第三，Codex 已经能正常登录。

怎么在 Codex 里添加

直接在 Zotero 插件商店里搜索 Zotero MCP  点击安装即可。然后按照插件的引导配置 点击启用服务器。的 将 复制出来的 配置和说明两段文本都发给 codex 授予它全局访问权限即可。

第一次测试，不要问太复杂

第一次不要直接问："帮我读完 Zotero 里所有文献，写一篇综述。"

先问一个很小的问题：

请列出我 Zotero 文献库里最近添加的 5 条文献，只要标题、作者和年份。

如果能返回结果，就说明最基本的连接已经通了。

下一步再问：

请找一篇标题里包含 machine learning 的文献，并告诉我它有没有附件。

如果这一步也通了，再考虑让它读摘要、整理笔记、筛选主题。

常见卡点

最常见的是 Zotero 没开。

很多本地方案都需要 Zotero 桌面端正在运行，服务才能访问本地数据。先打开 Zotero，再重启 MCP 服务。

第二个是 Codex 配置写错。

TOML 对缩进没有 YAML 那么敏感，但括号、引号、表头写错，还是会导致服务加载失败。改完以后不要连着乱试，先保存、重启、看报错。

第三个是 API Key 和本地模式混在一起。

如果你走本地 Zotero，就先按本地模式跑通。等本地可以读，再考虑 Zotero Web API。不要一开始把本地、云端、Docker、远程库全混在一起。

这条线跑通以后能做什么

最实用的不是让 AI "直接写论文"。

更稳的是这些小任务：

• 列出某个主题下最近添加的文献；
• 根据 Zotero 标签整理阅读清单；
• 查某篇文献有没有 PDF 附件；
• 把某个集合里的论文整理成表格；
• 给一批文献生成组会阅读顺序。

这些任务看起来不惊艳，但真的省时间。