Skip to content
ChatGPT3a01Public

About

🦞 Claw v3 — Claude Code 一鍵安裝器,整合 OpenAI Codex + Google Gemini plugin,三家 AI 在同一 session 委派協作(真 cache、不冷啟動、token 省 90%)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🦞 Claw Hub v4.0

Claude × Codex × OpenCode × Antigravity · AI 工具中控台

一鍵安裝,打 claw 就出現中控選單:按一個數字鍵,各家 AI 就在 Windows Terminal 同視窗開新分頁。 進入 Claude Code 後,仍可用 /codex:*、/gemini:* 把任務委派給副手 AI(真 session、prompt cache 命中、不冷啟動)。

📘 本專案對應《Claude Code 聖經:從入門到實戰全攻略》CH18|Claw 統一指揮中心。


🎯 解決什麼問題?

如果你曾經被「同時用多家 AI CLI」搞煩過:

  • 切視窗切到頭暈,對話歷史散落四處
  • 每問一次副手 AI 就冷啟動一次
  • 想讓 Codex 審查程式碼,得手動複製貼上、再把結論搬回來
  • Windows 終端機打中文常出問題(IME 候選字被吃、游標亂跳)

Claw Hub v4.0 用兩層設計解決:

層 做什麼 怎麼用
Hub 中控選單 管「開哪家」:一鍵開各家 AI 分頁+系統工具 打 claw,按數字鍵
in-session 委派(v3 核心) 管「叫誰做」:人留在 Claude 主 session,副手被叫進來幫忙 /codex:review,或直接說「請 Codex 審查我的程式碼」

🚀 一鍵安裝

前置條件

項目 說明 必要性
Windows + PowerShell 安裝腳本為 Windows 設計(PowerShell 5.1 或 7 皆可) 必要
Node.js 18+ https://nodejs.org(沒裝的話安裝程式會提示並結束) 必要
Windows Terminal(wt) Microsoft Store 安裝;選單開分頁靠它 建議
Antigravity CLI(agy) 依官方流程手動安裝 選裝(選單 [4])

claude、codex、opencode 三家 CLI 沒裝會自動用 npm install -g 補上,不用自己記指令。

安裝 Claw

方法 A ─ 從 GitHub 下載 install.ps1 直接跑(推薦)

iwr https://raw.githubusercontent.com/ChatGPT3a01/Claw/main/install.ps1 -OutFile install.ps1
.\install.ps1

方法 B ─ Git clone

git clone https://github.com/ChatGPT3a01/Claw.git
cd Claw
.\install.ps1

install.ps1 是自包含的單一檔案,會依序完成 6 個步驟:

  1. ✅ 檢查並自動補裝前置 CLI — Node.js 必須先有;claude / codex / opencode 缺哪個自動補裝;agy 提示手動安裝
  2. ✅ 部署 claw 命令到 ~/.claude/claw/(含 claw.ps1 中控選單、zh-input.ps1 中文小窗、uninstall.ps1 等),並設定 Win+M 全域熱鍵叫出中文語音/潤稿小窗
  3. ✅ 安裝兩個 Claude Code plugin — codex@openai-codex(OpenAI 官方)與 gemini@abiswas97-gemini(社群版)
  4. ✅ 設定 User PATH、PowerShell alias(mcp-on / mcp-off / mcp-ls)與自動模式
  5. ✅ 互動式認證 Claude / Codex / Gemini(已認證會自動略過)
  6. ✅ 顯示完成提示與下一步

安裝參數:

.\install.ps1 -SkipPlugins        # 不自動裝 plugin(除錯用)
.\install.ps1 -SkipAuth           # 略過互動式認證
.\install.ps1 -Force              # 強制覆蓋既有檔
.\install.ps1 -InstallDir <路徑>  # 自訂安裝位置(預設 ~/.claude/claw)

重複執行 install.ps1 是安全的,已裝好的部分會略過。

首次認證(Step 5 會引導)

Claude 三選一:

  • [1] 貼 ANTHROPIC_API_KEY(按量付費,console.anthropic.com 取得)
  • [2] Claude Pro / Team 訂閱(啟動 claude 時引導 OAuth 登入)
  • [3] 已在別處登入過(略過)

