- AI 應用培訓實作前,依序完成 Claude 桌面版・Cowork(協作)・Git 的安裝與測試的指引 — 內含常見錯誤的解決方法與最終檢查清單。
培訓前只需做一次 · 照著做就完成
AI 應用培訓 — 行前準備指南
Claude 桌面版・Cowork(協作)實作
- 安裝 → 測試 → 自行排除問題
- 約需 40 分鐘
- 以 Windows 為準
本指南協助您在培訓當天之前自行完成安裝與測試,避免當天實作延誤。請依序操作,若遇到問題,請到疑難排解中找出相同的症狀。
- 公司或個人筆電(Windows 10 以上,具管理員權限)
- Claude 付費帳號(建議 Pro 以上)
- 穩定的網路連線
- Git(於 STEP 3 安裝)
即使沒有 Git,前半段的實作也能順利進行。因此若沒安裝就來參加,往往不會發現,直到實作最後階段(還原作業・版本管理・部署)才突然卡住。到時才現場安裝,還會碰上公司電腦權限問題,大幅拖延時間。請務必在培訓前完成 STEP 3。
先花 30 秒 — 您的電腦適用哪一種方式?
Windows Pro・Enterprise・Education 版本,且可自行安裝程式的筆記型電腦
請依序完成 STEP 1 → 2 → 3 → 4
從 STEP 1 開始 →即使是 Home 版,或虛擬化被封鎖的公司電腦也沒問題 — 只要將協作作業改在「雲端」執行即可(請參考疑難排解 A-1)。
完成 STEP 1(安裝)後,在新作業中只要選擇「雲端」即可 — 不需要安裝 Git
查看雲端執行方式 →💻 安裝 Claude 桌面版
下載與安裝
- 用瀏覽器前往 claude.com/download ↗ → 下載 Windows 版本⬇ 下載 Claude 桌面版 ↗
- 執行下載的安裝檔 → 完成安裝
- 從開始功能表開啟 Claude → 登入您的帳號
Cowork(協作)事前需求 — 僅在 Cowork 無法使用時確認
| 項目 | 需求 | 確認方式 |
|---|---|---|
| 作業系統 | Windows 10 以上(使用 Cowork 建議 Windows 11 Pro) | 設定 → 系統 → 關於 |
| 版本 | Pro / Enterprise / Education(Home 版無法在本機執行 Cowork) | 設定 → 系統 → 關於 |
| 虛擬化 | BIOS 啟用虛擬化 + 虛擬機器平台 | 工作管理員 → 效能 → CPU → 「虛擬化:已啟用」 |
| 帳號 | Claude 付費方案 | 登入 claude.ai ↗ 後,在設定中確認 |
即使是 Home 版本,或公司電腦封鎖了虛擬化功能也沒問題 — 將協作作業改在「雲端」執行即可(請參閱疑難排解 A-1)。
- 安裝 Claude 桌面版並登入 — 可啟動應用程式並開始對話
🤝 Cowork(協作)測試
- 開啟 Claude 桌面版 → 點選輸入框下方的 [Cowork(協作)] 分頁
- 若要求連接工作資料夾,請在桌面建立新資料夾「AI 實作」並連接
- 在輸入框中輸入以下內容
在這個資料夾中建立 hello.txt 檔案,並寫入「測試成功」
- 資料夾中產生 hello.txt 且內容正確,即通過測試
若 [Cowork(協作)] 按鈕無法點選,或出現錯誤提示 → 前往疑難排解 A
- 準備實作資料夾 — 桌面「AI 實作」資料夾
- Cowork(協作)測試 — 成功建立 hello.txt
🔧 安裝 Git ★ 開始程式作業前務必完成
★ 最常被漏掉Claude 產生的程式碼會在 Git 上管理歷史紀錄。將作業還原到先前狀態、比較變更內容、分開進行多項作業 — 這些功能全都用到 Git。沒有 Git 的話,前半段不會有問題,但在還原與版本管理的步驟就會出錯,進度也會從那裡卡住。
安裝(約 5 分鐘)
- 用瀏覽器開啟 git-scm.com/download/win ↗ → 下載 64-bit Git for Windows Setup⬇ 下載 Git for Windows ↗
- 執行安裝檔 → 所有選項保持預設值,一路點選 [Next](請勿自行變更)
- 安裝完成後,關閉所有已開啟的命令視窗與 Claude 桌面版 — 若未關閉,即使已安裝也無法被辨識
確認安裝
- 按 Win + R → 輸入 cmd → 按下確定
- 輸入以下內容後按 Enter
git --version
👉 git version 2.xx.x — 若顯示 git version 2.xx.x 這樣的版本,即表示安裝完成
首次使用者設定
若未事先設定姓名與電子郵件,儲存(commit)步驟就會出錯。請將下方兩行改成您自己的資料後輸入。
git config --global user.name "Hong Gildong" git config --global user.email "hong@company.com"
不一定要使用公司信箱。此資訊不會對外公開,僅作為記錄標示。
- 安裝 Git ★ — git --version 顯示版本
- 註冊 Git 使用者 ★ — 已完成姓名・電子郵件 config 設定
🧪 程式開發任務測試
請依下列順序,確認 Cowork(協作)分頁是否能進行程式撰寫作業。(請在完成 STEP 3 Git 安裝後再進行。)
- Claude 桌面版 → [Cowork(協作)] 分頁 → 在已連結「AI 實作」資料夾的狀態下開始新任務
- 在輸入框中輸入以下內容
請在這個資料夾建立一個輸出九九乘法表的網頁(gugudan.html)
- 雙擊資料夾中產生的 gugudan.html → 瀏覽器顯示九九乘法表即通過
- 接著輸入→ 若順利處理、沒有出現錯誤,代表 Git 連動也正常
請復原剛才的操作
- 程式開發任務測試 — 以瀏覽器執行 gugudan.html
- 復原測試 ★ — 下達「請復原」指令後,能順利處理且沒有錯誤
🎉 只要 STEP 2(hello.txt)・STEP 3(Git)・STEP 4(gugudan.html+還原作業)全部成功,培訓當天所有實作的準備就完成了。
🩺 自行疑難排解
請點選與畫面上錯誤訊息相同的那一列展開。
A. Cowork(協作)問題
A-1. 「Missing HCS services: HNS, vmcompute, vfpext」錯誤(最常見)
Windows 虛擬化服務處於關閉狀態。請依序處理。
- 30 秒診斷:確認版本(若為 Home 版請直接跳到第 4 項)+工作管理員中「虛擬化:已啟用」
- Win + R → optionalfeatures → 勾選 Hyper-V・虛擬機器平台・Windows Hypervisor 平台・容器 共 4 項 → 務必選擇「重新啟動」— 關機後再開機的方式無效
- 在 PowerShell(以系統管理員身分)執行以下指令後重新啟動
wsl --shutdown wsl --update net start vmcompute net start hns Get-Service vmcompute, hns # 兩個服務皆為 Running 即為正常
- 若以上方法都無法解決 → 改在「雲端」執行協作任務:開始新任務時,從畫面右上角的執行位置選項(「Run this task」)選擇「雲端」。任務會在雲端伺服器而非您的電腦上執行,因此與虛擬化功能無關,可立即運作。若覺得每次選擇很麻煩,可到設定 → Cowork → 開啟「在雲端執行新任務」。
A-2. 完全看不到 Cowork(協作)分頁
- 將 Claude 桌面版更新至最新版本 → 完全關閉後重新開啟
- 若仍無法解決,請移除後到 claude.com/download ↗ 重新安裝
A-3. 設定畫面一直載入中(轉圈圈)
- 暫時關閉 VPN・防毒軟體後重試;若在公司網路,請改用個人手機熱點測試
- 若正在使用 Docker Desktop,請先關閉後再重試(網路資源衝突)
B. Git 問題 ★
B-1. 「'git' 不是內部或外部命令…」
- 最常見的原因是安裝後沒有重新開啟視窗。請完全關閉命令視窗與 Claude 桌面版,再重新開啟。
- 若仍無法解決,請重新啟動電腦。多數問題在這一步即可解決。
- 重新開機後仍相同,代表 Git 實際上沒有安裝成功 → 請到控制台「應用程式」確認 Git 項目後重新安裝
B-2. 沒有系統管理員權限,安裝被擋下(公司標準電腦)
- 安裝時若選擇「Only for me(僅限目前使用者)」選項,多數情況下不需要系統管理員權限即可安裝。
- 若仍然受阻,請向 IT 部門申請安裝 Git — 它並非開發專用工具,一般被廣泛核准作為日常工作工具。
- 若最終仍無法安裝,請依疑難排解 A-1 的第 4 項(雲端執行)進行。雲端已備妥 Git,不必安裝在自己的電腦上,也能完成全部實作。
B-3. 儲存(commit)時要求輸入姓名・電子郵件的錯誤
- 這是沒有完成 STEP 3 使用者設定的情況。輸入 STEP 3「首次使用者設定」中的兩行指令即可解決。
B-4. 公司網路出現 SSL 憑證錯誤 / 連線失敗
- 這是公司防火牆攔截連線的環境。切換成個人行動熱點後重試,大多可以解決。
- 若需要在公司內部網路持續使用,請洽詢 IT 部門套用公司內部憑證。不建議關閉安全驗證的設定。
C. 程式撰寫作業問題
C-1. 檔案有產生,但內容異常或無法執行
- 在同一個任務視窗中接著指示:「我用瀏覽器開啟後看不到內容,請修正」(修正也由 Claude 執行)
- 重新開啟新任務,再試一次相同的指示
C-2. 資料夾中沒有產生檔案
- 在 Cowork(協作)分頁確認「AI 實作」資料夾已連結後,再試一次
- 請避開 OneDrive 與公司同步資料夾,改用桌面上的一般資料夾
D. 共通問題
網路錯誤
- 在防毒軟體・防火牆中允許 Claude。若公司網路封鎖,請 IT 部門允許 claude.ai ↗ / anthropic.com ↗ 網域
一再要求登入
- 清除瀏覽器 Cookie 後重新登入,或改用其他瀏覽器
方案洽詢
- Cowork(協作)功能僅限付費方案(Pro 以上)使用
✅ 最終檢查清單(培訓前一天為止)
請逐項勾選。勾選狀態只會儲存在此瀏覽器中。
即使第 3・7・8 項最終仍無法解決,也不影響參與教育訓練。只要第 4 項(雲端執行)確認正常,所有實作都能進行。
第 5、6 項(Git)僅適用於在本機電腦上實作的學員。若選擇在雲端執行,則不需要安裝 Git。
🤖 仍無法解決時 — 直接詢問 AI
若以上方法仍無法解決,最快的方式是擷取錯誤畫面,直接詢問 AI。這個過程本身,也正是課程中「在工作上運用 AI」的預先演練。
方法
- 螢幕截圖 — 擷取顯示錯誤訊息的畫面。(Windows:Win + Shift + S → 選取區域 → 自動複製)
- 連線至 AI 服務 — 從 ChatGPT(chatgpt.com ↗)、Gemini(gemini.google.com ↗)、Claude(claude.ai ↗)中選擇您習慣的一個連線。
- 貼上圖片並提問 — 貼上截圖(Ctrl + V),並一併輸入下方的提問範本。
- 依回答處理 → 若仍無法解決,再把結果告訴 AI — 即使一次沒成功,只要接著說「我照做了,但出現這樣的畫面」繼續對話,解決的機率會大幅提高。
可直接複製使用的提問範本
附上的畫面是在 Windows 電腦上,使用 Claude 桌面版的 Cowork(協作)功能或安裝 Git 的過程中出現的錯誤。 · 我的環境:Windows [10 / 11],[Home / Pro] 版本,公司筆電(管理員權限 [有 / 無]) · 已嘗試過:[例 — 開啟 Hyper-V 功能、執行 wsl --update、重新安裝 Git 後重新開機] 請說明這個錯誤的原因,並依序提供新手也能照著做的解決方法。 若需要輸入指令,請一併告訴我要在哪裡、如何輸入。
若因公司資安政策而無法安裝或變更設定,AI 也無法解決。這種情況請不要勉強嘗試,直接依疑難排解 A-1 的第 4 項(雲端執行)進行,完全不影響實作。
注意:上傳前請確認畫面中沒有一併擷取到公司內部系統資訊、帳號資訊或客戶資料。
作者:Nanum 經營顧問 金鍾赫
常見問題
重點摘要
培訓前需要準備什麼?
Windows 10 以上的筆電(需有管理員權限)、Claude 付費帳號(建議 Pro 以上)、穩定的網路,以及 Git。依序進行安裝 Claude 桌面版 → 測試 Cowork(協作)→ 安裝 Git → 測試程式作業,約 40 分鐘即可完成。
一定要安裝 Git 嗎?
若要在自己的電腦上實作,務必安裝。沒有 Git 也能進行前半段實作,但在還原作業與版本管理的步驟會出錯而使進度中斷。安裝後請用 git --version 確認是否顯示版本,並完成一次姓名・電子郵件的使用者設定。
如果是公司電腦,虛擬化功能被封鎖或使用 Windows Home 版,該怎麼辦?
請將協作作業改在「雲端」執行。開始新作業時,在執行位置選擇雲端,即可不受虛擬化功能影響正常運作;雲端已內建 Git,因此不必在自己的電腦上安裝,所有實作都能完成。