关联主题::
同级:: 2026-05-31_星期日
下一级::
什么是 Codex
Codex 是 Anthropic 推出的 AI 编程助手桌面版，基于 GPT-5 / Claude 模型，定位为”你的 AI 结对编程伙伴”。相比于 Cursor 等 IDE 内嵌工具，Codex 是以 Agent 为中心的独立应用——它可以直接操作你的文件系统、执行终端命令、调用浏览器、管理 Git 仓库，像一个全栈工程师一样和你协作。
目前苏苏主要用它来：
- 管理 Obsidian 知识库 — 内容整理、索引维护、文档创建
- 编写和发布博客 — 通过 Skills 系统自动将笔记同步到飞书和博客
- 自动化工作流 — 组合多个 Skills 完成复杂的编排任务（如内容抓取→归档→发布）
核心特性
1. Agent 式交互
Codex 不是简单的对话补全工具，它有完整的 Agent 循环：
- 自主规划任务步骤
- 读取文件系统和代码库
- 执行 shell 命令并处理结果
- 调用各种工具（浏览器、MCP、API）
- 根据反馈自我修正
2. Skills 系统
Skills 是 Codex 最强大的扩展机制——相当于给 AI 的”专业技能包”。每个 Skill 是一个包含 SKILL.md 指令和可选脚本的目录，定义了特定场景下的行为模式。
苏苏的 Codex Skills 生态：
| 分类 | Skills |
|---|---|
| 内容处理 | 内容处理编排、baoyu-post-to-wechat、baoyu-post-to-x |
| 信息获取 | bb-browser、browser-agent、markdown-proxy、youtube-transcript |
| 文档创建 | obsidian-markdown、json-canvas、mermaid-visualizer、excalidraw-diagram |
| 图片生成 | baoyu-cover-image、baoyu-image-gen、baoyu-infographic |
| 归档管理 | notion收藏归档日报、cflow-cli、cubox |
| 日常工具 | daily-report-generator、file-organizer、xiaomi-speaker |
3. MCP 服务器
通过 Model Context Protocol，Codex 可以接入各种外部服务和数据源。已配置的 MCP 包括飞书、Notion、Cubox 等。
4. 文件系统感知
Codex 可以理解项目结构、读取任意文件、跨文件编辑，非常适合管理大型知识库这样的复杂文件树。
与 Obsidian 知识库的结合
苏苏的 Codex + Obsidian 工作流是其核心亮点。
知识管理
- 通过
AGENTS.md配置，Codex 了解整个仓库的结构和规则 - 自动遵循 Obsidian 文件夹分类体系（00 Inbox → 10 Note → 20 Knowledge → …）
- 理解 Obsidian 特有的语法：wikilinks、callouts、frontmatter、tags
内容发布管线
Obsidian 笔记 → Skills 编排 → 多平台发布
├── 博客（Quartz v4）
├── 飞书文档
├── 微信公众号
└── X (Twitter)
自动化流程
通过组合 Skills，实现一键式操作：
- 收藏归档：提供 URL → 自动抓取内容 → 写入日报 → 同步 Notion → 汇总到收藏文档
- 日报生成：扫描今日笔记和 CFlow → 提炼事件和思考 → 输出结构化日报
- 内容编排：识别链接类型 → 让用户选择处理方式 → 依次执行选中的 Skills
常用模式
AGENTS.md
这是 Codex 读取的第一个配置文件，定义了仓库结构、代码风格、工作流规则。当前这个知识库的 AGENTS.md 详细描述了：
- 仓库目录结构（7 个顶层文件夹）
- 构建和测试命令
- TypeScript / Prettier 代码规范
- 导入和依赖管理规则
技能触发的约定
Skills 通过描述和触发词自动匹配。你可以通过下面方式主动唤起某个 Skill：
- 直接命名 Skill 名称（如
$baoyu-post-to-wechat） - 说出触发短语（如”帮我收藏这篇文章”）
- 明确请求某个能力（如”生成一张封面图”）
对比：Codex vs Cursor vs Copilot
| 维度 | Codex | Cursor | Copilot |
|---|---|---|---|
| 形态 | 独立桌面 App | IDE 插件 | IDE 插件 |
| Agent 能力 | 完整（文件+终端+浏览器） | 有限（编辑器内） | 有限 |
| Skills 扩展 | 强（本地指令+脚本） | 弱 | 弱 |
| 文件系统操作 | 原生支持 | 局限 | 局限 |
| 知识库管理 | 天然适合 | 不适合 | 不适合 |
| 中文支持 | 优秀 | 一般 | 一般 |
使用建议
- 写清楚的 AGENTS.md — Codex 的理解高度依赖这个文件，越详细越好
- 善用 Skills — 把重复性的工作流打包成 Skill，一劳永逸
- 配合配置文件 —
CLAUDE.md、AGENTS.md是 Codex 的重要上下文 - 结合 MCP — 打通外部服务（飞书、Notion）能大幅扩展能力边界
- 定期维护 — 知识库和 Skills 需要持续迭代，Codex 本身也在快速进化
踩坑记录
cc-switch 配置 Codex 时报错：model catalog template gpt-5.5 not found
错误信息
切换路由状态失败: 写入 Codex 配置失败: Codex model catalog template gpt-5.5 not found.
Please start Codex once so models_cache.json is available, or ensure the codex CLI is on PATH.
根因
CC Switch 在写入 Codex 路由配置时，需要读取 ~/.codex/models_cache.json 来获取可用模型列表（其中必须包含 gpt-5.5 模板）。这个文件通常由 Codex CLI 在首次启动时自动生成（内部执行 codex debug models --bundled）。
但如果你一直用自定义后端（如 DeepSeek，model_provider = "custom"），从未触发过 Codex 内置模型缓存的生成，那么 models_cache.json 文件就不存在，CC Switch 找不到 gpt-5.5 模板就会报错。
解决方案
手动生成缓存文件即可，一行命令：
codex debug models --bundled > ~/.codex/models_cache.json执行后 ~/.codex/models_cache.json 中会包含 6 个模型：
- gpt-5.5
- gpt-5.4
- gpt-5.4-mini
- gpt-5.3-codex
- gpt-5.2
- codex-auto-review
之后 CC Switch 就可以正常写入 Codex 路由配置了。如果遇到类似问题（换了模型或缓存丢失），用同样命令重新生成即可。
参考资料
收集 Codex 相关的教程、文章、工具和社区讨论，持续更新。