AGENT 使用指南 / Codex
Codex X 今天看啥 安装与使用指南
Codex 是 OpenAI 的 AI 助手,可通过自然语言完成开发任务。接入今天看啥后,你也可以直接查询订阅更新、阅读文章并整理观点。
说明核对:客户端界面与系统要求以官方当前版本为准。
01安装 Codex 并登录
初次使用建议从桌面客户端开始。官方当前桌面文档使用 ChatGPT desktop app 名称,安装后在应用内选择 Codex;已有 Codex 客户端的用户可以继续使用。
- 打开 OpenAI 官方桌面安装页,按系统选择下载入口并完成安装。
- 打开客户端,用自己的 ChatGPT 账号登录。
- 选择 Codex,创建新对话;如需安装本地 Skill,选择可使用本机文件的工作环境,并按提示授予所需权限。
已经在用命令行?可以在 Codex CLI 中继续接入。桌面端、CLI 和 IDE 扩展共享 Codex MCP 配置,但技能加载与进程凭证仍需分别确认。
02接入今天看啥
准备订阅与密钥
- 登录或注册今天看啥账号,确认账号已有订阅。
- 打开 MCP 管理页,获取自己的 MCP 密钥。未生成时先点击「生成 MCP 密钥」,再点击「复制 MCP 密钥」。MCP 密钥与 API 密钥相互独立,不能混用。
让 Codex 按说明完成安装
- 打开 MCP 管理页的「保存密钥到本地」,选择 Codex 实际运行的环境,点击「复制 MCP 密钥保存命令」。
- 在本机终端粘贴并执行保存命令。
- 返回本页,点击「复制安装指令」,将指令发送给 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 配置刷新分别验证。刷新技能列表、文件版本或连接上报版本,都不能单独证明当前对话已经加载新版完整指引。
完成标志:Skill 已加载,MCP 已连接,账户查询成功,九个工具可见。
03在 Codex 中开始提问
连接成功后,在已启用能力的对话中发送。下面的文章标题需要替换成你想读的真实标题。
查看订阅更新
我订阅的专栏最近更新了什么?
阅读并总结文章
请读一下《文章标题》,总结核心观点,并附上原文链接。
比较多篇文章
请阅读《文章标题 A》和《文章标题 B》,比较它们的共同观点、分歧和依据。
内容仅限已订阅专栏;标题关键词搜索范围为最近 365 天。
安装界面参考
Codex 安装攻略截图
按下面两步完成配置与安装,点击图片可查看完整截图。
基础场景参考
Codex 使用攻略截图
从查看更新到阅读正文,看看一句提问会得到什么结果。
示例中的专栏和文章名称,请替换成你已订阅的内容。 预览展示提问与主要结果,点击图片可查看完整截图。
常见问题
安装与使用遇到问题
必须使用 Codex CLI 吗?
可以使用桌面客户端;熟悉终端的用户也可以选择 CLI。按照当前实际使用的客户端接入即可,无需同时安装多个客户端。
安装文件已存在,为什么 Codex 还找不到 Skill?
确认文件名为 SKILL.md,安装目录是当前环境的技能发现目录。优先使用客户端支持的技能刷新,在下一轮显式使用 $jintiankansha 并确认正文加载版本;仍未生效时新建对话,最后才考虑重启应用。没有可用自动刷新入口时,按已确认支持的界面操作完成,不把文件存在当作已加载。
密钥已保存,为什么还提示认证失败?
保存文件与客户端取得凭证是两个步骤。按安装说明完成本地加载或客户端认证,并重启或重新连接。不要把密钥粘贴到对话中;密钥重置后,需要在 MCP 管理页复制新密钥并更新客户端认证;使用本地密钥文件时还需重新执行密钥保存命令。
连接完成,从一条提问开始。
在 Codex 中查看更新,继续阅读、总结和比较文章。