DOCUMENTATION / Claude / Claude Code手順と注意事項Steps & guidance安裝步驟與注意事項
在 Claude 中安裝 KUMIHAN
這份指南說明如何在 Claude Code 與 Claude 應用程式中使用 KUMIHAN。
關於 v0.2.0 此版本供你在自己的環境中試用。各工具的實際運作尚未經過充分驗證,因此部分步驟可能無法如預期使用。
1. 選擇安裝方式
| 使用環境 | 建議方式 |
|---|---|
| Claude Code | A. 從 GitHub 安裝(方便後續更新) |
| Claude Code(想使用 ZIP 檔案時) | B. 從 ZIP 安裝 |
| Claude(claude.ai 網頁版或應用程式) | C. 上傳技能 |
Claude Code 和 Claude 應用程式的安裝方式不同。
A. Claude Code:從 GitHub 安裝
-
在終端機註冊 KUMIHAN 的套件來源。
claude plugin marketplace add "https://github.com/landco-llc/kumihan.git#main" -
在 Claude Code 對話中輸入:
/plugin install kumihan@kumihan-marketplace -
確認內容並選擇適用範圍(只供自己使用、只限目前專案等)後安裝。
安裝完成後,可使用下列指令:
/kumihan:kumihan/kumihan:kumihan-web/kumihan:kumihan-documents/kumihan:kumihan-review
更新方式請參閱更新指南。
B. Claude Code:從 ZIP 安裝
- 下載 Claude Code 外掛 ZIP。
- 解壓縮後會得到
kumihan資料夾。 -
指定該資料夾並啟動 Claude Code。
claude --plugin-dir "/absolute/path/kumihan"
注意事項
- 請保留資料夾內的完整內容,不要刪除檔案或混入其他檔案。
- 這種方式不會自動更新。新版本推出後,需自行替換 ZIP。
C. Claude 應用程式:上傳技能
適用於 claude.ai 或 Claude 應用程式。
- 下載想使用的技能 ZIP。
- kumihan — 開始使用前的規劃入口
- kumihan-web — 網頁製作
- kumihan-documents — 報告與簡報
- kumihan-review — 成果檢視
- 在 Claude 開啟 Customize → Skills,使用新增按鈕選擇 Upload a skill。
- 逐一上傳 ZIP 並啟用技能。
注意事項
- 此處不能使用 Claude Code 專用的外掛 ZIP,請上傳個別技能 ZIP。
- 上傳前不要變更 ZIP 檔名。
- 使用技能前必須在設定中啟用「程式碼執行」。請參閱 Claude 官方說明。
- 組織帳號可能受到管理員設定限制。
- 上傳的技能不會自動更新。新版本推出時需重新上傳。
2. 開始試用
建議先以不會修改檔案的要求測試:
我準備製作一個日文網頁。請告訴我需要注意哪些排版與設計要點,不要修改任何檔案。
驗證下載檔案(選用)
若要檢查下載檔案是否完整,可使用 SHA256SUMS.txt。
將檔案放在與下載目錄相同的結構(plugins/ 和 skills/),並在終端機執行以下命令。若無 shasum,可使用 Windows PowerShell 的 Get-FileHash 等工具檢查 SHA-256:
cd "downloads Claude"
shasum -a 256 -c SHA256SUMS.txt
若每一行都顯示 OK,即表示校驗成功。
其他工具:ChatGPT/Codex ・ Gemini
介面及功能開放條件可能變更;請以各服務的官方說明為準(原始指南確認日期:2026 年 10 月 14 日)。
