AGENT 使用指南 / Codex

Codex X 今天看啥 安装与使用指南

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 密钥。未生成时先点击「生成 MCP 密钥」,再点击「复制 MCP 密钥」。MCP 密钥与 API 密钥相互独立,不能混用。

让 Codex 按说明完成安装

  1. 打开 MCP 管理页的「保存密钥到本地」,选择 Codex 实际运行的环境,点击「复制 MCP 密钥保存命令」。
  2. 在本机终端粘贴并执行保存命令。
  3. 返回本页,点击「复制安装指令」,将指令发送给 Codex。

保存命令只把密钥保存为本地文件,不会自动设置环境变量或连接客户端。命令含密钥,只粘贴到本地终端;不要发送到 AI 对话中。

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

查看安装说明 ↗

发送安装指令后,按 Codex 的提示完成操作,再发送「请连接今天看啥 MCP,并查询我的账户信息,确认连接是否成功。」

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

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

MCP 用户配置默认为 ~/.codex/config.toml;设置了 CODEX_HOME 时以实际配置目录为准。按安装说明让客户端加载已保存的密钥;已有有效认证时继续复用。

进阶:环境变量配置(已设置变量时使用)

第一次连接 Codex:请跳过本节,点击“按步骤安装”,完成密钥保存和连接配置。

已设置环境变量的用户,可以使用下面的配置。JINTIANKANSHA_API_KEY 请原样保留,不要替换成 MCP 密钥。

设置位置填写内容
Codex 配置中的 bearer_token_env_var"JINTIANKANSHA_API_KEY",原样保留
环境变量名称JINTIANKANSHA_API_KEY
环境变量的值从 MCP 管理页复制的 MCP 密钥
[mcp_servers.jintiankansha]
url = "http://mcp.jintiankansha.me/mcp"
bearer_token_env_var = "JINTIANKANSHA_API_KEY"
http_headers = { "X-Jintiankansha-Skill-Version" = "1.0.16", "X-Jintiankansha-Client-Name" = "codex" }

保存配置后,将下面这句话发给 Codex:

请连接今天看啥 MCP,并查询我的账户信息,确认连接是否成功。

排查连接问题

示例中的 Skill 版本头仅在成功安装该版本后填写;已有安装填写实际安装版本,无法确认时省略。保留认证和其他自定义请求头,更新后重新连接 MCP。 客户端实际版本按安装说明确认后补充,无法确认时省略,不用 Skill 版本代替。

环境变量的值是 MCP 密钥本身,不加 Bearer 。保存密钥文件后仍需按安装说明让 Codex 进程取得该变量;桌面应用不一定继承终端环境。若进程尚未取得新变量,仅重连无法补齐;支持的原生认证或文件 helper 可通过重连加载凭证,具体方式见 安装说明。

安装或更新后,优先按当前客户端支持的方式刷新技能、重载配置或重连 MCP,再在下一轮显式使用技能并验证;必要时新建对话,最后才考虑重启应用。

Skill 正文加载与 MCP 配置刷新分别验证。刷新技能列表、文件版本或连接上报版本,都不能单独证明当前对话已经加载新版完整指引。

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

完成标志:Skill 已加载,MCP 已连接,账户查询成功,九个工具可见。

03在 Codex 中开始提问

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

查看订阅更新

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

阅读并总结文章

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

比较多篇文章

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

内容仅限已订阅专栏;标题关键词搜索范围为最近 365 天。

安装界面参考

Codex 安装攻略截图

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

01 / 在本地终端执行密钥保存命令
01 / 在本地终端执行密钥保存命令
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,安装目录是当前环境的技能发现目录。优先使用客户端支持的技能刷新,在下一轮显式使用 $jintiankansha 并确认正文加载版本;仍未生效时新建对话,最后才考虑重启应用。没有可用自动刷新入口时,按已确认支持的界面操作完成,不把文件存在当作已加载。

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

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

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

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

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

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

返回 Agent 使用指南 ↗