Claude Code 導入服務
進場操作手冊

帳號策略（核心觀念，先讀）

前置 Step 1｜確認電腦環境可以順跑 Claude Code

1-A｜開啟終端機

所有指令都要在終端機（文字命令列）裡輸入，不是瀏覽器。

Mac 開終端機

• Command + Space 打開 Spotlight → 輸入「終端機」→ Enter
• 或：Finder → 應用程式 → 工具程式 → 終端機

Windows 開終端機

• 右鍵點「開始」→「Windows Terminal（系統管理員）」
• 或：搜尋「PowerShell」→ 右鍵「以系統管理員身分執行」

1-B｜確認作業系統版本與管理員權限

Mac — 確認系統版本

sw_vers   # 確認 macOS 12 以上

Mac — 確認管理員權限

方法一（終端機）：

groups

輸出清單裡有 admin = 有管理員權限；沒有 admin = 沒有管理員權限

方法二（介面操作）：左上角蘋果圖示 → 系統設定 → 使用者與群組 → 你的帳號下方顯示「管理者」= 有權限

curl --version

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

nvm --version

nvm install 22

node --version
npm --version

echo $SHELL

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.zshrc
source ~/.zshrc

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bash_profile
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bash_profile
source ~/.bash_profile

Windows — 確認系統版本

設定 → 系統 → 關於 → 確認 Windows 10 2004 以上 或 Windows 11

Windows — 確認管理員權限

搜尋「PowerShell」→ 右鍵「以系統管理員身分執行」→ 可以正常開啟 = 有管理員權限
若跳出「需要管理員密碼」或直接被拒絕 = 沒有管理員權限，需請 IT 協助

1-C｜確認網路可以連上 Anthropic

Mac（終端機）

curl -I https://api.anthropic.com

Windows（PowerShell）

curl.exe -I https://api.anthropic.com

1-D｜安裝 Claude Code

node --version   # 應回傳 v18 以上
npm install -g @anthropic-ai/claude-code
claude --version

node --version
npm install -g @anthropic-ai/claude-code
claude --version

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# 關掉終端機，重新開一個新的終端機視窗
nvm install 22
node --version
npm install -g @anthropic-ai/claude-code
claude --version

前置 Step 1 通過標準

• Claude Code 桌面 App 可正常開啟（主線）／或 claude --version 回傳版本號（備案）
• 網路可以連上 api.anthropic.com（curl 指令有回傳）

前置 Step 2｜製作 Skill Demo 並確認符合需求

1. 根據評估問卷，釐清 Skill 的輸入與輸出
2. 在你的電腦上（用你的 Max 帳號）製作 Demo 版 Skill
3. Demo 必須跑起來、給客戶看到完整流程，不能只是截圖
4. 安排線上或現場展示（30–60 分鐘）
5. 客戶確認「對，這就是我要的」→ 才進到 Step 3

Demo 製作時間：最多 5 個工作天（10 個工作天內完成展示）

Skill Demo 製作方式

1. 把客戶評估問卷的需求說給 Claude Code 聽
2. 請 Claude Code：「幫我為這個需求建立 Demo 版 SKILL.md」
3. Claude Code 會產出完整 SKILL.md，存放在你的測試資料夾

客戶驗收後，移植方式

步驟一（在你的電腦）： 告訴你的 Claude Code：「Skill [Skill名稱] 驗收 OK，幫我打包上傳 Google Drive」

步驟二（進場當天，在客戶電腦）：

1. 用瀏覽器開下載連結，把檔案下載到客戶電腦的 Downloads 資料夾
2. 在客戶電腦上啟動 Claude Code，輸入：「幫我安裝這個 Skill，檔案在 Downloads/[Skill名稱]」

前置 Step 3｜帳號建立 → 測試對話 → 升級 Pro

3-1｜用 AI 專屬 Google 帳號登入 Claude

1. 點「Sign in with Google」
2. 選剛才建立的 AI 專屬 Google 帳號（[公司名稱].aiagent@gmail.com）
3. 授權完成，進入 App 主畫面

3-2｜測試對話是否正常（免費帳號即可）

你好，現在幾點？請用繁體中文回覆我。

3-3｜確認 OK → 直接在 App 升級 Pro

1. 點 App 左下角的帳號名稱或設定圖示
2. 找到「Upgrade to Pro」或「升級方案」
3. 選 Pro 方案（$20/月 USD，約 NT$640）
4. 輸入信用卡資訊完成付款

3-4｜升級後補申其他帳號（視 Skill 需求）

Step 3 通過標準

• AI 專屬 Google 帳號建立完成
• 用該帳號登入 Claude Code 桌面 App 成功
• 測試對話有正常回應（繁體中文）
• Pro 方案升級完成（App 左下角顯示 Pro）

