Stage 01

我該用哪個 Agent、在哪裡跑?

先弄清楚終端機工具、桌面 App 和自架模型各適合做什麼,再決定把哪個專案交出去。

  1. 1. 建立隔離執行環境

    OpenHands 1.40 教學:模型選擇、草稿與 Automation 驗收

    OpenHands Canvas 1.40 修正自架服務關閉 Agent Profiles 後的首頁模型選擇,也修正舊訊息延遲確認時可能清掉新草稿的問題。本文提供兩項升級驗收,並保留 Automation preset 選擇、Script bundle 匯入與 Runtime 排查流程。

  2. 2. 認識終端機 Agent 介面

    Gemini CLI:你的終端機 AI 夥伴

    這篇文章將帶你深入了解 Gemini CLI,一個讓你能直接在終端機與強大 AI 模型互動的工具。從基本介紹、安裝到進階應用,讓你成為命令列操作的 AI 大師。

  3. 3. 安裝 Claude Code 原生工具

    Claude Code 怎麼安裝?macOS、Linux、WSL 與 Windows 指令

    整理 Claude Code 目前官方安裝方式:macOS、Linux、WSL、Windows PowerShell、CMD、Homebrew 與 WinGet,並說明 Native Install、自動更新、登入與版本驗證,避免用錯終端機指令。

  4. 4. 整理跨專案的 MCP 設定

    Claude Code MCP 設定研究:跨專案配置經驗分享

    深入探討 Claude Code MCP 的三種作用域設定差別,以及如何實現跨專案和跨電腦的統一配置,解決開發者在多個環境下的 MCP 工具管理需求。

  5. 5. 用 worktree 隔離多個 Agent

    Git worktree 怎麼用?隔離多個 AI coding agent 的工作目錄

    Git worktree 可以在同一個 repository 同時建立多個工作目錄,讓不同 AI coding agent 各自使用分支並保留獨立檔案狀態。本文整理建立、列出、驗證、合併、移除與 prune 的安全流程。

  6. 6. 驗收自架模型能否承接 Agent 工作

    自架模型接 Codex/OpenCode:相容 API、延遲與成本怎麼驗收

    自架模型能回覆聊天,不代表能完整承接 Codex 或 OpenCode 的 coding agent 工作。本文區分 Responses 與 Chat Completions 相容性,提供工具回合、上下文、取消、併發和回復測試,以及每個驗收成功任務的成本計算方式,避免直接套用別家 GPU 部署的節省比例。

Stage 02

怎麼限制 Agent 能碰的東西?

只給它完成任務需要的權限。密碼、正式主機和瀏覽器登入,都要另外看管。

  1. 7. 判斷 MCP 是否必要

    接 MCP 前先做能力盤點:什麼情況其實不需要外部工具

    看到 AI coding workflow 加上 MCP 就想跟著安裝嗎?本文先盤點 agent 內建能力、官方入口、真正缺口與資料權限,再用最小 scope 判斷是否需要連接外部 MCP server,避免不必要的整合風險。

  2. 8. 限制自動化權限與回合

    Claude Code 自動跑任務前:Auto 權限模式、白名單與回合上限

    Claude Code 排程要驗收工具拒絕、程序結束碼和產物是否完成。本文說明 v2.1.319 的 denyInsteadOfPrompting、Auto 安全檢查缺失時 claude -p 的退出行為,並用測試資料檢查白名單、回合上限與 sandbox 保護。

  3. 9. 驗收 Code Mode 的批次工具權限

    Claude Code Code Mode 怎麼開?批次工具呼叫與權限驗收

    Claude Code Code Mode 讓終端機工作階段用一段 JavaScript 串接多個工具。本文用唯讀文件盤點說明如何確認功能已啟用、從逐字稿檢查執行內容,並拆解 auto mode、個別工具規則與 hooks 各自能看到什麼,方便決定哪些工作適合試用。

  4. 10. 阻擋敏感檔案與危險操作

    Claude Code 要讀取敏感檔案前:用 PreToolUse hook 多加一道阻擋規則

    Claude Code 能讀取專案脈絡,但不該把 .env、私鑰或部署憑證當成一般檔案處理。本文用官方 PreToolUse hook 格式建立可檢查的阻擋規則與測試方式,並說明它與權限設定各自負責的邊界。

  5. 11. 檢查 Plugin、Skills 與 Apps 權限

    Codex Plugin 怎麼裝才安全:先分清 Skills、Apps 與權限

    Codex Plugin Directory 已取代 App Directory。安裝前先檢查外掛內含的 skills、Apps、同步範圍與可執行動作,避免在正式環境中把「目錄可見」誤當成可安全使用。

  6. 12. 排查非預期的 AGENTS.md 指令

    下載資料夾的 AGENTS.md 劫持 Codex:設定檔檢查與移除步驟

    曾在下載資料夾啟動 Codex 或 Claude Code?本文依原始研究整理 AGENTS.md 指令注入事件,說明 config.toml、Claude Code settings.json 與上層指令檔的檢查順序,以及發現惡意 MCP 註冊、function-color 安裝痕跡後的移除與憑證處理界線。

  7. 13. 盤點正式伺服器的操作權限

    Codex 操作正式伺服器前:sandbox、approval 與 SSH 權限檢查

    讓 Codex 操作正式伺服器前,先核對 sandbox、approval policy、SSH 帳號與外部工具權限。本文依官方文件說明 read-only、workspace-write、on-request 與 never 的差異,提供先產生操作計畫、逐項核准及事後比對的方法,避免把提示詞當成系統存取限制。

  8. 14. 隔離 Agent 操作的瀏覽器

    Chrome DevTools MCP 安全設定:隔離瀏覽器並限制 Agent 權限

    Chrome DevTools MCP 可讓 Codex 等代理檢查真實 Chrome,也會暴露瀏覽器內容。本文整理隔離 profile、限制網址、停用 JavaScript 評估與遙測的方法,並說明這些設定仍無法取代信任邊界。

  9. 15. 限制瀏覽器配對與可去的網站

    OpenCode Browse 設定:配對瀏覽器、限制網站與接手登入

    OpenCode Browse 透過 MCP 與 Chromium 擴充功能操作現有瀏覽器。第一次使用時,本文帶你核對配對與分頁範圍、設定工作階段的網站 allowlist,並用測試帳號驗收登入交接、站外導覽及撤銷配對。也說明哪些網路請求仍可能送出。

Stage 03

怎麼確認它真的做完了?

把「完成」定義成看得到的結果:改了哪些檔案、測試有沒有過、介面有沒有照預期變化,而不是一句「已完成」。

  1. 16. 修正空轉的執行迴圈

    AI Agent 調校筆記:從「說說而已」到「真的有做」

    讓 coding agent 獨自開發時,常見的假進度問題與執行鏈設計缺陷,以及一套改善方向的個人紀錄。不保證有效。

  2. 17. 定義可觀察的完成狀態

    AI coding agent 一直原地打轉?把「完成」改寫成可驗證的狀態

    AI coding agent 說完成卻沒有真正改到程式碼時,問題常在完成條件太模糊。用可驗證的狀態、檢查指令與停止條件,讓任務可以被確認。

  3. 18. 用獨立上下文驗收規格審查

    Elephant-Goldfish Model 怎麼審規格?Codex 獨立上下文驗收

    Elephant-Goldfish Model 將寫規格與審規格拆給不同上下文的代理。本文以 Codex 為例,說明如何準備只靠文件就能審查的驗收條件、辨識審查是否真的完成,並用假標記測試父對話與專案指令是否出現在審查者可見的資訊中。

  4. 19. 用本機 WebKit 觀察介面驗收

    Agweb 怎麼用?在 macOS 觀察本機 WebKit 介面驗收

    Agweb 是 macOS 上使用系統 WebKit 的瀏覽器,可讓開發代理操作自己的測試分頁,同時用 Dashboard 觀察結果。本文以本機頁面為例說明怎麼分開工作區和登入狀態、如何核對互動結果,以及哪些檢查應留在 Playwright。

  5. 20. 保存並驗收可重用的任務提示

    Codex CLI presets 教學:保存提示、重用指令與執行前驗收

    Codex CLI 0.164.0 加入十個 presets 槽位,可重用提示與 slash command。本文說明建立、保存、編輯與呼叫流程,區分保存和直接執行,並提供草稿保留、重新啟動讀回、權限核對與圖片/連結提及的驗收方法,避免把提示快捷鍵誤當成專案規則或跨介面同步。

  6. 21. 執行排程前檢查登入到期

    Claude Code 排程前怎麼查登入到期?2.1.318 新欄位與紀錄方式

    Claude Code 2.1.318 在 auth status 與 print JSON 加入登入到期資訊。本文整理 loginExpiresAt、credential_expires_at 與到期前十天的 stderr 提醒,說明排程環境核對、未知欄位處理及日誌分流,提前發現需要重新登入的帳號。

Stage 04

擔心外洩或被植入惡意程式?

插件、擴充套件和本機設定檔都可能出問題。出事時先查版本和來源,再檢查主機和 Git 紀錄。

  1. 22. 驗證 Plugin 的實際來源

    Plugin4Shell 影響哪些 AI coding agent?插件 SHA 驗證與盤點清單

    Plugin4Shell 揭示 AI coding agent 的 Git Plugin 不能只相信固定 SHA。本文整理公開修補狀態、實際 HEAD 驗證、auto-update 暫停與最小權限盤點流程。

  2. 23. 檢查遭竄改的擴充套件

    Cursor 的 Claude Code 擴充套件遭竄改:影響版本與主機檢查順序

    Cursor 公告其擴充套件市集曾散布遭竄改的 Claude Code 2.1.312 與 2.1.313。本文分開核對來源、作業系統及安裝時間,說明卸載後仍需檢查 SSH 金鑰與持久化痕跡,並區分查無指標、無法讀取與確認未受影響,避免只靠目前版本或單次掃描結案。

  3. 24. 清掉存在設定與歷史裡的密碼

    Claude Code 不再詢問存了密碼?檢查 settings.local.json 與 Git 歷史

    Claude Code 的 Bash 持續核准會寫入 settings.local.json。若當時的規則含明文密碼或金鑰,先在本機核對規則,再用 Git 分清忽略、追蹤與歷史三種狀態。本文用不含真實憑證的指令示範如何停止追蹤,並說明何時先輪替憑證及如何避免再寫入。

  4. 25. 確認帳號資訊有沒有被送出

    Claude Code email 出現在 User-Agent?先查版本與 privacy mod 邊界

    Claude Code 帳號 email 外送疑慮該怎麼查?本文對照 2.1.317 release 與官方 privacy mod README,分清版本、外掛啟用及實際請求三層證據,整理 shell、WebFetch、MCP 的涵蓋差異,協助保留去識別紀錄並判斷後續處理。

  5. 26. 把第三方主題當外掛來審

    Claude Code 桌面版自訂主題:換背景與排查未顯示

    Claude Code 桌面版可用官方 theme-examples 外掛替專案或單次對話換背景。本文說明 custom-theme 的套用範圍和清除指令,並用 Code 分頁版本、視窗渲染能力與減少動態效果設定,找出指令有回覆但背景沒出現的原因。

Stage 05

用量暴增或突然不能用?

先分清是官方的狀況還是自己電腦的問題,留好證據再動設定。

  1. 27. 區分官方事故與本機問題

    Claude Code 出現模型錯誤時:先判斷官方事故,還是自己的環境問題

    Claude Code 突然出現模型錯誤、OAuth 登入失敗或請求逾時時,先別急著重裝。本文依官方狀態頁與 troubleshooting 文件整理判斷順序,保留可交接的錯誤證據,避免重複重裝與遺失線索。

  2. 28. 出差前確認所在地區能不能用

    Claude Code 出差能用嗎?Anthropic 支援地區怎麼查

    Anthropic 於 2026 年 11 月 12 日生效的支援地區政策涵蓋 Claude Code、API 與授權雲端通路。台灣開發者到中國、香港或澳門出差前,可依使用當下的位置、公司的註冊地與總部、以及控股和控制關係,確認哪些工作要提前安排。

  3. 29. 建立最小唯讀診斷範圍

    用 Claude Code 查本機異常前:先做可審核的診斷範圍

    遇到電腦發燙、程式反覆崩潰或背景程序異常時,不要直接把整台電腦交給 Claude Code。本文用最小日誌、唯讀權限、證據分級與完成條件,建立可審核、能重跑並兼顧隱私的本機診斷流程。

  4. 30. 觀測 Claude Code 與 Codex 用量

    RunCat Neo 顯示 Claude Code 與 Codex 用量:Desktop 排錯與設定

    想在 macOS 選單列查看 Claude Code、Codex 的 Context 與額度?本文記錄 RunCat Neo Custom Metrics 設定,並處理 Desktop 不觸發 hook、資料不更新與 Full reset 顯示問題。

  5. 31. 排查瀏覽器工具連線與登入

    Codex Desktop 瀏覽器工具連不上:先分流登入、擴充功能與啟動錯誤

    Codex 的 @Browser 與 @Chrome 使用不同瀏覽器設定檔。本文依 Settings > Computer Use、Chrome profile、網站授權與公開頁測試,分流登入、擴充功能連線及啟動錯誤,並列出安全回報資料。

  6. 32. 排查啟動卡住與長清單問題

    Claude Code 啟動卡住:v2.1.311 的 CLAUDE.md 長清單修正

    Claude Code 啟動或讀寫檔案時長時間凍結,可能與 CLAUDE.md 過長的清單項目有關。本文依 v2.1.311 官方修正,提供只輸出行號與長度的本機檢查器、隔離副本比較與升級後驗收順序,區分已確認的版本修正和仍待重現的個別原因,避免直接清空正式指令檔。

  7. 33. 排查 proxy 與 gateway 的 400 錯誤

    Claude Code proxy 請求失敗:2.1.307 gateway 修正與 400 排錯

    Claude Code 經 proxy 或 gateway 請求失敗,先核對版本、被拒欄位與啟動環境。本文新增 2.1.307 beta header 修正與 model alias 分流,並區分 ToolSearch、context_management 及 advisor 400 的驗收門檻。

  8. 34. 分清訂閱用量與 API credits

    Claude Code 用量與 API credits:Max 每月贈額能不能續跑?

    Max 每月新增的 API credits 不能拿來延長互動式 Claude Code。本文分清訂閱內含用量、Claude usage credits、Console 付費餘額與每月 API 贈額,提供登入方式、環境變數及帳單頁的核對流程,避免只看到 credits 就判定長任務可以免費續跑。

  9. 35. 安排 Codex Reset 的使用時機

    Codex Reset 是什麼?Banked Reset 在哪查、什麼時候該用

    Codex 的 banked reset 是存在帳號裡、要自己手動套用的一次性重設,不會提高方案額度。本文說明在哪裡查看 Reset、什麼時候用最划算,以及它和 5 小時限制、週限制、自動重設與 Pro 方案變更的差別。