我們會仔細閱讀每一則回饋，並非常重視您的意見。
欲查看所有可用的限定條件，請參閱我們的文件。
這是一款以 AI 為核心的旅遊攻略工具，結合點數、里程與獎勵機票搜尋功能。提供適用於 OpenCode、Claude Code 與 Codex 的即插即用技能與 MCP 伺服器。
您可以請 AI 幫您尋找一張 60,000 里程的東京商務艙機票。它會跨 27 種里程計劃搜尋獎勵機票可用性，並與現金價格比較，檢查您的忠誠度餘額，告訴您最佳方案。
使用此工具包最簡單的方式是選擇您的工具：
安裝完成後，42 個技能、6 個 MCP 伺服器（其中 5 個免費，另有需金鑰的 LiteAPI）及旅遊攻略子代理會被安裝。您可從任何地方執行 Claude，並請它幫您規劃行程。
要驗證安裝，請在 Claude Code 中執行 /travel-hacker:getting-started。它會告訴您哪些 API 金鑰已設定，並指向本地設定腳本以補齊缺少的金鑰。或在終端機輸入 claude plugin list | grep travel-hacker，應會顯示該插件。
接著啟動 Codex，插件會出現在 /plugins。Codex 從倉庫拉取市場目錄（.agents/plugins/marketplace.json）與插件清單（plugins/travel-hacking-toolkit/.codex-plugin/plugin.json），因此安裝只需一條指令。
Cowork 本身不支援 /plugin 指令，因此無法在 Cowork 聊天中安裝插件。請先透過 Claude Code 安裝；Cowork 會自動偵測，因為兩者共用 ~/.claude/plugins/。
Claude Desktop 的聊天介面尚未支援插件格式，請在同一應用中使用 Cowork 以獲得完整體驗。
五個免費 MCP 伺服器（Skiplagged、Kiwi、Trivago、Ferryhopper、Airbnb）可立即使用，無需金鑰。現金機票與飯店搜尋開箱即用。
要解鎖獎勵搜尋及工具包其他功能，需在終端機環境變數中設定 API 金鑰。請執行本地設定腳本：
該腳本會以遮蔽輸入提示您輸入每個金鑰，並驗證（拒絕含單引號的值以避免匯出錯誤，並進行最小長度檢查），將金鑰寫入對應的 shell 配置檔並備份，且不會回顯金鑰。匯出時使用單引號包覆，確保其他 shell 特殊字元安全。金鑰不會出現在終端機歷史或任何聊天中。Claude Code 內的 /travel-hacker:getting-started 技能會指向同一腳本。
其他金鑰（SerpAPI、RapidAPI、LiteAPI、TripAdvisor、RESROBOT、Rejseplanen、Entur）擴充特定技能，設定技能也涵蓋這些。完整 API 金鑰參考與註冊連結請見下方。
五個基於 Docker 的技能（Southwest、American Airlines、Chase、Amex、TicketsAtWork）處理無公開 API 的網站，並有共用基底映像。首次使用時會自動拉取。詳細憑證與設定請參考 Docker 映像說明。
請將以下加入您的 shell 配置檔（~/.zshrc、~/.bashrc 等）：
重新載入（source ~/.zshrc）或開啟新終端機，然後執行 claude。
若您將密鑰保存在 1Password，可在啟動時解析：
需使用 --no-masking 參數，因 op run 預設輸出遮蔽會干擾 Claude Code 的 TTY 偵測並觸發非互動式提示錯誤。遮蔽只影響標準輸出，不影響環境變數本身，因此金鑰仍能正確傳遞給 claude。
（詳見 1Password CLI 文件的 .env 範本語法。）
工具包從 shell 環境讀取金鑰，因為插件的 userConfig 不會傳遞給呼叫外部腳本的技能（經驗驗證；相關上游問題 anthropics/claude-code#11927、#39125）。
OpenCode 無插件格式，OpenCode 用戶需自行克隆倉庫。想參與開發者也需克隆。
設定腳本會選擇您的工具（OpenCode、Claude Code、Codex 或三者皆選），建立 API 金鑰配置檔，安裝依賴，並可選擇系統範圍安裝技能給 OpenCode 與 Claude Code。
Windows 下 .cmd 包裝器會以 ExecutionPolicy bypass 啟動 scripts\setup.ps1，無需先解除封鎖。
接著從倉庫內啟動您的工具：
claude --plugin-dir . 會直接從您的克隆目錄載入插件（技能、MCP 伺服器與旅遊攻略子代理）。您對工具包的修改會立即生效，適合貢獻者使用。
從這裡開始：編排技能會自動呼叫其他所有技能。
下方技能表由 scripts/gen-skill-tables.sh 自動從 skills/*/SKILL.md 的前置資料產生。請編輯原始前置資料，勿手動修改表格。註冊連結與 API 金鑰網址見下方 API Keys & Signup Links 區段。
另可使用 tripadvisor（目的地分類下）查詢飯店評分、排名、子評分與評論。
這些技能包含過去 CLAUDE.md 中的深厚機構知識。當代理遇到相關觸發條件時會自動載入，保持主配置簡潔。
這些技能需要外部帳號或 API 金鑰註冊。完整環境變數列表見 .env.example（部分技能需設定環境變數但無實際註冊，例如 scandinavia-transit 需自訂 ENTUR_CLIENT_NAME 作為 Entur 必要的識別標頭）。
五個技能以 Docker 容器運行（透過 Patchright 瀏覽器自動化），並共用 patchright-docker 基底映像。六個映像皆公開於 GitHub Container Registry，無需認證即可拉取。setup.sh（Windows 為 setup.ps1）會根據您選擇的工具自動拉取所需映像。
若想本地建置映像而非從 ghcr.io 拉取：
各技能目錄中的 Dockerfile 詳細說明映像內容。五個技能映像皆以 ghcr.io/borski/patchright-docker 為基底。
技能為 Markdown 檔案，賦予 AI 專門的旅遊攻略能力。分為兩種形式：
OpenCode、Claude Code 與 Codex 均可載入。技能採用漸進式揭露：每個技能的名稱與簡短描述在會話開始時載入上下文，代理僅在決定使用該技能時才讀取完整 SKILL.md，保持常駐上下文精簡，讓工具包能擴充而不膨脹代理提示。
skills/ 目錄為權威來源。設定腳本會：
MCP（模型上下文協議）伺服器提供 AI 可直接呼叫的即時工具。配置位於：
Skiplagged、Kiwi.com、Trivago、Ferryhopper 與 Airbnb 無需任何設定。LiteAPI 也是遠端伺服器，但需在設定中配置 API 金鑰。
為何 Codex 需要插件：OpenCode 與 Claude Code 會自動從倉庫本地配置檔發現 MCP 伺服器，Codex 則不會。Codex 只會從 ~/.codex/config.toml 或已安裝插件載入 MCP 伺服器。工具包提供 Codex 插件（位於 plugins/travel-hacking-toolkit/），將 MCP 配置打包，讓 Codex 用戶享有與其他兩款工具相同的即用體驗。選擇 Codex 選項時，setup.sh 會自動設定。
編排技能（trip-planner、compare-flights、compare-hotels）會自動呼叫各個來源技能。除非需要特定來源，否則建議從這些開始。
參考技能（flight-search-strategy、points-valuations、partner-awards、alliances、award-sweet-spots、cabin-codes、hotel-chains、fallback-and-resilience、booking-guidance、lessons-learned）會在相關上下文自動載入，提供深度機構知識，無需您明確呼叫。
核心問題：「我該用點數換還是付現金？」
歡迎提交 PR。README 與 llms.txt 中的技能表由各技能 SKILL.md 前置資料自動產生，請勿手動編輯。
詳見 CONTRIBUTING.md，內容涵蓋技能新增流程、前置資料規則、煙霧測試細節、硬性規則清單與風格指南。
工具包依賴的其他開源專案、MCP 伺服器與 API 均於技能表中內嵌連結。
這是一款 AI 驅動的旅遊攻略與搜尋工具，整合現金、點數、里程與獎勵機票，提供 Claude、Codex 與 OpenCode 的即插即用技能與 MCP 伺服器。