前置 Step 4｜環境最終確認

你好，現在幾點？請用繁體中文回覆我。

Pro 帳號的回應速度應明顯比剛才的免費測試快。

Step 4 通過標準

• Pro 帳號可以正常登入 Claude Code 桌面 App
• AI 回應速度正常（明顯比免費帳號快）
• 客戶知道帳號是哪個 Google 帳號、密碼由誰保管

前置 Step 5｜進場前環境升級安裝

5-A｜桌面 App 版環境確認 主線

• 桌面 App 可正常開啟並登入
• 可以輸入對話並收到回覆（繁體中文回應）
• 知道如何開啟新對話、切換 Project

https://github.com/Raymondhou0917/claude-code-resources/blob/master/starter-kit/01-terminal-setup.md
照這個設定，幫我安裝終端機設定。

https://github.com/Raymondhou0917/claude-code-resources/blob/master/starter-kit/02-external-editor.md
照這個設定，幫我安裝外部編輯器。

https://github.com/Raymondhou0917/claude-code-resources/blob/master/starter-kit/06-statusline.md
照這個設定，幫我安裝狀態列。

5-A.5｜建立 CLAUDE.md 與 AI 工作資料夾

幫我建立 AI 助理的工作資料夾與初始設定：
1. 在主目錄建立 ai-agent 資料夾，並建立子資料夾：skills/、memory/、output/
2. 在 ai-agent 資料夾裡建立 CLAUDE.md，填入以下基本資訊：
   - 使用者名稱：[姓名]
   - 公司 / 品牌名稱：[公司名]
   - 主要工作內容：[工作描述]
3. 在 CLAUDE.md 加入一條規則：「所有 AI 相關的檔案，統一放在 ai-agent 資料夾裡管理。」
完成後告訴我 CLAUDE.md 的完整路徑。

幫我把 AI助理的脈絡資料匯入另一個 AI助理。你的工作是瀏覽我們過去的對話，然後總結你對我的了解，包含個人，以及經營品牌上的(如果有的話)。

請勿在輸出內容中使用第一人稱代名詞（我、我的）和第二人稱代名詞（你、你的），而是改用「使用者」或中性用語，稱呼你從資料中瞭解的這個對象。

盡可能保留使用者說的每一字句，特別是指令與偏好設定。

類別（照以下順序输出）：
1. 使用者資訊：慣用名稱、職業、教育程度和居住地。
2. 興趣與偏好：持續積極參與的活動（不只是擁有某個物品或購買過一次的東西）。
3. 關係：已確認的長期關係。
4. 標註日期的事件、專案與計畫：近期重大活動的記錄。
5. 指令：明確要求之後遵守的規則，包括「哪些一定要做」、「哪些絕對不能做」，以及對之前行為的更正。僅納入個人化記憶中的規則，不含對話內容。

格式：
將內容依上述類別分段。盡量引用使用者在提示詞說過的原話，證明總結的各個項目。按照下列格式建立各個項目：

使用者的名字是。
- 證據：使用者說「叫我」。日期：[YYYY-MM-DD]。

將最終輸出摘要的格式設為文字區塊。

以下是從另一個 AI 助理匯出的使用者脈絡資料，請閱讀並記住這些內容，
把重要資訊整合進 CLAUDE.md，讓你更了解這位使用者：

[貼上剛才舊 AI 輸出的摘要內容]

5-A.6｜安裝 Obsidian（強烈推薦）

我已經安裝好 Obsidian，並把 ai-agent 資料夾設為 Vault。
請把這件事記錄到 CLAUDE.md，並說明：
- Obsidian Vault 路徑（就是 ai-agent 資料夾的完整路徑）
- 使用規則：AI 輸出的報告、記憶筆記，統一存成 .md 格式，讓我可以用 Obsidian 閱讀

5-B｜所有用戶都要裝（通用）

https://github.com/Raymondhou0917/claude-code-resources/blob/master/starter-kit/03-safe-delete.md
照這個設定，幫我安裝安全刪除。

https://github.com/Raymondhou0917/claude-code-resources/blob/master/starter-kit/04-mcp-essentials.md
照這個設定，幫我安裝 MCP 四件組。

https://github.com/Raymondhou0917/claude-code-resources/blob/master/starter-kit/05-deploy-online.md
照這個設定，幫我安裝線上部署工具。

5-C｜進階設定包（pro-kit）

我的 Downloads 資料夾裡有一個剛解壓縮的資料夾「pro-kit-bundle」，
裡面有 pro-kit-01.md 到 pro-kit-08.md 共 8 個檔案，
以及一個 skills/ 子資料夾（內含 social-cards/ 和 landing-page/ 完整 Skill 檔案）。

