AGENT 使用指南 / Codex

Codex 安装与使用指南

Codex 是 OpenAI 的 AI 助手,可通过自然语言完成开发任务。接入今天看啥后,你也可以直接查询订阅更新、阅读文章并整理观点。

说明核对:客户端界面与系统要求以官方当前版本为准。

01安装 Codex 并登录

初次使用建议从桌面客户端开始。官方当前桌面文档使用 ChatGPT desktop app 名称,安装后在应用内选择 Codex;已有 Codex 客户端的用户可以继续使用。

  1. 打开 OpenAI 官方桌面安装页,按系统选择下载入口并完成安装。
  2. 打开客户端,用自己的 ChatGPT 账号登录。
  3. 选择 Codex,创建新对话;如需安装本地 Skill,选择可使用本机文件的工作环境,并按提示授予所需权限。

已经在用命令行?可以在 Codex CLI 中继续接入。桌面端、CLI 和 IDE 扩展共享 Codex MCP 配置,但技能加载与进程凭证仍需分别确认。

02接入今天看啥

准备订阅与本地密钥

  1. 登录或注册今天看啥账号,确认账号已有订阅。
  2. 打开 MCP 管理页,获取自己的 MCP API Key。
  3. 在「配置到本地」中选择 Codex 实际运行的环境,复制配置命令,在对应的本地终端执行。

命令会将密钥保存到本机。配置命令含密钥,只粘贴到本地终端;不要发送到 AI 对话中。

让 Codex 按说明完成安装

我正在使用 Codex,已通过 MCP 管理页的配置命令将 MCP API Key 保存到本地。请按照这个链接安装今天看啥 Skill,并引导当前客户端使用已保存的密钥连接 MCP,最后验证连接是否成功:http://mcp.jintiankansha.me/skill/skill-install.md

查看安装说明 ↗

Codex 会安装 今天看啥 Skill,并配置自己的 MCP 连接。如果提示刷新技能、重启客户端或开启新对话,完成后发送「请继续验证今天看啥连接」。

手动配置参考:Skill 与 MCP 的位置

个人 Skill 默认保存为 ~/.agents/skills/jintiankansha/SKILL.md;Windows 原生环境位于用户目录下的 .agents\skills\jintiankansha\SKILL.md。已有自定义技能目录时沿用当前设置。

MCP 用户配置默认为 ~/.codex/config.toml;设置了 CODEX_HOME 时以实际配置目录为准。合并以下配置,保留其他服务器:

[mcp_servers.jintiankansha]
url = "http://mcp.jintiankansha.me/mcp"
bearer_token_env_var = "JINTIANKANSHA_API_KEY"

JINTIANKANSHA_API_KEY 是本地环境变量名。保存密钥文件后仍需按安装说明让 Codex 进程取得该变量;桌面应用不一定继承终端环境。

官方 MCP 配置说明 · 官方 Skill 目录说明

完成标志:Skill 已加载,MCP 已连接,账户查询成功,九个工具可见。连接验证使用不扣额度的账户查询;首次阅读文章才会使用相应内容额度。

03在 Codex 中开始提问

连接成功后,在已启用能力的对话中发送。下面的文章标题需要替换成你想读的真实标题。

查看订阅更新

我订阅的专栏最近更新了什么?

阅读并总结文章

请读一下《文章标题》,总结核心观点,并附上原文链接。

比较多篇文章

请阅读《文章标题 A》和《文章标题 B》,比较它们的共同观点、分歧和依据。

内容仅限已订阅专栏;标题关键词搜索范围为最近 365 天。AI 工具自身的用量与 MCP 额度分别计算。

安装界面参考

Codex 安装攻略截图

按下面两步完成配置与安装,点击图片可查看完整截图。

01 / 在本地终端执行配置命令,保存 MCP API Key
01 / 在本地终端执行配置命令,保存 MCP API Key
02 / 在 Codex 中发送安装指令,确认 Skill 与 MCP 已就绪
02 / 在 Codex 中发送安装指令,确认 Skill 与 MCP 已就绪

使用场景参考

Codex 使用攻略截图

从查看更新到阅读正文,看看一句提问会得到什么结果。

示例中的专栏和文章名称,请替换成你已订阅的内容。 预览展示提问与主要结果,点击图片可查看完整截图。

Codex 查看全部订阅更新的提问与返回结果
01

查看全部订阅更新

按时间汇总不同专栏的最新文章,快速找到想读的内容。

我订阅的专栏最近更新了什么?

Codex 查看指定专栏的提问与返回结果
02

查看指定专栏

聚焦一个已订阅专栏,查看最近发布的文章列表。

看看「中国基金报」最近有哪些文章。

Codex 按关键词找文章的提问与返回结果
03

按关键词找文章

从已订阅内容中搜索标题,结果包含专栏与发布日期。

Codex 阅读正文并提炼观点的提问与返回结果
04

阅读正文并提炼观点

选定文章后,阅读正文并整理观点和支撑依据。

阅读《一张图看懂 AI Agent 的工作原理》,整理 3 个核心观点和支撑依据。

常见问题

安装与使用遇到问题

必须使用 Codex CLI 吗?

可以使用桌面客户端;熟悉终端的用户也可以选择 CLI。按照当前实际使用的客户端接入即可,无需同时安装多个客户端。

安装文件已存在,为什么 Codex 还找不到 Skill?

确认文件名为 SKILL.md,安装目录是当前环境的技能发现目录。刷新技能或重启客户端,必要时开启新对话,并让 Codex 确认已加载 jintiankansha。

密钥已保存,为什么还提示认证失败?

保存文件与客户端取得凭证是两个步骤。按安装说明完成本地加载或客户端认证,并重启或重新连接。不要把密钥粘贴到对话中;密钥重置后,需要在 MCP 管理页重新执行配置命令并更新客户端认证。

为什么找不到文章或提示额度不足?

先确认文章所属专栏已订阅,再检查会员权限与额度。关键词只搜索最近 365 天的标题;已知完整标题时可让 AI 定位文章。查看 会员与额度,个人额度以 MCP 管理页为准。

连接完成,从一条提问开始。

在 Codex 中查看更新,继续阅读、总结和比较文章。

返回 Agent 使用指南 ↗