Codex / Gemini:進入 Claude Code 後可再執行:

/codex:setup
/gemini:setup

⚠️ Gemini 個人版 OAuth 已於 2026-06-18 停服:/gemini:* 請改設 GOOGLE_API_KEY(從 AI Studio 取得),或改用選單 [4] 的 Antigravity。企業版不受影響。


📖 用法

啟動中控選單

關閉並重開 PowerShell(讓 PATH 生效),任何位置輸入:

claw
按鍵 功能 說明
[1] 🦞 Claude 主力 AI,新分頁開 Claude Code(自動免授權)
[2] 🤖 Codex 程式審查、修 bug、OpenAI 視角
[3] 🧩 OpenCode 免費 AI CLI(小米 MiMo / DeepSeek / Groq / 本機 Ollama)
[4] 🚀 Antigravity Antigravity CLI(agy)
[5] 🐍 Python Pen CodePen 風 Python 互動頁
[0] ✍️ 中文小窗 把中文貼到任何視窗或軟體
[6] 🔌 MCP 管理 啟用 / 關閉 MCP 伺服器
[7] 📂 專案快切 儲存常用目錄,一鍵切換
[8] 🏥 環境健診 工具版本+API Key 是否設定
[9] 📝 快速筆記 帶時間戳記的輕量記事本
[P] 🐍 Python 選單 執行 .py、REPL、畫圖、pip install
[H] 📋 使用說明 各家 CLI 指令速查
[A] 👤 關於作者 阿亮老師資訊
[Q] 🚪 離開 結束 CLAW

按鍵即發、不用 Enter。選單會持續演進,實際按鍵以安裝後的畫面為準。

其他旗標:

claw --cheat         # 印出完整指令速查
claw --env           # 環境健診(同 --check / --doctor)
claw --about         # 作者資訊
claw --setup-help    # plugin 手動安裝指引

🌟 最簡單用法(0 學習成本)

按 [1] 進入 Claude Code 後,直接用中文跟它說想做什麼:

你:請 Codex 審查我剛寫的程式碼
你:讓 Gemini 用 1M context 看整個專案
你:派 Codex 修這個 bug

→ Claude 聽得懂、會自動派工,完全不用記指令。

進階:在 Claude 對話內可用的指令

指令 說明
/codex:review Codex 程式碼審查
/codex:adversarial-review Codex 對抗式挑戰設計決策
/codex:rescue <task> 委派任務給 Codex(修 bug、追問題)
/codex:status /codex:result /codex:cancel 管理 Codex 背景任務
/gemini:review Gemini 程式碼審查(1M context)
/gemini:adversarial-review Gemini 對抗式挑戰
/gemini:rescue <task> 委派任務給 Gemini
/gemini:status /gemini:result /gemini:cancel 管理 Gemini 背景任務

支援 --background、--base <ref>、--model <name> 等 flag。完整文件:

✍️ 中文輸入小窗(語音+潤稿)

  • Win+M 全域熱鍵,或選單 [0] 叫出小窗
  • Enter 只貼進終端機、不執行;Ctrl+Enter 貼上並送出;Shift+Enter 小窗內換行
  • ✨ 潤稿:優先走 Groq(約 0.4 秒),失敗自動退回 Gemini
  • 金鑰只從環境變數(如 GROQ_API_KEY)或本機 ~/.claude/claw/groq.key 讀取,不會寫進任何會上傳的檔案

安裝程式會停用系統原本的 Win+M(最小化全部視窗),改由 CLAW 接手;原功能請改用 Win+D。

🤖 自動模式(預設啟用)

從選單開出來的 AI 分頁都走自動模式,減少詢問、自主處理:

AI 自動設定
Claude --dangerously-skip-permissions(跳過權限詢問)
Codex ~/.codex/config.toml:approval_policy="on-request"、sandbox_mode="workspace-write"
Gemini ~/.gemini/settings.json:approvalMode 自動值

⚠️ 全自動代表 AI 改檔案、跑指令都不會再問你。第一次使用請先在不含重要資料的資料夾練習。

MCP 按需切換