請幫我依序安裝，從 pro-kit-01.md 開始：
讀取該檔案的完整內容，按照裡面的指示執行安裝，
完成後告訴我結果與下一步，再繼續安裝下一個，
直到 pro-kit-08 全部完成為止。

特別說明：安裝 pro-kit-05（社群圖卡）和 pro-kit-06（Landing Page）時，
不需要從 GitHub 下載，skills/ 子資料夾裡已有完整的 social-cards/ 和 landing-page/ 資料夾，
直接從 pro-kit-bundle/skills/ 複製到 Skills 目錄即可（kit 的說明文件有詳細步驟）。

Step 5 通過標準

• 桌面 App 可正常使用（5-A 確認完成）
• starter-kit 03 安全刪除安裝完成
• starter-kit 04 MCP 四件組安裝完成
• starter-kit 05 線上部署工具安裝完成
• pro-kit-bundle.zip 下載連結確認可用（5-C，進場前確認即可）

我們已經完成所有工具的安裝。請把你目前對我的了解，以及剛才安裝的所有工具資訊，整理並更新寫入 CLAUDE.md，包含：
1. 使用者基本資訊（姓名、職業、工作內容）
2. 已安裝的工具清單（starter-kit 與 pro-kit 各項功能說明）
3. 工作資料夾的結構與路徑
4. 使用習慣與偏好（如果在過程中提過的話）
5. 需要注意的規則（如「所有檔案統一放在 ai-agent 資料夾」）

完成後讓我確認 CLAUDE.md 的最終內容。

進場準備清單（每次出發前確認）

你自己這邊

• 你的 Claude Code（Max 帳號）可以正常登入
• pro-kit-bundle.zip 下載連結可用，且點開可下載（5-C 的連結）
• 這份操作手冊帶在手邊（手機 / 平板可讀即可）
• 備用測試帳號（免費 Claude 帳號）記得帳密，供臨時環境驗證使用

客戶那邊（進場前已確認）

• 前置 Step 1–4 全部通過
• 接手夥伴當天確定到場
• 已告知「今天大約要 4–5 小時，中午可以安排休息」

進場當天的開場三句話

1. 「今天的目標是讓你（接手夥伴）學會自己用 AI，不是裝完就走。」
2. 「有任何看不懂的，直接問我，不要憋著。」
3. 「我們一起走過一遍，之後有問題你也知道怎麼找答案。」

進場第一天｜環境教學 + Skill 移植

當天時間規劃

第一段｜Claude Code 基本教學（0:30–2:00）

教學重點一：Claude Code 跟 ChatGPT 的根本差別

一句話：ChatGPT 是顧問（只出嘴），Claude Code 是助理（能動手）。

教學重點二：三種跟 AI 說話的方式

CLAUDE.md 是什麼？我應該怎麼用？

幫我在這個資料夾建立一個叫做 test.txt 的文件，
裡面寫「[公司名稱] 第一次測試，[今天日期]」

我們公司每週要整理一份客戶詢問的摘要，
現在都是人工做，你覺得 AI 可以幫到什麼？怎麼做？

教學重點三：五個讓協作順暢的習慣

1. 一次一件事：別把三個需求塞在同一句話
2. 具體優於模糊：「幫我改標題」→「把標題從 OOO 改成 XXX」
3. 做錯了直接說：「不是這個意思，我要的是 ___」
4. 遇到問題，截圖丟給 AI：任何看不懂的英文錯誤，截圖貼給 claude.ai 問
5. ESC 鍵是你的好朋友：AI 跑太久或跑錯方向，按 ESC 立刻中斷

教學重點四：遇到這些狀況怎麼辦

這段確認清單

• 會打開 Claude Code
• 成功讓 AI 建立一個測試檔案
• 知道遇到問題第一步是截圖問 claude.ai

第二段｜CLAUDE.md 設定 + AI 分身起始助手（2:00–3:00）

帶接手夥伴打開 CLAUDE.md 看一遍實際內容，確認 AI 有正確記錄公司資訊與工作習慣，再進行以下驗證：

確認 CLAUDE.md 有效

你好，請告訴我你剛才讀到了哪些關於我的資訊，
並且用一句話告訴我你目前的主要任務是什麼

這段確認清單

• 工作資料夾與記憶系統建立完成
• CLAUDE.md 建立並確認有效
• 接手夥伴能說出「CLAUDE.md 是什麼」（用自己的話）

第三段｜GitHub 備份設定（3:00–3:45）

幫我把這個 ai-agent 資料夾設定 GitHub 備份。
GitHub 帳號是 [GitHub用戶名]，
請建一個私有 repo 叫做 [公司名稱]-ai-agent，
完成所有設定，讓我之後可以用指令把修改備份上去。

教接手夥伴兩個習慣

習慣一：每次修改後備份

幫我把今天的修改備份到 GitHub，備份說明：[說明改了什麼]

習慣二：改壞了，叫 AI 救回來

幫我查看 GitHub 的備份紀錄，列出最近幾個版本，
然後幫我復原到 [上個版本 / 昨天的版本 / 某個特定日期]

這段確認清單

• GitHub repo 建立完成，可以在 github.com 上看到檔案
• 接手夥伴知道「改完就備份」這個習慣
• 接手夥伴知道改壞了要輸入什麼叫 AI 救回來

第四段｜Skill 移植與測試（3:45–5:00）

https://drive.google.com/file/d/1d1lgqOadjvKllX7RVYkJ-SCZG-5VfRKP/view?usp=sharing

我的 Downloads 資料夾裡有一個 weekly-summary-SKILL.md 檔案。
幫我把這個 Skill 安裝到正確位置，讓我可以用 /weekly-summary 指令呼叫它。

/weekly-summary

我的 Downloads 資料夾裡有一個 [Skill名稱] 資料夾，裡面有 SKILL.md。
幫我把這個 Skill 安裝到正確位置，讓我可以用 /[skill-name] 指令呼叫它。

/[skill-name]

mkdir -p ~/ai-agent/skills/[skill-name]
mkdir -p ~/.claude
ln -sf ~/ai-agent/skills ~/.claude/skills

mklink /J "%USERPROFILE%\.claude\skills" "%USERPROFILE%\ai-agent\skills"

安裝完成後，帶接手夥伴親自走一遍完整 Skill 流程，確認輸出結果符合當初 Demo 的預期，並討論「之後如果要調整，從哪裡改」。

這段確認清單

• Skill 可以用 /指令 觸發並走完完整流程
• 接手夥伴知道 SKILL.md 在哪裡
• 接手夥伴親自操作過一次完整流程
• 知道如果 Skill 跑不動，第一步找誰

進場第二、三週｜Skill 精調與夥伴培訓

第二週進場重點

幫我修改 CLAUDE.md，加入以下這條規則：
「每次執行 /[skill-name] 之前，先確認 [特定條件]」

本週確認清單

• 接手夥伴獨立使用 Skill 超過 3 次（無需你在旁）
• CLAUDE.md 至少完成一次更新
• Skill 完成至少一次迭代調整

第三週進場重點

你坐在旁邊，完全不說話，讓接手夥伴：① 獨立觸發 Skill → ② 自己解決問題 → ③ 走完流程。你觀察，最後只針對「他沒有解決到的問題」給建議。

本週確認清單

• 接手夥伴能獨立操作全程（包含出錯時自行處理）
• Skill 功能穩定，無重大缺陷
• GitHub 備份完成

進場第四週｜交接確認

交接前確認清單

• Claude Code 可以正常啟動
• Anthropic 帳號登入無問題，接手夥伴知道帳號在哪裡取得
• CLAUDE.md 內容完整且 AI 能正確讀取
• Skill 可以獨立觸發並跑完
• 客戶版說明書已交給接手夥伴
• 接手夥伴知道 SKILL.md 在哪裡、如何看懂基本結構
• GitHub repo 備份完成，接手夥伴知道如何查看

正式交接儀式

1. 打開電腦，啟動 Claude Code
2. 輸入：「你好，告訴我你現在的任務是什麼」
3. 確認 AI 正確讀到 CLAUDE.md
4. 觸發 /[skill-name]，走完完整流程
5. 完成後截圖給你確認

保固期（交接後一個月）

保固範圍

• 你建置的 Skill 在未遭修改的情況下功能異常

不含在保固內

• 接手夥伴自行修改後出問題
• Anthropic 平台本身的服務異常
• 換電腦或重裝系統後需要重新設定
• 新增新功能或建置新 Skill

服務形式

• 線上支援：每月最多 2 小時（LINE 文字或視訊）
• 到場支援：非保固範圍，需另行報價

快速除錯備查

# 基本環境確認
node --version                           # Node.js 版本（需 v18+）
npm --version
claude --version                         # Claude Code 版本

# 更新 Claude Code
npm update -g @anthropic-ai/claude-code

# 確認 Skills 連結是否正常
ls -la ~/.claude/skills

# 網路連線測試（Mac）
curl -I https://api.anthropic.com

# 網路連線測試（Windows）
curl.exe -I https://api.anthropic.com

# 重新登入
/login