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