這個單元解決什麼問題你不是在學四套工具,你在學同一組概念換四套名字。以 02-2 的 Claude 為基準,把 OpenAI Codex、Google Antigravity、GitHub Copilot 的設定面對位到 02-1 的層級模型:個人化在哪設、隱私退出叫什麼、專案規則檔是哪一個、自動化機制有沒有、記憶怎麼存、MCP 接在哪。Cursor 作為第三方 IDE,僅在末段短提一節作對照。對齊完,換工具就是查表,不必重學。本頁與 04-0 .claude 目錄完整參考 的分工:04-0 是 Claude 自家
.claude/ 的完整參考;本頁以 Claude 為基準,展示跨工具的設定目錄對照。學習目標
- 能把任一工具的個人化、隱私、專案規則、自動化、記憶、MCP 對應到 02-1 的層級模型。
- 能說出每個工具的專案級規則檔名與放置位置,並判斷它套用的範圍與優先序。
- 能找到每個工具的隱私 / 訓練退出開關,並知道預設是開還是關。
- 能用
AGENTS.md讓一份專案規則被多個工具共讀,並說出它與各家專屬檔的取捨。
1. 先有框架,再看四套主軸工具
每套工具的設定面都繞著同六個概念轉。把它們先釘住,後面就是逐欄填空:
判準很簡單:拿到一個新工具,先問這六格各在哪設、預設值是什麼。填得出來就掌握了它的設定面;填不出來的格子就是你還沒讀到的文件。下面四節按這六格逐一對位,差異處標出來;第五節短提 Cursor 作為對照。
2. OpenAI:ChatGPT(消費端)與 Codex(命令列)
OpenAI 的設定面分兩條線:ChatGPT 是帳號設定 + GUI,Codex 是檔案 + CLI,兩者概念對得上但介面完全不同。 ChatGPT 的個人化走 Settings → Personalization → Custom Instructions,兩個欄位(「關於你」與「希望如何回應」),需開啟 Enable customization 才生效。語氣另有 Base style and tone 下拉(Default / Professional / Friendly / Candid / Quirky / Efficient / Nerdy / Cynical),對應 Claude 的 response style 概念。 記憶分兩塊且可分別關閉:Saved Memories(可逐條檢視刪除)與 Reference chat history(跨對話引用歷史),路徑 Settings → Personalization → Manage memories。這是與 Claude 一個明顯差異點:ChatGPT 的記憶是帳號側自動累積,行為與 Claude 的記憶機制不同,別假設兩者語意一致。 專案(Projects)給專案級指令與檔案,可設 project-only memory(僅在建立專案時可選),把該專案的記憶與全域隔開。Custom GPTs 則用 Configure 分頁的 Instructions / Knowledge / Capabilities / Actions 四欄組裝可分享的客製助手。 隱私退出:Settings → Data Controls 的「Improve the model for everyone」開關;單次對話可用 Temporary Chat 不入歷史;Team / Enterprise 方案預設不訓練、可談 ZDR(zero data retention)。消費端預設是「開」(會用於改進模型),要退出得自己關。 Codex 把所有設定寫在兩種檔案:AGENTS.md 系列放專案指令,config.toml 放行為配置(TOML 格式)。怎麼讀、怎麼疊加:
- 專案指令(
AGENTS.md):放在專案根目錄。Codex 從專案根(通常是 git root)向下掃到當前工作目錄,把沿途每一層的AGENTS.md串接進來,越靠近當前目錄的因為排在後面而覆寫前面的(同一層先讀AGENTS.override.md再讀AGENTS.md,可用project_doc_fallback_filenames指定備用檔名)。也有全域一份在~/.codex/AGENTS.md,套用到你所有專案。 - 行為配置(
config.toml):誰能蓋誰,由高到低是 IT 管的requirements.toml(企業強制約束,使用者改不動,例如禁止把approval_policy設成never)→ CLI 帶的旗標 → 專案內.codex/config.toml(只在信任該專案時才生效;clone 來的不明專案這層不會被讀)→ profile(具名設定組,以--profile <name>切換)→~/.codex/config.toml套所有專案。整個~/.codex目錄可用CODEX_HOME環境變數搬到別處。 - 幾個最常用的鍵:
model:預設用哪個模型approval_policy:何時停下來問你(untrusted處處問、on-request該問才問、never都不問;想更細可用granular物件)sandbox_mode:能動到哪裡(read-only唯讀、workspace-write專案內可寫、danger-full-access全開)[mcp_servers.<id>]:接 MCP 伺服器[hooks](stable,預設啟用;舊的codex_hooks開關名已棄用,要關改在[features]設hooks = false):生命週期掛鉤
- 計費:登入 ChatGPT 帳號(含每 5 小時的用量時窗)或自備 API key(按 token 計)兩種。
Codex 設定目錄(~/.codex/)
3. Google:Gemini(消費端)與 Antigravity(開發平台)
同樣兩條線。Gemini 是帳號 + GUI,Antigravity 是檔案 + IDE/CLI。 Gemini 的個人化用 Gems(自訂 persona,欄位 Name / Instructions / Knowledge,可接 Drive、NotebookLM)。帳號側的 Personal context(Settings)含三塊:Memory(從過往對話學習)、Instructions for Gemini(常駐指令,對應 Claude 的 Instructions for Claude)、Connected Apps(Gmail / Calendar 等)。 隱私退出:「Keep Activity」開關(18 歲以上預設為開),自動刪除週期 3 / 18(預設)/ 36 個月可選;關閉後不用於訓練。Workspace 帳號由管理員控制,個人開關可能被組織政策覆寫。 Antigravity 是 Google 的 agentic 開發平台,同一品牌涵蓋四個 surface:桌面 app(Antigravity 2.0)、IDE、CLI(agy)、SDK,各自設定面不同;基礎模型為 Gemini 3.5 Flash(截至 2026-06,[9])。它與 Gemini CLI 是不同產品,但全域規則共用 ~/.gemini/GEMINI.md(衝突見本節末警示)。規則分兩層:
- 全域規則:
~/.gemini/GEMINI.md,套用所有 workspace。 - 工作區規則:專案內
.agents/rules/*.md(注意是複數.agents/,為官方現行預設;舊版單數.agent/rules/仍向後相容);工作區的GEMINI.md與AGENTS.md也會被讀取。規則為純 Markdown,有 Manual / Always On / Model Decision / Glob 四種啟動模式。GEMINI.md與AGENTS.md的嚴格優先序官方頁未宣告。
antigravity.google/docs 為準):
- Skills:全工具共用
~/.gemini/skills/<name>/SKILL.md;CLI 專屬全域~/.gemini/antigravity-cli/skills/;工作區一律.agents/skills/(向後相容.agent/skills/)。 - MCP:官方設定檔
~/.gemini/config/mcp_config.json(IDE 與 CLI 全域共用);CLI 工作區可放.agents/mcp_config.json。 - Hooks:
hooks.json放.agents/(工作區)或~/.gemini/config/(全域),事件含PreToolUse/PostToolUse/PreInvocation/PostInvocation/Stop。 - CLI(
agy)設定:~/.gemini/antigravity-cli/settings.json與keybindings.json。 - Workflows:以
/workflow-name叫用,經 IDE Customizations 面板建立;確切 on-disk 路徑以 Antigravity 官方文件為準。
Antigravity 設定目錄(~/.gemini/)
4. GitHub Copilot CLI(新版獨立 copilot 二進位)
身份釐清本節只談本機新版獨立
copilot CLI(npm @github/copilot),與舊版 gh copilot 擴充(僅 suggest / explain)為兩條產品線。VS Code 內的 Copilot Chat 與本機 CLI 不是同一套設定機制:CLI 讀 ~/.copilot/,VS Code Copilot Chat 讀 chat.* 工作區設定(如 chat.instructionsFilesLocations),檔案路徑與載入行為不同。本節不涵蓋 VS Code Copilot Chat。~/.copilot/,可被 COPILOT_HOME 或 --config-dir 覆寫;COPILOT_CACHE_HOME 單獨管快取:
- 本機指令(local):
~/.copilot/copilot-instructions.md(單檔,位於~/.copilot/根),該機器所有 session 生效。 - 倉庫級指令(repository-wide):
.github/copilot-instructions.md,整個 repo 套用。 - 路徑級指令(path-specific):
.github/instructions/NAME.instructions.md,frontmatter 用applyTo以 glob 控制套用範圍,選用excludeAgent。這是 Copilot 比多數工具細的地方:規則能精準綁到特定路徑。 - Agent 指令層:root
AGENTS.md(primary)、cwd 或COPILOT_CUSTOM_INSTRUCTIONS_DIRS各目錄的AGENTS.md(additional)、rootCLAUDE.md/GEMINI.md作為AGENTS.md替代。所有命中的指令檔皆併用,無嚴格優先序;衝突時 Copilot 的取捨為非確定性,避免互相矛盾。 - 自動化:
- 個人 / 專案 agent:使用者層
~/.copilot/agents/<name>.agent.md;專案層.github/agents/<name>.agent.md(同名覆寫個人層)。 - 個人 / 專案 skill:使用者層
~/.copilot/skills/<n>/SKILL.md;專案層.github/skills/<n>/SKILL.md(同名覆寫個人層)。 - Hook:使用者層
~/.copilot/hooks/或config.json內 inline;專案層.github/hooks/;兩者併用(非覆寫)。
- 個人 / 專案 agent:使用者層
- MCP:使用者層
~/.copilot/mcp-config.json;專案層.mcp.json/.github/mcp.json/.vscode/mcp.json(同名時專案層覆寫使用者層)。 - 雲端 Coding agent:以 Issue 或
@copilot派任務,是另一條產品線,執行環境由.github/workflows/copilot-setup-steps.yml設定;本機 CLI 不走這條。
5. Cursor(短提)
Cursor 是第三方 IDE(Anysphere 開發,非模型廠商),規則格式為.cursor/rules/*.mdc(注意:純 .md 會被忽略,必須 .mdc),並讀 AGENTS.md 作為簡化替代。舊 .cursorrules 已標記將棄用。詳細格式與 ignore 檔差異見 Cursor 官方文件 [4];本 Playbook 不深討。
6. AGENTS.md:跨工具的共通規則檔
AGENTS.md 是把上面各家專屬規則檔收斂成一份的開放標準。AGENTS.md 是專案規則層的標準,不是個人化層的標準。把它當成跨工具的「共通基線檔」最不容易誤用。
重點:
- 純 Markdown、無強制 schema,放倉庫根;monorepo 可多層,越靠近被編輯檔的越優先。
- 採用面:Codex、Cursor、Copilot、Gemini CLI、Jules、Devin、Amp、VS Code 等二十多個工具原生支援,已逾六萬個開源專案採用(截至 2026-06)[5]。
- 治理:Linux Foundation 旗下 Agentic AI Foundation(AAIF)統籌,AGENTS.md 是 OpenAI 貢獻的創始專案之一(另兩個為 Anthropic 的 MCP、Block 的 goose)[6]。標準站
agents.md。
AGENTS.md:
- 原生支援:Codex、Cursor、Copilot、Gemini CLI 等把
AGENTS.md視為專案規則入口;各家另有自己的專屬檔(GEMINI.md、.cursor/rules/、.github/copilot-instructions.md)做差異化覆寫或擴充。 - 不原生支援:Claude Code。
AGENTS.md不在讀取清單,要用同一份基線得在CLAUDE.md用@AGENTS.mdimport 拉進來 [8]。Claude 的「專屬檔」就是CLAUDE.md本身,是唯一讀得到的入口。
AGENTS.md 是基線,不是替代:差異化規則仍分散在各家專屬檔裡。具體怎麼抽基線、共讀驗證什麼,第 7 節動手做走一遍。
總對照表(截至 2026-06)
行 = 概念,欄 = 工具,Claude 欄置首。本表四套主軸工具以 CLI 為對照軸;OpenAI 欄以 Codex 為主、ChatGPT 為補;Google 欄以 Antigravity 為主、Gemini 為補。Antigravity 主要為 IDE 介面(Electron / VS Code 衍生),CLI 對位僅作概念對照,嚴格檔名與路徑見第 3 節。Cursor 為第三方 IDE,不主動展開細節,僅以「短提」欄列重點。動手做:以 Claude 為示例,把六概念填滿再對位
情境:你是 Claude 使用者,要評估搬到另一套工具,或兩套並用。做法分三步:先把 Claude 的六概念格填出具體值當母版,再逐格對位到目標工具,最後把重疊的專案規則抽成AGENTS.md 讓對方也讀到。
第一步,把第 1 節那六格用 Claude 的真實設定填滿。這份就是你的對位母版:
Claude 六概念實填:以 Claude Code 為例
Claude → Codex 逐格對位
對完你會發現只有兩件事:Codex 的設定集中在
config.toml,而 Claude 在 settings.json。CLAUDE.md,不需要為了跨工具共讀去改寫它的結構。
常見誤區
- 假設同名功能行為一致。各家的 Memory 是最大陷阱:Claude 的記憶、ChatGPT 的 Saved Memories、Gemini 的 Memory,存什麼、何時觸發、能否關,三者都不同。看到熟悉的詞就套用舊心智模型,會在隱私與行為上出問題。對位概念可以,假設語意相同不行。
- 在採用
AGENTS.md的工具上仍維護多份各家專屬檔。內容重複就會漂移,最後每份都半對半錯。決定哪份是基線(多半是AGENTS.md),其餘指回它。 - 混淆 Cursor 的兩個忽略檔。
.cursorignore全面封鎖 AI 存取,.cursorindexingignore只排除索引、檔案仍可被讀。把機密放錯檔,以為擋住了其實沒擋。 - 以為消費端預設不訓練。ChatGPT、Gemini 的消費方案多半預設會用於改進模型,要退出得自己關;別把企業方案的預設套到個人帳號上。
- 照抄快變動的檔名與路徑。Antigravity 的
.agent/vs.agents/、Codex 的config.toml位置這類,版本一變就錯。本單元給對位框架,動手前以你的版本官方文件核實。
自我檢核
你能對位嗎
- 拿出你現在最常用的非 Claude 工具,把第 1 節那六個概念欄全部填出來:個人化、專案規則、記憶、隱私退出、自動化、MCP 各在哪設?填不出哪一格?
- 你的工具的隱私退出開關,預設是開還是關?你現在這個帳號是哪個狀態?
- 如果要讓 Claude 與這個工具共讀同一份專案規則,你會把基線放哪、各家專屬檔留什麼?
- 你的 repo 裡有沒有兩份內容重疊的規則檔?它們現在一致嗎?
來源與延伸閱讀
事實主張依官方文件,快變動項標註截至 2026-06。-
[1] OpenAI, “Config basics,” “AGENTS.md guide,” “Custom prompts,” and Codex / ChatGPT docs, OpenAI. Accessed: 2026-06. [Online]. Available: https://developers.openai.com/codex/config-basic 、 https://developers.openai.com/codex/guides/agents-md 、 https://developers.openai.com/codex/custom-prompts 、 https://developers.openai.com/codex/config-reference 、 https://developers.openai.com/codex 、 https://help.openai.com 、 https://openai.com/policies 。Codex 的
AGENTS.md搜尋方向「git root 向下走到 cwd」、[hooks]與 subagents 為 stable,依前兩頁於 2026-06 複查;prompts/*.md已標 deprecated(建議改 skills),同時複查確認。 - [2] Google, “Gemini Apps Help & Antigravity / Gemini API docs,” Google. Accessed: 2026-06. [Online]. Available: https://support.google.com/gemini 、 https://developers.googleblog.com 、 https://ai.google.dev
- [3] GitHub, “Copilot docs & VS Code Copilot customization,” GitHub / Microsoft. Accessed: 2026-06. [Online]. Available: https://docs.github.com/copilot 、 https://code.visualstudio.com/docs/copilot
- [4] Anysphere, “Cursor docs (Rules, Ignore files, MCP),” Cursor. Accessed: 2026-06. [Online]. Available: https://cursor.com/docs
- [5] “AGENTS.md: open standard for agent instructions,” agents.md. Accessed: 2026-06. [Online]. Available: https://agents.md
- [6] Linux Foundation, “Linux Foundation Announces the Formation of the Agentic AI Foundation (AAIF), Anchored by MCP, goose and AGENTS.md,” 2026. [Online]. Available: https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation
-
[7] “Antigravity Global Rules and Gemini CLI Global Context Both Write to
~/.gemini/GEMINI.mdCausing Configuration Conflicts,” GitHub issue #16058, google-gemini/gemini-cli, 2026. [Online]. Available: https://github.com/google-gemini/gemini-cli/issues/16058 (Antigravity 規則目錄與全域檔衝突細節,以官方當前文件為準) -
[8] Anthropic, “How Claude remembers your project”(
CLAUDE.md以@path語法匯入其他檔,AGENTS.md 共讀範例為@AGENTS.md),Claude Code Docs. Accessed: 2026-06. [Online]. Available: https://code.claude.com/docs/en/memory - [9] Google, “Antigravity Documentation”(Settings、Rules & Workflows、Skills、MCP、Hooks、CLI Settings、Gemini CLI Migration 等頁,經 playwright 渲染取得一手內容;本知識庫不再採用先前的 raw 整理檔),Antigravity Docs. Accessed: 2026-06. [Online]. Available: https://antigravity.google/docs/rules-workflows 、 https://antigravity.google/docs/skills 、 https://antigravity.google/docs/mcp 、 https://antigravity.google/docs/hooks 、 https://antigravity.google/docs/settings 、 https://antigravity.google/docs/cli-settings 、 https://antigravity.google/docs/gcli-migration ;另佐 Google Codelabs https://codelabs.developers.google.com/getting-started-google-antigravity
- [10] D. Lester, “Configuring MCP Servers and Skills for Antigravity CLI and IDE,” Google Cloud Community / Medium. Accessed: 2026-06. [Online]. Available: https://medium.com/google-cloud/configuring-mcp-servers-and-skills-for-antigravity-cli-and-ide-a938c7eebb78 (~/.gemini/ 目錄實測結構,含 skills/ 全工具共用 vs antigravity-cli/skills/ CLI 專屬差異)