mcp-ls                        # 看目前啟用的 MCP
mcp-on twstockmcpserver       # 載入某個 MCP
mcp-off twstockmcpserver      # 卸下
mcp-off all                   # 一次卸下全部

把 MCP server 設定 JSON 存成 <名稱>.json 放進 ~/.claude/mcp-presets/ 即可。選單 [6] 是同一件事的選單版。切換後需重啟 Claude Code 才生效。


🛠 常見問題

問題 解法
.\install.ps1 出現紅字 execution policy Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 後重跑;或 powershell -ExecutionPolicy Bypass -File .\install.ps1
'claw' 不是內部命令 關掉所有終端機再重開(PATH 只在啟動時載入)
按數字鍵沒開出新分頁 確認已裝 Windows Terminal;再按 [8] 環境健診看哪家 CLI 標了 ✖
/codex:setup、/gemini:setup 找不到 claw --setup-help 看手動安裝指引,或重跑 .\install.ps1
/gemini:* 認證錯誤 個人版 OAuth 已停服,改設 GOOGLE_API_KEY,或改用 [4] Antigravity
安裝時顯示「找不到 SecureTalk」 離線即時聽寫元件為選配,不影響其他功能,可改用雲端轉稿

🔧 解除安裝

& "$env:USERPROFILE\.claude\claw\uninstall.ps1"

可選 flag:

  • -KeepPlugins:保留 Codex / Gemini plugin
  • -KeepProfile:保留 PowerShell profile 設定

🏗️ 架構

你輸入 claw
     ↓
Claw Hub v4.0 互動選單(PowerShell)
     ├─ [1]~[4] → Windows Terminal 新分頁開 Claude / Codex / OpenCode / Antigravity
     ├─ [5]~[9]、[0]、[P] → 系統工具(Python Pen、MCP、專案快切、健診、筆記、中文小窗)
     ↓ 按 [1]
進入 Claude Code 主 session(cache 命中、有對話記憶)
     ├─ /codex:*   → 透過 codex-plugin-cc 委派 OpenAI Codex
     │              (Codex app server 常駐,不冷啟動)
     └─ /gemini:*  → 透過 gemini-plugin-cc 委派 Google Gemini
                    (ACP 持續會話,不冷啟動)

版本演進:

  • v2:包在各家 CLI 外面的 Python wrapper,每次發訊重啟子進程 → prompt cache 失效、context 每次重送
  • v3:改成 Claude Code plugin 模型,主 session 不動、子任務透過 plugin 委派
  • v4.0 Hub:在 v3 委派核心外加上中控選單、四家 AI 一鍵開分頁、中文語音/潤稿小窗與系統工具

👨‍🏫 關於作者

曾慶良 主任(阿亮老師)

📌 現任職務

🎓 新興科技推廣中心主任
🎓 教育部學科中心研究教師
🎓 臺北市資訊教育輔導員

🏆 獲獎紀錄

🥇 2025 SETEAM 教學專業講師認證
🥇 2024 教育部人工智慧講師認證
🥇 2022、2023 指導學生 XR 專題競賽特優
🥇 2022 VR 教材開發教師組特優
🥇 2019 百大資訊人才獎
🥇 2018、2019 親子天下創新 100 教師
🥇 2018 臺北市特殊優良教師
🥇 2017 教育部行動學習優等

📞 聯絡方式

YouTube Facebook Email


📜 授權聲明

© 2026 阿亮老師 版權所有

本專案僅供「阿亮老師課程學員」學習使用。

⚠️ 禁止事項

  • ❌ 禁止修改本專案內容
  • ❌ 禁止轉傳或散布
  • ❌ 禁止商業使用
  • ❌ 禁止未經授權之任何形式使用

如有任何授權需求,請聯繫作者。


🌟 喜歡這個專案嗎?

如果這個工具對你有幫助,請給我們一個 ⭐ Star!


Made with ❤️ by 阿亮老師


⬆️ 回到頂部


© 2026 阿亮老師 版權所有

About

🦞 Claw v3 — Claude Code 一鍵安裝器,整合 OpenAI Codex + Google Gemini plugin,三家 AI 在同一 session 委派協作(真 cache、不冷啟動、token 省 90%)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages