適合:剛開始用 AI 寫程式的人、Claude Code 與 Codex 使用者、想讓 Agent 自動跑任務的開發者
AI Coding Agent 上手:權限、安全與驗收
把程式交給 Claude Code、Codex 這類 AI 助手,最怕它亂改檔案、碰到不該碰的資料,或說做完了其實沒做完。這個專題從選工具、劃好權限,到確認成果、處理用量異常,帶你一步步把 Agent 用得放心。
我該用哪個 Agent、在哪裡跑?
先弄清楚終端機工具、桌面 App 和自架模型各適合做什麼,再決定把哪個專案交出去。
- 1. 建立隔離執行環境
OpenHands 1.40 教學:模型選擇、草稿與 Automation 驗收
OpenHands Canvas 1.40 修正自架服務關閉 Agent Profiles 後的首頁模型選擇,也修正舊訊息延遲確認時可能清掉新草稿的問題。本文提供兩項升級驗收,並保留 Automation preset 選擇、Script bundle 匯入與 Runtime 排查流程。
- 2. 認識終端機 Agent 介面
Gemini CLI:你的終端機 AI 夥伴
這篇文章將帶你深入了解 Gemini CLI,一個讓你能直接在終端機與強大 AI 模型互動的工具。從基本介紹、安裝到進階應用,讓你成為命令列操作的 AI 大師。
- 3. 安裝 Claude Code 原生工具
Claude Code 怎麼安裝?macOS、Linux、WSL 與 Windows 指令
整理 Claude Code 目前官方安裝方式:macOS、Linux、WSL、Windows PowerShell、CMD、Homebrew 與 WinGet,並說明 Native Install、自動更新、登入與版本驗證,避免用錯終端機指令。
- 4. 整理跨專案的 MCP 設定
Claude Code MCP 設定研究:跨專案配置經驗分享
深入探討 Claude Code MCP 的三種作用域設定差別,以及如何實現跨專案和跨電腦的統一配置,解決開發者在多個環境下的 MCP 工具管理需求。
- 5. 用 worktree 隔離多個 Agent
Git worktree 怎麼用?隔離多個 AI coding agent 的工作目錄
Git worktree 可以在同一個 repository 同時建立多個工作目錄,讓不同 AI coding agent 各自使用分支並保留獨立檔案狀態。本文整理建立、列出、驗證、合併、移除與 prune 的安全流程。
- 6. 驗收自架模型能否承接 Agent 工作
自架模型接 Codex/OpenCode:相容 API、延遲與成本怎麼驗收
自架模型能回覆聊天,不代表能完整承接 Codex 或 OpenCode 的 coding agent 工作。本文區分 Responses 與 Chat Completions 相容性,提供工具回合、上下文、取消、併發和回復測試,以及每個驗收成功任務的成本計算方式,避免直接套用別家 GPU 部署的節省比例。
怎麼限制 Agent 能碰的東西?
只給它完成任務需要的權限。密碼、正式主機和瀏覽器登入,都要另外看管。
- 7. 判斷 MCP 是否必要
接 MCP 前先做能力盤點:什麼情況其實不需要外部工具
看到 AI coding workflow 加上 MCP 就想跟著安裝嗎?本文先盤點 agent 內建能力、官方入口、真正缺口與資料權限,再用最小 scope 判斷是否需要連接外部 MCP server,避免不必要的整合風險。
- 8. 限制自動化權限與回合
Claude Code 自動跑任務前:Auto 權限模式、白名單與回合上限
Claude Code 排程要驗收工具拒絕、程序結束碼和產物是否完成。本文說明 v2.1.319 的 denyInsteadOfPrompting、Auto 安全檢查缺失時 claude -p 的退出行為,並用測試資料檢查白名單、回合上限與 sandbox 保護。
- 9. 驗收 Code Mode 的批次工具權限
Claude Code Code Mode 怎麼開?批次工具呼叫與權限驗收
Claude Code Code Mode 讓終端機工作階段用一段 JavaScript 串接多個工具。本文用唯讀文件盤點說明如何確認功能已啟用、從逐字稿檢查執行內容,並拆解 auto mode、個別工具規則與 hooks 各自能看到什麼,方便決定哪些工作適合試用。
- 10. 阻擋敏感檔案與危險操作
Claude Code 要讀取敏感檔案前:用 PreToolUse hook 多加一道阻擋規則
Claude Code 能讀取專案脈絡,但不該把 .env、私鑰或部署憑證當成一般檔案處理。本文用官方 PreToolUse hook 格式建立可檢查的阻擋規則與測試方式,並說明它與權限設定各自負責的邊界。
- 11. 檢查 Plugin、Skills 與 Apps 權限
Codex Plugin 怎麼裝才安全:先分清 Skills、Apps 與權限
Codex Plugin Directory 已取代 App Directory。安裝前先檢查外掛內含的 skills、Apps、同步範圍與可執行動作,避免在正式環境中把「目錄可見」誤當成可安全使用。
- 12. 排查非預期的 AGENTS.md 指令
下載資料夾的 AGENTS.md 劫持 Codex:設定檔檢查與移除步驟
曾在下載資料夾啟動 Codex 或 Claude Code?本文依原始研究整理 AGENTS.md 指令注入事件,說明 config.toml、Claude Code settings.json 與上層指令檔的檢查順序,以及發現惡意 MCP 註冊、function-color 安裝痕跡後的移除與憑證處理界線。
- 13. 盤點正式伺服器的操作權限
Codex 操作正式伺服器前:sandbox、approval 與 SSH 權限檢查
讓 Codex 操作正式伺服器前,先核對 sandbox、approval policy、SSH 帳號與外部工具權限。本文依官方文件說明 read-only、workspace-write、on-request 與 never 的差異,提供先產生操作計畫、逐項核准及事後比對的方法,避免把提示詞當成系統存取限制。
- 14. 隔離 Agent 操作的瀏覽器
Chrome DevTools MCP 安全設定:隔離瀏覽器並限制 Agent 權限
Chrome DevTools MCP 可讓 Codex 等代理檢查真實 Chrome,也會暴露瀏覽器內容。本文整理隔離 profile、限制網址、停用 JavaScript 評估與遙測的方法,並說明這些設定仍無法取代信任邊界。
- 15. 限制瀏覽器配對與可去的網站
OpenCode Browse 設定:配對瀏覽器、限制網站與接手登入
OpenCode Browse 透過 MCP 與 Chromium 擴充功能操作現有瀏覽器。第一次使用時,本文帶你核對配對與分頁範圍、設定工作階段的網站 allowlist,並用測試帳號驗收登入交接、站外導覽及撤銷配對。也說明哪些網路請求仍可能送出。
怎麼確認它真的做完了?
把「完成」定義成看得到的結果:改了哪些檔案、測試有沒有過、介面有沒有照預期變化,而不是一句「已完成」。
- 16. 修正空轉的執行迴圈
AI Agent 調校筆記:從「說說而已」到「真的有做」
讓 coding agent 獨自開發時,常見的假進度問題與執行鏈設計缺陷,以及一套改善方向的個人紀錄。不保證有效。
- 17. 定義可觀察的完成狀態
AI coding agent 一直原地打轉?把「完成」改寫成可驗證的狀態
AI coding agent 說完成卻沒有真正改到程式碼時,問題常在完成條件太模糊。用可驗證的狀態、檢查指令與停止條件,讓任務可以被確認。
- 18. 用獨立上下文驗收規格審查
Elephant-Goldfish Model 怎麼審規格?Codex 獨立上下文驗收
Elephant-Goldfish Model 將寫規格與審規格拆給不同上下文的代理。本文以 Codex 為例,說明如何準備只靠文件就能審查的驗收條件、辨識審查是否真的完成,並用假標記測試父對話與專案指令是否出現在審查者可見的資訊中。
- 19. 用本機 WebKit 觀察介面驗收
Agweb 怎麼用?在 macOS 觀察本機 WebKit 介面驗收
Agweb 是 macOS 上使用系統 WebKit 的瀏覽器,可讓開發代理操作自己的測試分頁,同時用 Dashboard 觀察結果。本文以本機頁面為例說明怎麼分開工作區和登入狀態、如何核對互動結果,以及哪些檢查應留在 Playwright。
- 20. 保存並驗收可重用的任務提示
Codex CLI presets 教學:保存提示、重用指令與執行前驗收
Codex CLI 0.164.0 加入十個 presets 槽位,可重用提示與 slash command。本文說明建立、保存、編輯與呼叫流程,區分保存和直接執行,並提供草稿保留、重新啟動讀回、權限核對與圖片/連結提及的驗收方法,避免把提示快捷鍵誤當成專案規則或跨介面同步。
- 21. 執行排程前檢查登入到期
Claude Code 排程前怎麼查登入到期?2.1.318 新欄位與紀錄方式
Claude Code 2.1.318 在 auth status 與 print JSON 加入登入到期資訊。本文整理 loginExpiresAt、credential_expires_at 與到期前十天的 stderr 提醒,說明排程環境核對、未知欄位處理及日誌分流,提前發現需要重新登入的帳號。
擔心外洩或被植入惡意程式?
插件、擴充套件和本機設定檔都可能出問題。出事時先查版本和來源,再檢查主機和 Git 紀錄。
- 22. 驗證 Plugin 的實際來源
Plugin4Shell 影響哪些 AI coding agent?插件 SHA 驗證與盤點清單
Plugin4Shell 揭示 AI coding agent 的 Git Plugin 不能只相信固定 SHA。本文整理公開修補狀態、實際 HEAD 驗證、auto-update 暫停與最小權限盤點流程。
- 23. 檢查遭竄改的擴充套件
Cursor 的 Claude Code 擴充套件遭竄改:影響版本與主機檢查順序
Cursor 公告其擴充套件市集曾散布遭竄改的 Claude Code 2.1.312 與 2.1.313。本文分開核對來源、作業系統及安裝時間,說明卸載後仍需檢查 SSH 金鑰與持久化痕跡,並區分查無指標、無法讀取與確認未受影響,避免只靠目前版本或單次掃描結案。
- 24. 清掉存在設定與歷史裡的密碼
Claude Code 不再詢問存了密碼?檢查 settings.local.json 與 Git 歷史
Claude Code 的 Bash 持續核准會寫入 settings.local.json。若當時的規則含明文密碼或金鑰,先在本機核對規則,再用 Git 分清忽略、追蹤與歷史三種狀態。本文用不含真實憑證的指令示範如何停止追蹤,並說明何時先輪替憑證及如何避免再寫入。
- 25. 確認帳號資訊有沒有被送出
Claude Code email 出現在 User-Agent?先查版本與 privacy mod 邊界
Claude Code 帳號 email 外送疑慮該怎麼查?本文對照 2.1.317 release 與官方 privacy mod README,分清版本、外掛啟用及實際請求三層證據,整理 shell、WebFetch、MCP 的涵蓋差異,協助保留去識別紀錄並判斷後續處理。
- 26. 把第三方主題當外掛來審
Claude Code 桌面版自訂主題:換背景與排查未顯示
Claude Code 桌面版可用官方 theme-examples 外掛替專案或單次對話換背景。本文說明 custom-theme 的套用範圍和清除指令,並用 Code 分頁版本、視窗渲染能力與減少動態效果設定,找出指令有回覆但背景沒出現的原因。
用量暴增或突然不能用?
先分清是官方的狀況還是自己電腦的問題,留好證據再動設定。
- 27. 區分官方事故與本機問題
Claude Code 出現模型錯誤時:先判斷官方事故,還是自己的環境問題
Claude Code 突然出現模型錯誤、OAuth 登入失敗或請求逾時時,先別急著重裝。本文依官方狀態頁與 troubleshooting 文件整理判斷順序,保留可交接的錯誤證據,避免重複重裝與遺失線索。
- 28. 出差前確認所在地區能不能用
Claude Code 出差能用嗎?Anthropic 支援地區怎麼查
Anthropic 於 2026 年 11 月 12 日生效的支援地區政策涵蓋 Claude Code、API 與授權雲端通路。台灣開發者到中國、香港或澳門出差前,可依使用當下的位置、公司的註冊地與總部、以及控股和控制關係,確認哪些工作要提前安排。
- 29. 建立最小唯讀診斷範圍
用 Claude Code 查本機異常前:先做可審核的診斷範圍
遇到電腦發燙、程式反覆崩潰或背景程序異常時,不要直接把整台電腦交給 Claude Code。本文用最小日誌、唯讀權限、證據分級與完成條件,建立可審核、能重跑並兼顧隱私的本機診斷流程。
- 30. 觀測 Claude Code 與 Codex 用量
RunCat Neo 顯示 Claude Code 與 Codex 用量:Desktop 排錯與設定
想在 macOS 選單列查看 Claude Code、Codex 的 Context 與額度?本文記錄 RunCat Neo Custom Metrics 設定,並處理 Desktop 不觸發 hook、資料不更新與 Full reset 顯示問題。
- 31. 排查瀏覽器工具連線與登入
Codex Desktop 瀏覽器工具連不上:先分流登入、擴充功能與啟動錯誤
Codex 的 @Browser 與 @Chrome 使用不同瀏覽器設定檔。本文依 Settings > Computer Use、Chrome profile、網站授權與公開頁測試,分流登入、擴充功能連線及啟動錯誤,並列出安全回報資料。
- 32. 排查啟動卡住與長清單問題
Claude Code 啟動卡住:v2.1.311 的 CLAUDE.md 長清單修正
Claude Code 啟動或讀寫檔案時長時間凍結,可能與 CLAUDE.md 過長的清單項目有關。本文依 v2.1.311 官方修正,提供只輸出行號與長度的本機檢查器、隔離副本比較與升級後驗收順序,區分已確認的版本修正和仍待重現的個別原因,避免直接清空正式指令檔。
- 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 的驗收門檻。
- 34. 分清訂閱用量與 API credits
Claude Code 用量與 API credits:Max 每月贈額能不能續跑?
Max 每月新增的 API credits 不能拿來延長互動式 Claude Code。本文分清訂閱內含用量、Claude usage credits、Console 付費餘額與每月 API 贈額,提供登入方式、環境變數及帳單頁的核對流程,避免只看到 credits 就判定長任務可以免費續跑。
- 35. 安排 Codex Reset 的使用時機
Codex Reset 是什麼?Banked Reset 在哪查、什麼時候該用
Codex 的 banked reset 是存在帳號裡、要自己手動套用的一次性重設,不會提高方案額度。本文說明在哪裡查看 Reset、什麼時候用最划算,以及它和 5 小時限制、週限制、自動重設與 Pro 方案變更的差別。