Claude Code 懶人包的 OpenAI Codex 平行版本。 把每份 MD 檔丟給 Codex,它會自動執行。
✅ 適用三種 Codex:Codex Desktop app(macOS/Windows)、Codex IDE 擴充(VSCode / Cursor / JetBrains)、Codex CLI。三者共用同一份
~/.codex/config.toml與AGENTS.md,所以設定做一次就好。
| 你的工具 | 怎麼裝 / 怎麼開 |
|---|---|
| Codex Desktop app | 從 OpenAI 官網下載 macOS / Windows 安裝檔(本懶人包預設場景) |
| Codex IDE 擴充 | VSCode / Cursor / Windsurf → Marketplace 搜尋「ChatGPT」(OpenAI 官方);JetBrains 系列也有對應 |
| Codex CLI | npm install -g @openai/codex |
MCP 與 AGENTS.md 設定的三條路(任選):
- Desktop:
設定 → Integrations & MCP介面新增 server;設定 → Personalization編輯 AGENTS.md - IDE:齒輪 → MCP settings → Open config.toml
- CLI:
codex mcp add <name> -- <command>
設定動了一邊,三邊都會吃到。本懶人包以 Desktop app GUI 為主寫,每個 MCP 章節都附「手動編輯
~/.codex/config.toml」的 TOML 範例供 IDE / CLI 用戶或 Desktop 進階使用者參考。
原本的懶人包是給 Claude Code 用的,但很多老師也在用 OpenAI Codex CLI。 這份是把同樣的工作流程,改寫成 Codex 看得懂的版本:
| 差異 | Claude Code | OpenAI Codex |
|---|---|---|
| 全域指令檔 | ~/.claude/CLAUDE.md |
~/.codex/AGENTS.md |
| 專案指令檔 | ./CLAUDE.md |
./AGENTS.md |
| 設定檔 | ~/.claude/settings.json(JSON) |
~/.codex/config.toml(TOML) |
| MCP 安裝指令 | claude mcp add ... |
codex mcp add ... |
| Skill 機制 | 原生支援 | ✅ Codex Desktop 支援 skills;CLI / 舊環境可用 prompt 模板或 shell 腳本備援 |
| Slash command | 原生支援 | ❌ 沒有 |
| 排程任務 | mcp__scheduled-tasks__* |
❌ 沒有,用系統 cron / Task Scheduler |
把這行貼給你的 AI agent:
這是 Codex 懶人包全集 https://github.com/mathruffian-dot/codex-lazy-packs
請讀取 repo 內容,列出所有可用的懶人包,問我要裝哪些。
AI 會自動讀取 SKILL.md(安裝入口),列出 15 個技能,讓你選擇後自動安裝。
也可以直接安裝「環境建置」Skill:
npx skills add mathruffian-dot/codex-lazy-packs --skill codex-env-setup --full-depth -g -y
--full-depth不可省略。只安裝codex-env-setup時,不會檢查 GitHub 帳號,也不會安裝 Git 或 GitHub CLI。
- 看影片了解原理(同 Claude 基本功系列)
- 下載對應的懶人包(MD 檔)
- 打開 OpenAI Codex CLI,把檔案內容貼進去
- AI 自動執行,遇到需要手動操作的地方會暫停指示你
- OpenAI 帳號(ChatGPT Plus / Pro / Business / Edu 訂閱,或 OpenAI API 額度)
- Codex Desktop app 已安裝且能登入(macOS / Windows);或 IDE 擴充 / CLI 任一
- 電腦有網路連線
| 編號 | 名稱 | 說明 |
|---|---|---|
| 00 | 環境建置 | Codex Desktop、Node.js LTS、uv;Codex CLI 選用,不處理 GitHub |
| 01 | 連接 NotebookLM | NotebookLM MCP(Codex 版) |
| 01.5 | 初學者必裝外掛程式與技能 | 基礎工具快篩、GitHub、Browser Use、Office 文件、生圖、官方文件與技能工具檢查 |
| 02 | 連接 GitHub | GitHub CLI + 網頁端登入 + GitHub Pages 驗證 |
| 02.5 | 連接 GitHub 與 Obsidian 第二大腦 | 第三集整合版:GitHub CLI commit / push + Obsidian MCPVault |
| 03 | 連接 Obsidian 第二大腦 | 先找 vault,再設定全域 AGENTS.md;跨專案讀寫可走資料夾授權或 MCPVault |
| 03+ | 第二大腦設定指南 | 三層結構 + AGENTS.md + 模板 |
| 04 | 連接 Supabase 資料庫 | Supabase MCP(Codex 版) |
| 04.5 | 連接 Firebase 資料庫 | Firebase MCP(Codex 版) |
| 05 | 安裝本地 AI Ollama | 本地模型,網頁工具用 |
| 06 | 設定 Gemini 免費 API | Gemini 免費 API,網頁工具用 |
| 07 | 開始你的專案 | AGENTS.md + Obsidian 駕駛艙 + GitHub repo + 開工/收工/新專案初始化 skills |
| 08 | [用 Image Gen Skill 在 Codex 生圖](08-用Image Gen Skill在Codex生圖.md) | 新手用內建 Image Gen Skill;進階再用 API Key / CLI |
| 09 | 用 chezmoi 同步 Codex 設定 | 跨電腦同步 ~/.codex/AGENTS.md 與全域 skills |
- 05 / 06:跟 Codex / Claude 都無關,是「讓你做的網頁工具有 AI 能力」,兩邊通用。
- 07 / 09 收工同步:Codex 可用全域 skill +
~/.codex/AGENTS.md觸發詞;跨電腦同步時用 chezmoi 管理安全項目。 - 08 生圖:Codex Desktop 新手優先使用內建 Image Gen Skill;API Key / CLI 腳本只作為進階大量產圖與自動化路線。
- 04 第二大腦設定指南:每週知識重整優先使用 Codex 自動化;CLI 排程只作為進階備援。
MIT License,與 Claude Code 懶人包相同。
- agent-speak-skill — 讓 AI Agent「用語音回答你」:免費 Edge-TTS 串流語音回覆,零金鑰、首聲約 1–2 秒、無視窗(Claude Code/Codex/OpenCode/AntiGravity 通用)