請輸入密碼
此頁面受密碼保護
進入 →
密碼錯誤，請重試
🤖 AI Agent
踩坑筆記
教會事工
Google 服務
Claude / MCP
視頻媒體
環境設定
即將更新
Thomas 的 AI Agent 實戰筆記
踩過的坑，
都在這裡
用 Claude Code 操作各種 AI Agent 時遇到的真實問題與解答
從小白角度出發，每篇都附流程圖與操作步驟
31
篇指南
5
個分類
∞
持續更新
⛪ 教會事工
🔵 Google 服務
🟣 Claude / MCP
🎬 視頻媒體
⚙️ 環境設定
🔜 即將更新
⛪ 教會事工自動化
1 篇
✝️
每週自動化
Gmail PDF
已驗證
把講道 PPT 變成精美網頁（早堂＋晚堂）
每週從 EFCCA 周報 PDF 自動抓取講員、主題、討論題、金句，建立詳細講道頁面，部署到 sermon-index.pages.dev。只需說一句話，六步全自動。
🎵
即將更新
音控輪值表自動生成
根據輪值規則（璐璐固定搭配等）自動生成 Google Sheets 音控排班表。
🔵 Google 服務
5 篇
🎬
OAuth
YouTube
Handover
Google OAuth 全家桶 + YouTube 上傳 + Handover
一次授權打通 YouTube、Drive、Gmail 等 7 個 Google 服務。附 Claude IDE ↔ 終端機雙窗口 Handover 協作術。
📧
Gmail API
已完成
Claude 怎麼收發 Gmail？三種方式全解析
MCP 只能讀、SMTP 雲端被封、Gmail REST API 才是正解。附真實踩坑：定時任務發不出郵件的根本原因與修復流程。
🔐
OAuth
Sign-In
GCP OAuth + Google Sign-In 前端認證踩坑
gcloud 建不了 OAuth Client？6 個 API 全 404？用桌面自動化搞定 Console，再到完整 JWT + localStorage 認證模板。
🔑
Drive API
OAuth
Google Drive API 小白指南
開啟 API、建立同意頁面、下載憑證、完成 OAuth 授權的完整流程。含 GCP Secret Manager 安全保管方案。
🛡️
OAuth
品牌驗證
已完成
Google OAuth 品牌驗證 + Photos API 踩坑全記錄
Testing vs Production token 過期陷阱、品牌驗證流程、Photos API 403 限制、多台電腦共享 Token 完整方案。
📧
即將更新
Gmail API 接入 Claude MCP
讓 Claude 讀取、搜尋、起草 Gmail 郵件的完整設定流程。
📅
即將更新
Google Calendar API 設定
透過 MCP 讓 Claude 讀取和建立 Google Calendar 行程。
🟣 Claude / MCP
11 篇
⚠️
踩坑實錄
設定陷阱
已完成
Claude Code 設定陷阱：本地覆蓋全局，AI 瞬間失憶
settings.local.json 遮蔽 settings.json，導致 Hooks 消失、記憶碎片化。附雙機架構分析、方案比較、一條 registry 命令的終極解法。
📈
MCP
已完成
Alpaca 量化交易 API 接入 Claude MCP
六個 Windows 踩坑紀錄，含 uvx 問題、GBK 編碼、gcloud 路徑、Python os.execv 不穩定。最終用 .bat wrapper 完美解決。
⚠️
踩坑實錄
Claude Code 設定
CLAUDE.md 與 settings.json 必須同步
AI 為什麼每次都問同一件事？兩個設定文件打架的根本原因、生活比喻、永久規則與修復步驟。
📊
期權數據
已完成
用 Claude + Alpaca API 查期權數據：踩坑實錄
MCP 新對話消失、六步拆單、v1beta1 正確端點、盤後 Put/Call 價差謎題。一條 Python 指令直接輸出 Bid/Ask/IV/Delta 完整表格。
🗣️
白話文下單
已完成
用 Claude Code 白話文下單：期權策略從零到成交
一句話查報價、一句話算破蝴蝶、一句話掛四條腿組合單。含完整對話流程圖和小白入門步驟，全程不寫代碼。
🔌
即將更新
什麼是 MCP？從零理解
MCP（Model Context Protocol）是什麼，為什麼 Claude 需要它，如何安裝和設定 MCP Server。
🖥️
VS Code 操作
已完成
VS Code + Claude Code 多窗口操作小白指南
settings.json 設定解析、多窗口並行任務、記憶/Agent/Skill 區別、bypass 權限一勞永逸。新手必讀的 VS Code 操作手冊。
🔐
權限設定
已完成
Claude Code 權限設定踩坑：bypass 了還在問？
項目級覆蓋全局、當前 session 不生效、allow 白名單越積越長——三個坑的連鎖反應與一次搞定的完整解法。
🐛
Bug 調查
已完成
Bypass 權限失效完全指南：為什麼設了還在問？
Reddit + GitHub 深度調查：三個已知 Bug（VS Code 不讀設定、偷偷降級、.claude 硬編碼），通配符解法 + 完整設定範本。
💬
架構設想
已完成
Alpaca 白話文交易助手架構設想
Worker 中轉 + DeepSeek 翻譯 + Alpaca API，兩階段方案對比與安全機制設計。從零規劃手機上就能操作的交易助手。
🔄
Stop Hook
Junction
已完成
Claude Code 雙機自動備份系統
Stop Hook、Junction 策略、防衝突機制、踩坑實錄——手把手教你讓台式機和筆記本的 Claude Code 對話結束自動同步備份。
📱
遠程控制
已完成
Claude Code 遠程控制：手機操控電腦完整指南
人在外面，電腦在家跑——手機即時下命令、看結果。含 RC vs Dispatch 對比、開機自動啟動腳本，一次設定永久可用。
🤖
GLM 5 Turbo
已完成
GLM 5 Turbo API 接入踩坑實錄
模型名稱猜錯 400、推理 token 耗盡 content 空字串、配額只在特定模型——三個坑加完整代碼，10 分鐘搞定外部大模型接入。
⏰
即將更新
設定 Claude 排程自動任務
用 GitHub Actions 讓 Claude 每天自動發送日曆摘要、Gmail 重點到你的信箱。
⚙️ 環境設定
15 篇
🪝
Stop Hook
Git 自動備份
已完成
Stop Hook：Claude 回覆完，自動 Git 備份
每次 Claude 回覆你一句，背後就跑一次 Git 同步。附智能過濾邏輯（有改才 Push）、完整 settings.json 範例、小白一步步設置。
🚫
F12 破解
Cloudflare
已完成
密碼保護踩坑：F12 一秒破解到後端驗證
前端密碼被 F12 一行代碼破解，SHA-256 也救不了。改用 Cloudflare Pages Functions Middleware，放一個文件就實現真正的後端保護。
🔒
安全
密碼
已完成
網站密碼保護全攻略：明文→Hash→後端驗證
安全等級金字塔 + SHA-256 Hash 實操 + 密碼強度對比。從小白角度搞懂前端 vs 後端驗證的根本區別。
🔒
即將更新
GCP Secret Manager 統一管理密鑰
把所有 AI 模型的 API Key 和 credentials.json 集中存入 GCP Secret Manager，再也不怕洩漏。
🚀
自動部署
已完成
GitHub + Cloudflare Pages 自動部署
一次設定，以後 git push 自動更新網站；含 bat 一鍵腳本，從此告別手動上傳。
🔒
Git 備份
已完成
Git 私人備份 Repo 小白指南
用 GitHub 私人倉庫當雲端保險箱，配合 .bat 腳本一鍵備份。附 .gitignore 踩坑教訓：node_modules 與 Token 文件的正確排除方式。
🔄
Git 基礎
已完成
Git Pull & Push 小白完全指南
用「公共白板」比喻說清楚 Push/Pull 的方向，為什麼要先 Pull 再 Push，多台電腦同步 Claude Code 記憶的完整流程與六個常用命令。
🔁
Git 同步
已完成
Git 同步 Claude 記憶：多台電腦共享技能完全指南
用「雲端筆記本」比喻把 Git 同步說清楚，附詞彙表 10 詞、step-by-step 流程、一鍵 .bat 腳本，小白也能在台式機和筆記本之間無縫共享 Claude Code 記憶。
🧠
記憶同步
已完成
Claude 記憶同步手冊：每天兩步，讓所有電腦的 Claude 都一樣聰明
每天兩步，讓所有電腦的 Claude 都一樣聰明。附 Tab 分頁：為什麼要同步、每天怎麼做、10 個詞彙解釋、出問題怎麼辦。
🔗
雙機同步
Junction
已完成
兩台電腦共享 Claude Code 記憶：完整設置指南
Junction 文件夾捷徑、Stop Hook 自動 Push、路徑映射、Merge Conflict 處理、安全鐵律。讓台式機和筆記本的 CC 共享同一套記憶。
🖥
雙機設置
踩坑實錄
已完成
兩台電腦共用 Claude Code — 從零踩坑到成功完整紀錄
Junction 捷徑、Session 0 vs 1 大坑、WinRM 限制、Workspace Trust、開機自啟動排程任務。讓台式機和筆記本完全共享記憶與技能。
🌐
瀏覽器自動化
已完成
用 Claude Code + Playwright 操控真實瀏覽器
Chrome Debug 模式、Playwright 自動登入、GCP SM 讀密碼、Gmail MCP 讀驗證碼。從 UI 自動化的坑到 API 的正道，全紀錄。
🖨️
python-docx
win32print
已完成
學習筆記排版＋雙面打印 小白指南
把課程測驗問題＋答案自動排版成 2 頁 A4 Word 文件，一鍵發送到 Brother 印表機雙面打印。含必踩的坑：PrintOut 不支援 Duplex 參數，必須改用 DevMode。
💾
Windows
已完成
一鍵全自動裝 Windows：USB 安裝盤完整指南
USB 插上重啟，零手動操作直接進桌面。含 autounattend.xml 完整模板、三大踩坑錯誤修復、通用安裝金鑰說明。
🔧
踩坑記錄
Windows
已完成
幫媽媽裝電腦踩過的坑：Windows USB 全自動安裝完整排錯指南
XML 第 18 行報錯、ProductKey 讀不到、bat 黑框一閃而過、USB 文件寫入受限。四個真實踩坑加完整排錯清單，讓你少走彎路。
🏠
NAS
WinRM
已完成
家庭網絡管理：NAS + 遠控電腦 完全小白指南
QNAP NAS SSH 連線踩坑（Web API RSA 加密繞不過 → 改 SSH）、WinRM 遠控 Windows 電腦四個坑全解析。附局域網掃描腳本與 Python 遠控模板。
📱
scrcpy
ADB
已完成
WiFi 遠控 Android 手機（scrcpy 完全小白指南）
用 scrcpy 在電腦上控制手機螢幕，純 WiFi 免插線。一次 USB 認證，之後雙擊腳本就連。含 OPPO 隨機 MAC 坑、中文輸入剪貼板方法、重開機重連步驟。
🎬 視頻 / 媒體處理
1 篇
🎬
ffmpeg
教會活動
ffmpeg 視頻剪輯小白指南
截取、拼接、加背景音樂一次搞懂。含 Stream Copy vs 重新編碼的選擇指南，以受難日崇拜為實戰案例。
🎵
即將更新
用 Claude 自動化教會崇拜影片流程
把程序稿 PDF 轉成 ffmpeg 指令，一鍵完成所有片段剪輯。
🔜 還在寫的指南
有什麼坑踩到了，就會加進來 ↓
· Notion API 接入 MCP
· Cloudflare Workers 部署 AI Agent
· ffmpeg 視頻剪輯自動化
· Windows + bash 路徑衝突排查
· GCP 各種 Permission Denied 錯誤排查
·
更多持續補充中…