Thomas 的 AI Agent 實戰筆記

踩過的坑，都在這裡

用 Claude Code 操作各種 AI Agent 時遇到的真實問題與解答
從小白角度出發，每篇都附流程圖與操作步驟

7
篇指南
3
個主題分類
∞
持續更新
📚 全部指南 🔵 Google 服務 🟣 Claude / MCP 🎬 視頻媒體 ⚙️ 環境設定 🔜 即將更新
📚 全部指南
7 篇
🔑
Google 已完成
Google Drive API 小白指南
從零理解 API、OAuth、憑證、同意頁面的意思與操作步驟。附多個 credentials.json 安全保管方案對比。
Google Cloud Console · GCP Secret Manager 閱讀 →
🎬
視頻剪輯 已完成
ffmpeg 視頻剪輯小白指南
截取、拼接、加背景音樂的完整操作。以受難日崇拜影片製作為實戰案例，含含內部刪減的複雜剪輯流程。
ffmpeg · 教會活動 · 影音處理 閱讀 →
🚀
環境設定 已完成
GitHub + Cloudflare Pages 自動部署
一次設定，以後 git push 自動更新網站；含 bat 一鍵腳本，從此告別手動上傳。
GitHub · Cloudflare Pages · gh CLI 閱讀 →
🔒
環境設定 已完成
Git 私人備份 Repo 小白指南
用 GitHub 私人倉庫當雲端保險箱，配合 .bat 腳本一鍵備份。附 .gitignore 踩坑教訓：node_modules 與 Token 文件的正確排除方式。
Git · GitHub · VS Code 閱讀 →
📈
Claude / MCP 已完成
Alpaca 量化交易 API 接入 Claude MCP
Windows 上踩了六個坑：uvx 找不到、連線超時、GBK 編碼炸、gcloud 路徑問題……最終用一個 .bat 文件全部解決。
Alpaca · MCP · GCP Secret Manager 閱讀 →
📊
Claude / MCP 已完成
用 Claude + Alpaca API 查期權數據：踩坑實錄
為什麼查個股價要批准十次？MCP 消失、六步拆單、404 端點、Put 貴 20 倍——四個坑踩完後的一條指令終極方案。
Alpaca v1beta1 · Options Snapshot · Python 閱讀 →
🗣️
Claude / MCP 已完成
用 Claude Code 白話文下單：期權策略從零到成交
小白如何跟 Claude 說話，讓它查數據、算破蝴蝶和 Jade Lizard 策略、自動掛 multi-leg 限價單，全程不寫一行代碼。
Alpaca Paper Trading · Claude Code · 白話文指令 閱讀 →
🔵 Google 服務
1 篇
🔑
Drive API OAuth
Google Drive API 小白指南
開啟 API、建立同意頁面、下載憑證、完成 OAuth 授權的完整流程。含 GCP Secret Manager 安全保管方案。
GCP · OAuth 2.0 · MCP 閱讀 →
📧
即將更新
Gmail API 接入 Claude MCP
讓 Claude 讀取、搜尋、起草 Gmail 郵件的完整設定流程。
Gmail API · MCP
📅
即將更新
Google Calendar API 設定
透過 MCP 讓 Claude 讀取和建立 Google Calendar 行程。
Calendar API · MCP
🟣 Claude / MCP
3 篇
📈
MCP 已完成
Alpaca 量化交易 API 接入 Claude MCP
六個 Windows 踩坑紀錄，含 uvx 問題、GBK 編碼、gcloud 路徑、Python os.execv 不穩定。最終用 .bat wrapper 完美解決。
Alpaca · MCP · GCP Secret Manager 閱讀 →
📊
期權數據 已完成
用 Claude + Alpaca API 查期權數據：踩坑實錄
MCP 新對話消失、六步拆單、v1beta1 正確端點、盤後 Put/Call 價差謎題。一條 Python 指令直接輸出 Bid/Ask/IV/Delta 完整表格。
Alpaca · Options Snapshot · Python 閱讀 →
🗣️
白話文下單 已完成
用 Claude Code 白話文下單：期權策略從零到成交
一句話查報價、一句話算破蝴蝶、一句話掛四條腿組合單。含完整對話流程圖和小白入門步驟，全程不寫代碼。
Alpaca Paper Trading · 白話文指令 · Multi-leg 閱讀 →
🔌
即將更新
什麼是 MCP？從零理解
MCP（Model Context Protocol）是什麼，為什麼 Claude 需要它，如何安裝和設定 MCP Server。
Claude Code · MCP
🗂️
即將更新
Claude Code settings.json 完全指南
bypassPermissions、mcpServers、additionalDirectories 等設定項目的意義和用法。
Claude Code
⏰
即將更新
設定 Claude 排程自動任務
用 Remote Trigger 讓 Claude 每天自動發送日曆摘要、Gmail 重點到你的信箱。
Claude Code · Cron
⚙️ 環境設定
2 篇
🔒
即將更新
GCP Secret Manager 統一管理密鑰
把所有 AI 模型的 API Key 和 credentials.json 集中存入 GCP Secret Manager，再也不怕洩漏。
GCP · gcloud CLI
🚀
自動部署 已完成
GitHub + Cloudflare Pages 自動部署
一次設定，以後 git push 自動更新網站；含 bat 一鍵腳本，從此告別手動上傳。
GitHub · Cloudflare Pages · gh CLI 閱讀 →
🔒
Git 備份 已完成
Git 私人備份 Repo 小白指南
用 GitHub 私人倉庫當雲端保險箱，配合 .bat 腳本一鍵備份。附 .gitignore 踩坑教訓：node_modules 與 Token 文件的正確排除方式。
Git · GitHub · VS Code 閱讀 →
🎬 視頻 / 媒體處理
1 篇
🎬
ffmpeg 教會活動
ffmpeg 視頻剪輯小白指南
截取、拼接、加背景音樂一次搞懂。含 Stream Copy vs 重新編碼的選擇指南，以受難日崇拜為實戰案例。
ffmpeg · ffprobe · 影音處理 閱讀 →
🎵
即將更新
用 Claude 自動化教會崇拜影片流程
把程序稿 PDF 轉成 ffmpeg 指令，一鍵完成所有片段剪輯。
Claude Code · ffmpeg
🔜 還在寫的指南
有什麼坑踩到了，就會加進來 ↓
· Notion API 接入 MCP
· Cloudflare Workers 部署 AI Agent
· ffmpeg 視頻剪輯自動化
· Windows + bash 路徑衝突排查
· GCP 各種 Permission Denied 錯誤排查
· 更多持續補充中…