夜雨聆风这是一篇给新手看的 Codex 手把手教程。你可以先照着完成安装、登录、接模型、开项目，再把它接进自己的内容生产系统。
如果你最近一直刷到 Codex，但还没有真正打开用过，这篇可以先收藏。
这篇我按“小白能照着操作”的顺序来教你——
先装软件，再登录，再认界面，再建第一个项目，最后再讲怎么把它接进自己的内容生产系统。
你不用一开始就理解所有技术词，先跟着做一遍，安装好 Codex，能让它帮你完成一个小任务，就算真正入门了。
当然，我这段时间用 Codex 最多的地方，已经不止让它回答问题。
我会让它进入我的 Obsidian 资产库，帮我读素材、拆结构、生成初稿、生成配图等，打通整个内容生成流程。
所以这篇除了教你把 Codex 跑起来，也会顺手讲一下：内容创作者怎么把 Codex 当成自己的内容生产工作台。
好，直接开始。
一. 安装 Codex
第一步，先把 Codex 装到电脑上。
你先打开这个入口：
https://developers.openai.com/codex
或者直接打开官方 Quickstart：
https://developers.openai.com/codex/quickstart
进去以后，你会看到 Codex 有几种使用方式：
App：桌面应用，适合新手。 CLI：命令行工具，适合习惯终端的人。 云端任务：偏开发场景，新手可以先跳过。 IDE：在 VS Code、Cursor 这类编辑器里用。
第一次上手，我建议你直接选 App。
因为 App 有界面，能看到项目、对话、权限、输出和文件改动，小白更容易理解。
1.1 Mac 怎么装
打开 Quickstart 页面后，找到 Codex app 这一块。
你会看到 macOS 的下载按钮，一般会分成两种：
Apple Silicon Intel
不知道你的mac属于哪种芯片的，你可以这样看：
点 Mac 左上角苹果图标，选择“关于本机”。
如果里面写的是 M1、M2、M3、M4 这类芯片，就选 Apple Silicon。
如果里面写的是 Intel，就选 Intel。
下载完成后，一般会得到一个安装包。
打开安装包，把 Codex 拖进“应用程序”文件夹。
然后去启动台或者 Finder 的“应用程序”里，找到 Codex，双击打开。
如果系统提示“无法验证开发者”之类的信息，就去系统设置里的“隐私与安全性”看看有没有“仍要打开”的按钮。这个属于 macOS 常见拦截，不代表你装错了。
1.2 Windows 怎么装
如果你是 Windows，打开 Quickstart 里的 Windows 下载入口。
下载完成后，双击安装包。
一路按提示安装。
如果系统弹出“是否允许此应用对设备进行更改”，点允许。
安装完以后，打开开始菜单，搜索 Codex，点开就行。
原文里还提到 Windows 可以用 winget 命令安装。这个适合稍微熟悉命令行的人。
如果你是纯小白，先用安装包方式。
二. 登录、认界面、设成中文
安装好以后，打开 Codex。
第一次打开，它会让你登录。
这里一般有两条路：
第一条，用 ChatGPT 账号登录。
第二条，用 OpenAI API key 登录。
推荐直接用ChatGPT账号登录。没有账号可以去某鱼上搜索codex直充，150左右一个月。
2.1 用 ChatGPT 账号登录
在登录页选择用 ChatGPT 继续。
它会跳到浏览器，让你登录账号并授权。
授权完成后，回到 Codex App。
如果左下角出现你的账号信息，或者界面进入了项目/对话页面，就说明登录成功。
登录成功就可以使用了，每5小时重置一次使用额度。
2.2 用 API key 登录
如果你手里有 OpenAI API key，也可以选 API key 登录。
基本步骤是：
第一步，打开 OpenAI Platform。
第二步，进入 API keys 页面，新建一个 key。
第三步，复制这个 key。
第四步，回到 Codex 登录页，把 key 粘进去。
第五步，提交，等待 Codex 进入主界面。
注意两点。
第一，API key 要复制完整。开头、结尾都不要漏。
第二，用 API key 登录时，有些功能可能没有 ChatGPT 账号登录那么完整。官方文档里也提醒过这一点。
所以，登录方式还是推荐用GPT plus账号登录。
2.3 登录后先认四个区域
登录成功后，你会看到类似这样的界面：
你只要先认这四个区域——
第一块：左边栏。
这里主要放“新对话”“搜索”“项目”“插件/技能”等入口。
你可以把左边栏理解成工作台的目录。
以后你要新开任务、找历史对话、切换项目，大多从这里开始。
第二块：中间区域。
这里是聊天和执行记录。
你给 Codex 发的需求、它读了什么文件、跑了什么命令、做了什么判断，都会在这里出现。
第三块：底部输入框。
你所有指令都从这里发。
底部还会有几个很关键的按钮：添加材料、权限模式、模型、推理强度、语音输入、发送/停止。
第四块：右侧输出面板。
这里会出现产物、来源、改动、预览等信息。
比如它写了一篇文章、改了一个文件、生成了一个页面，你可以在这里看到结果。
2.4 怎么切中文
如果你打开以后是英文界面，可以先去设置里找语言。
通常路径是：
左下角账号/设置入口 → Settings → General → Language → 中文。
如果改完没有立刻生效，就退出 Codex，再重新打开。
如果你找不到语言入口，直接在 Codex 对话框里问：
请一步步告诉我，当前界面在哪里把语言切成中文。它会根据当前界面给你提示。
三. 想接国产 API：用 CC Switch 切到国产模型
有的小伙伴说，我不想充值GPT plus怎么用codex？
也有办法：用 CC Switch，把 Codex 切到国产模型。但是就没法使用image2生图模型了，做任务的效果上会有差异。
如果你只想先体验一下codex，你可以先用 DeepSeek 跑通。
Kimi、智谱 GLM、硅基流动、豆包的流程也一样。
3.1 先准备两样东西
第一样，CC Switch。
打开这个下载页：
https://github.com/farion1231/cc-switch/releases/latest往下找到 Assets 下载列表。
按自己的系统选：
Mac：下载 CC-Switch-xxx-macOS.dmgWindows 普通电脑：下载 CC-Switch-xxx-Windows.msiWindows ARM 电脑：下载 CC-Switch-xxx-Windows-arm64.msiLinux：按你的系统选 .AppImage、.deb或.rpm
Mac 下载 .dmg 后，打开，把 CC Switch 拖进 Applications。
Windows 下载 .msi 后，双击安装，一路下一步。
第二样，国产模型平台的 API Key。
你准备用哪个模型，就去哪个平台拿 key。
以 DeepSeek 为例：
打开 DeepSeek 开放平台：https://platform.deepseek.com/ 登录账号 找到 API keys 新建一个 key 复制这个 keyKimi、智谱 GLM、硅基流动、豆包也是同一个动作：登录开放平台，找到 API Key，新建并复制。
API Key 先放在你自己能找到的地方，后面要粘到 CC Switch 里。
3.2 在 CC Switch 里添加 Codex 供应商
打开 CC Switch。
第一步，顶部切到 Codex 标签。
第二步，点击右上角 +。
第三步，选择“应用专属供应商”。
第四步，在“预设”里选你要用的平台。
预设会自动带出一部分地址、格式和模型配置，基本只要填你上一步创建好的API key就行。
字段填完后，点击“添加”或“保存”。
3.3 打开 Codex 路由
供应商加好以后，还要把 Codex 的本地路由打开。
第一步，进入 CC Switch 设置。
第二步，找到“路由”或“本地路由”。
第三步，打开“路由总开关”。
第四步，在“路由启用”里，把 Codex 打开。
3.4 启用供应商，然后重启 Codex
回到 CC Switch 顶部的 Codex 标签。
找到刚刚添加的供应商。
点击“启用”或“切换到此供应商”。
确认它变成当前高亮供应商。
然后做两步：
第一步，完全退出 Codex。
第二步，重新打开 Codex。
3.5 回到 Codex 测试
重启 Codex 后，先发最小测试：
请用一句话介绍你现在能帮我做什么。如果正常，就配置成功了！
3.7 出错就按这个顺序排查
如果 Codex 没反应：
第一，CC Switch 有没有打开。
第二，“路由总开关”有没有打开。
第三，“路由启用”里有没有打开 Codex。
第四，Codex 标签下当前高亮供应商对不对。
第五，API Key 有没有复制完整。
第六，切换供应商后有没有重启 Codex。
如果报 401 或 403，先查 API Key 和账户额度。
如果报 404，先查 Base URL 和本地路由。
如果 /model 里看不到新模型，先重启 Codex。
如果 CC Switch 请求日志没有变化，回去检查“路由总开关”和 Codex 路由启用。
四. 核心玩法
新手先把 5 件事搞明白就够了：
Skill 和插件是什么。 普通对话和项目对话有什么区别。 怎么开一个项目，让 Codex 真正干活。 怎么用计划模式，避免它没搞清楚需求就开始做任务。 怎么把 Codex 接进自己的内容生产系统。
4.1 Skill 和插件：先搞清楚这两个词
很多人第一次看到 Skill 和插件，会有点懵。
Skill，是一套固定工作流程。
比如你经常写公众号，你就可以有一个“公众号文章 Skill”。
它会提前写好：
写之前要读哪些资料 文章按什么步骤生成 哪些表达不能用 写完要保存到哪里 写完要检查什么
这样你每次写公众号时，就不用重新打一大段提示词。
你只要调用这个 Skill，再补充这次的主题、参考文章、素材就行。
插件，是给 Codex 增加能力的工具包。
比如浏览网页、操作 GitHub、处理 Word/PDF/表格、控制浏览器、操作电脑，这类通常属于插件能力。
你可以这样区分：
Skill 管“怎么做事”。
插件管“能调用什么工具”。
怎么用 Skill？
一般有两种入口。
第一种，在输入框里输入 /，看有没有可用 Skill。
第二种，在输入框里输入 $，看能不能直接点名 Skill。 
比如你要写公众号，可以这样发：
$公众号文案 参考这篇文章结构：xxx 结合我的定位、方法论和素材库，写一篇 Codex 小白教程。 要求每一步都写清楚，读者能照着操作。怎么安装skill或者自己写skill？
网上很多大佬会把自己的skill开源在github上，你直接复制github的链接，发给codeex，让他帮你安装这个skill，它就会自动检查，并且帮你安装。
如果你需要自己去写一个skill的话，你可以直接跟codex说我需要写一个 skill，角色是什么、任务是什么、输入什么、执行步骤是什么、输出什么？
我的建议是：先把一个最常用的 Skill 跑通。
比如你最常写公众号，就先把“公众号文案”这个流程跑通，再根据你的业务去配置更多的skill。
怎么用插件？
第一步，打开左侧的“插件”入口。
第二步，在顶部切到“插件”或“技能”标签。
第三步，搜索你要用的插件。
第四步，点击安装或启用。
第五步，回到对话里，让 Codex 使用对应能力。
新手不用一上来装一堆。
我建议先按用途装。
如果插件列表里能搜到这些名字，可以优先安装：
Chrome：打开网页、查资料、看页面。 Documents：处理 Word 文档。 PDF：读取、检查、生成 PDF。 Spreadsheets：处理表格。 Presentations：处理 PPT。 GitHub：做代码项目、看仓库、处理 PR。 Computer Use：需要 Codex 操作电脑时再开。
4.2 普通对话和项目对话有什么区别
左侧一般会有两类入口：对话和项目。
普通对话，适合临时问问题。
比如：
解释一个概念 拆一篇文章结构 帮你想标题 检查一段文案 给你出一个计划
这种对话不一定绑定你的本地文件夹。
它更像一个临时聊天窗口。
项目对话，适合让 Codex 正式干活。
它会进入你指定的项目空间，读取里面的文件，也可以按你的要求创建文件、修改文件、运行命令。
比如：
写一篇文章并保存到指定目录 根据已有素材生成选题 给一个网页小工具写代码 检查一个自动化有没有异常 整理一个 Obsidian 知识库
所以你可以这样判断：
只是问问题，用普通对话。
要读文件、写文件、生成项目成果，用项目对话。
还有一个很重要的点：一个项目下面可以开很多条对话。
比如你有一个 Obsidian Vault 项目。
里面可以分开开这些对话：
写公众号文章 整理素材 做小红书选题 处理录音 检查自动化 
它们共用同一个项目资料，但每条对话的任务记录分开。
不要把所有事情都塞进同一条对话里。
同一个大方向放同一个项目，具体任务单独开对话。
这个习惯越早养成，后面越省心。
4.3 开一个项目对话：让 Codex 做一个小工具
直接在 Codex 里新建项目。
第一步，看左侧栏，找到“项目”。
第二步，点击项目旁边的 + 或“新建项目”。
第三步，选择新建空项目，或者选择一个你准备放小工具的文件夹。
第四步，进入项目后，先把权限选成“自动审查”这一类。
这个权限比较适合新手。
普通读写它可以继续做，遇到风险高的动作会停下来问你。
第五步，在项目对话里输入这段话：
我想做一个本地网页小工具，名字叫“公众号标题体检器”。 功能要求： 1. 页面上有一个输入框，可以输入公众号标题。 2. 点击按钮后，从“清晰度、具体度、吸引力”三个维度给标题打分。 3. 给出 3 个优化后的标题版本。 4. 页面能直接在本地浏览器打开。 5. 界面要简单清爽，适合内容创作者日常使用。 先不要创建文件。 请先进入计划模式，告诉我： 1. 你准备创建哪些文件。 2. 每个文件分别做什么。 3. 你准备按什么步骤实现。 4. 我最后应该怎么验收。 等我确认后，你再开始写工具。这段提示词里，有几个关键点。
第一，任务很具体：做一个标题体检器。
第二，功能拆清楚了：输入、评分、优化标题、本地打开。
第三，先让它计划，不让它直接动手。
第四，提前规定验收方式。
它给出计划后，你先看 3 件事：
第一，它准备创建的文件是否合理。
比如一个简单网页小工具，通常有这些就够了：
index.html style.css script.js第二，它有没有说清楚每个文件负责什么。
第三，它有没有告诉你最后怎么打开和检查。
如果计划没问题，你再发：
计划可以，开始实现。 只在当前项目里创建必要文件，不要修改其他无关文件。 完成后告诉我： 1. 你创建了哪些文件。 2. 我应该打开哪个文件预览。 3. 这个小工具怎么测试。这就是第一个完整项目闭环。
你会看到 Codex 从“聊天工具”变成了“能在项目里交付结果的助手”。
4.4 计划模式：复杂任务先让它出方案
计划模式很适合新手。
因为很多人刚开始用 Codex，最怕的就是：我还没想清楚，它已经开始改文件了。
所以复杂任务前，先开计划模式，先做好调研和方案再去执行。
4.5 Codex读取文件和权限设置
如果你要让codex读某个文件，可以在输入框里输入 @，然后搜索文件名。
比如：
请读取 @AGENTS.md，告诉我这个项目有哪些规则。如果你要它读某个目录，可以直接写路径。
比如：
请扫描这个目录：竹子的资产库/04_素材案例库/公众号素材。 只列出文件名和主题，不要修改任何文件。Codex权限设置：
新手第一天建议用“替我审批”。
它要删除文件、改系统配置、批量修改大量文件时，会停下来问你。
如果弹出确认，你不要只看“允许”两个字。
先看它准备动哪个文件、跑什么命令、有没有可能影响无关内容。
看不懂就问它：
你准备执行的这个操作，会改哪些文件？有没有风险？新手应该注意什么？不过我一般都是完全访问权限，其实也问题不大。
4.6 内容创作者怎么接入自己的内容工厂
前面的小工具，是为了让你学会项目对话。
但对内容创作者来说，Codex 更有价值的地方，是接入自己的知识库。
比如我自己的内容系统，会围绕几个库来跑：
老板说明书 产品库 客户需求库 素材案例库 方法论库 内容生产库
你可以把自己的 Obsidian 知识库，作为一个 Codex 项目打开。并且把你常用的内容模块都封装为 Skill。
比如写公众号：
$公众号文案 参考文章链接：xxx 主题：Codex 小白教程 目标读者：刚开始接触 Codex、想用它做内容生产的人。 要求： 1. 保留参考文章的教程结构，但不要照搬原文。 2. 每一步都要写清楚点哪里、填什么、怎么判断成功。 3. 结合我的内容系统观点：Codex 要接入知识库和工作流，才会真正产生复利。 4. 写完保存到：竹子的资产库/06_内容生产库/公众号/待发布/ 5. 写完检查图片路径、禁用表达和素材使用记录。如果你要让它整理素材，可以这样发：
请读取这个目录：竹子的资产库/04_素材案例库/公众号素材。 先不要移动文件。 请帮我生成一个素材索引，字段包括：标题、来源、主题、适合写什么选题、是否已经用过。 最终只新建一个索引文件，其他文件不要改。如果你要让它做选题，可以这样发：
请结合我的老板说明书、客户需求库、方法论库和最近新增素材，生成 10 个公众号选题。 每个选题写清楚：标题方向、读者痛点、核心观点、可用素材、为什么值得写。 先只出选题，不写正文。这样用，Codex 的工作范围会从写一句文案，变成按你的资料和规则执行内容任务。
这也是我觉得 Codex 对内容创作者最值得学的地方。
你已经不再每次从零开始问 AI。
你是在把自己的内容资产，接进一个能执行的工作流里。
五. 进阶用法
前面这些用熟，日常已经够用了。后面再慢慢研究进阶功能。
5.1 Computer Use
如果你的 Codex 里有 Computer Use，可以把它理解成让 Codex 看屏幕、动鼠标、操作电脑。
适合做这些事：
打开网页查资料 帮你找设置入口 做一些重复点击 检查网页效果
使用时一般是这样：
第一步，在设置里打开 Computer Use 相关权限。
第二步，在对话框里 @ Computer Use，或者从工具里选择它。
第三步，告诉它要做什么。
比如：
请打开浏览器，进入 OpenAI Codex 官方文档，帮我找到下载安装入口。遇到密码、付款、验证码、私密后台，自己操作。
这类步骤不要交给 AI。
5.2 自动化
Codex 也适合做定时任务。
比如：
每天检查小红书素材有没有新内容 每天跑一次选题候选 每周汇总内容库更新 定时检查转写文件是否生成
设置自动化时，不要只写一句“每天帮我看看”。
你要写清楚四件事：
第一，什么时候跑。
第二，读取哪个目录。
第三，发现异常怎么判断。
第四，结果写到哪里。
示例：
请每天上午 9 点检查这个目录： 竹子的资产库/04_素材案例库/小红书素材/爆款笔记 检查规则： 1. 找出最近 24 小时新增的笔记。 2. 检查同目录下有没有对应的 .video-transcript.md。 3. 如果缺少转写文件，列出具体路径。 4. 把结果写到控制台记录文件。自动化的核心是规则。
规则越具体，结果越稳定。
六. 写在最后
Codex 刚上手会觉得按钮很多。
账号、API key、项目、权限、Skill、插件、计划模式、AGENTS.md，看起来都很技术。
但你按顺序拆开，就很简单：
第一步，装 App。
第二步，登录。
第三步，新建一个项目对话。
第四步，让它先计划，再做一个小工具。
第五步，学会看权限和验收结果。
第六步，再把它接进自己的真实知识库和内容工作流。
你不要一开始就追求“精通”。
先跑一个最小闭环：
打开项目 → 让 Codex 读文件 → 让它总结 → 让它生成一个新文件 → 自己验收这个闭环跑通以后，你就已经超过很多只会跟 AI 闲聊的人了。
