Skip to content

Latest commit

 

History

32 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Codex 懶人包(OpenAI Codex 版)

Claude Code 懶人包的 OpenAI Codex 平行版本。 把每份 MD 檔丟給 Codex,它會自動執行。

適用三種 CodexCodex Desktop app(macOS/Windows)Codex IDE 擴充(VSCode / Cursor / JetBrains)Codex CLI。三者共用同一份 ~/.codex/config.tomlAGENTS.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 設定的三條路(任選)

  1. Desktop設定 → Integrations & MCP 介面新增 server;設定 → Personalization 編輯 AGENTS.md
  2. IDE:齒輪 → MCP settings → Open config.toml
  3. CLIcodex 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 幫你裝(最簡單)

把這行貼給你的 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。

方式二:手動下載 MD 檔

  1. 看影片了解原理(同 Claude 基本功系列)
  2. 下載對應的懶人包(MD 檔)
  3. 打開 OpenAI Codex CLI,把檔案內容貼進去
  4. 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 懶人包相同。


相關技能 repo

  • agent-speak-skill — 讓 AI Agent「用語音回答你」:免費 Edge-TTS 串流語音回覆,零金鑰、首聲約 1–2 秒、無視窗(Claude Code/Codex/OpenCode/AntiGravity 通用)

About

OpenAI Codex CLI 懶人包:對應 Claude Code 懶人包的平行版本

Resources

Stars

73 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors