CodeGym 安裝程式：它會對您的電腦做什麼

CodeGym 安裝程式會要求系統管理員權限，並在電腦上安裝十個左右的程式。這時候提高警覺很正常，也是對的。任何愛惜自己電腦的人都有權利問一句：這個程式到底打算對我的電腦做什麼？

這篇文章會完整回答這個問題，不加任何粉飾。會安裝什麼、放在哪裡、哪些東西我們不碰、會收集哪些資料，以及怎麼把這一切復原。

如果您不想使用安裝程式，那就不要用。沒有它也能完成課程：課程單元會一步步帶您手動安裝所需的一切。安裝程式只是幫您省去這些例行瑣事。

1. 為什麼需要它

這門課程需要不少工具：Claude Code 本身、開發環境、程式語言、建置工具。每個工具的安裝方式都不一樣，各有各的設定，其中有些還得互相串接並登入。

這些全部手動完成當然可以，但要花上好幾個小時，過程中很容易出錯，之後還得花很久找出為什麼啟動不了。安裝程式執行一次就能做完同樣的事。很無聊，但結果可以預期。

2. 會安裝什麼

以下是會出現在您電腦上的完整清單。

Claude Code 與語音輸入

Claude Code CLI - 課程的主要工具，也就是那個 AI 代理本身。它透過 Anthropic 官方安裝程式從 claude.ai 安裝，而且一律是最新版本。

Handy - 語音辨識工具程式。有了它，您可以用說的把任務交代給代理，不必打字。安裝時還會一併下載語音辨識模型 Parakeet V3（約 456 MB），這個模型在您的電腦上執行，不需要網路。

兩個 Claude Code 外掛 - 來自 Anthropic 官方外掛市集的 superpowers 和 frontend-design。

開發環境

IntelliJ IDEA - 課程的主要開發環境。會連同三個外掛一起安裝：Python 支援、CodeGym 外掛（用來提交作業、交給平台檢查）和 Claude Code 外掛（直接在開發環境裡開啟代理面板）。

Visual Studio Code - 第二個開發環境，會一併安裝，讓您依喜好選用。它搭配的是同一套外掛中的兩個：CodeGym（Beta 版）和官方的 Claude Code 擴充功能。

程式語言與工具程式

Node.js 24 - 課程專案和結果檢查都靠它執行。
Python 3.14 - 用於腳本和部分作業。
Java 25 (Eclipse Temurin) - CodeGym 平台的基礎。
Gradle 9.5.1 - 建置 Java 專案。
Git - 保存專案的歷史紀錄，課程後面會用到。在 Windows 上會一併安裝 Git Bash。

設定與登入

一個存放課程 AI 伺服器存取設定的檔案、CodeGym 外掛的組態，以及 Claude Code 的課程設定檔：代理的工作規則、輔助技巧，還有遊戲和 Web 專案的範本。這些都已經替您填好了，不需要輸入金鑰，也不必登入。

不同作業系統的差異

在 macOS 上，如果您沒有安裝 Homebrew（套件管理工具），安裝程式也會一併安裝它，因為 Git、Python 和 VS Code 都要透過它來安裝。

在 Linux 上會新增 Node.js、Python 和 Microsoft（用於 VS Code）的套件庫。在 Debian 上 Python 3.14 裝不起來，安裝程式會在報告中如實告知，您得自己手動安裝。

3. 所有東西放在哪裡

安裝程式不會把檔案散落在系統各處。所有東西都放在可以預期的位置，之後想看看什麼東西裝到了哪裡，不必到處翻找就能找到。

程式

作業系統	安裝位置
Windows	`Program Files`, `C:\Gradle`
macOS	`/Applications`, `/opt`
Linux	`/opt`

主資料夾中的三個目錄

.claude-codegym - Claude Code 的課程設定檔：設定、代理的工作規則、輔助技巧。

.codegym - 登入 CodeGym 外掛所需的設定，以及兩個啟動指令（下面會說明）。

.codegym-backups - 安裝程式改動過的檔案備份，外加一份變更日誌。保留最近 10 次執行或 30 天內的內容。

另外，Claude Code 本身會安裝到 ~/.local/bin，語音辨識模型則放在 Handy 存放資料的資料夾裡。

系統設定會有哪些變動

PATH 環境變數 - 讓課程的指令可以從終端機執行。在 Windows 上修改的是登錄檔，在 macOS 上是 .zprofile 檔案，在 Linux 上則是 /etc/profile.d/codegym.sh 和 .profile。

在 macOS 和 Linux 上，我們加入的幾行會用 # CODEGYM START 和 # CODEGYM END 標記包起來。這些標記一眼就看得到，還原時也只會刪掉這幾行，不會動到您自己的設定。

Windows 登錄檔 - 只有三個項目，僅此而已：Gradle 的路徑、課程指令的路徑，以及接受 IntelliJ IDEA 授權合約的紀錄。

4. 兩個指令：claude 和 claude-native

這是一個重要的細節，最好事先知道。

課程有自己的一套 Claude Code 設定：連線到課程伺服器、代理的工作規則、課程角色。這些不能和您個人的設定混在一起，所以我們把兩者分開了。

claude - 以課程設定檔啟動 Claude Code。學習這門課程時，用的就是這個。

claude-native - 啟動您個人的 Claude Code，就像我們不存在一樣。您自己的設定，您自己的帳號。

運作方式是這樣的：這兩個指令都是 .codegym/bin 資料夾裡的小腳本，啟動的是同一個真正的 Claude Code，只是各自指向不同的設定資料夾。我自己兩個都隨時備著：學課程時用課程那個，其他事情用自己的。

安裝程式不會讀取、修改或刪除您個人的 Claude Code 設定檔。如果您原本就有，它會原封不動地保留下來。

還有一點實務上的提醒：這些指令要在新開的終端機視窗裡才能使用。如果剛裝完就在原本已經開著的視窗裡輸入 claude，那個視窗還不認得這些指令，開一個新視窗就好。

5. 我們不做的事

這大概是最重要的一節。安裝程式是依照"不造成傷害"的原則寫成的，以下就是這個原則落實下來的做法。

不刪除、也不覆寫您已經安裝的東西。如果電腦上已經有其他版本的 Java、Python、Node 或 Git，它們會原地保留。課程用的版本會另外安裝，與原有版本並存。

不碰版本管理工具。如果您使用 nvm、pyenv、sdkman 或 asdf，安裝程式不會動它們，而是在報告中提醒您它另外裝了一個並存的版本。把您的 pyenv 弄壞，是我們最不想做的事。

已經是所需版本的東西不會重新安裝。再執行一次也不會弄壞已安裝的東西：安裝程式會逐一檢查每個工具，已經就緒的就略過。

不碰不是我們安裝的 IntelliJ IDEA。如果您的 IDEA 是透過 JetBrains Toolbox 安裝的，我們不會動它，而是另外為課程安裝一套，並告訴您這件事。

不覆寫您已做過的同意選擇。如果您已經接受過 IDEA 的授權，或設定過是否傳送使用統計資料，這些設定仍然照您的意思保留。

不插手開機啟動項目、服務和系統原則。安裝程式不會把自己加入開機自動啟動，不建立服務或工作排程器中的工作，不安裝憑證，也不碰防火牆、hosts 和 DNS。

不擴大 AI 代理的權限。課程設定檔不會解除 Claude Code 的任何限制：代理照常使用一般的安全設定運作，也和平常一樣會先徵求您的許可。

6. 會收集哪些資料

您的個人金鑰

下載時，壓縮檔裡會寫入一把與您的帳號綁定的個人存取金鑰。CodeGym 外掛和 Claude Code 會用它自動登入帳號，所以您才不必手動輸入任何金鑰。它不會出現在日誌裡：和密碼一樣，它會被同一個過濾器遮蔽掉。也正因為有這把金鑰，壓縮檔最好不要轉給別人。

安裝日誌

安裝過程中會記錄一份詳細的日誌：執行了哪些步驟、電腦上原本已經裝了什麼、哪些成功、哪些失敗。這份日誌留在您的磁碟上。不會傳到任何地方。

如果出了問題，要不要把它寄出來由您自己決定，也由您自己寄。在 Windows 上，它放在暫存資料夾裡（%TEMP%\codegym-install.log），在 macOS 和 Linux 上則是在安裝程式旁邊，檔名為 install.log。

密碼和金鑰不會寫進日誌：每一行在寫入之前都會先經過過濾器，權杖和密碼會被換成 [SECRET] 標記。您的組態檔內容也不會寫進去，只會記下參數名稱。

如果日後加入自動傳送錯誤報告的功能，我們會事先公告，並提供關閉的方法。

學習工作階段日誌

這是另一回事，必須直接說清楚。

Claude Code 的課程設定檔會開啟工作日誌記錄。當您做課程作業時，專案資料夾裡會建立一個 .codegym/cc-transcript.txt 檔案，記錄工作的過程：您對代理提出的請求、代理每則回應的開頭、代理修改了哪些檔案、執行了哪些指令。

為什麼需要它：平台會根據這份日誌檢查作業的解答。它就像您的"解題過程筆記"，看得到的不只是結果，還有您是怎麼一步步做到的。聽起來讓人有點不安，我懂。不過少了這份日誌，平台就只看得到最後做出來的東西。

需要了解的是：

日誌就放在您的專案資料夾裡，您可以打開來看；
它不會自己傳送到任何地方 - 負責記錄日誌的檔案裡，沒有任何一處會連上網路；
日誌裡的密碼和金鑰，會和安裝日誌一樣被遮蔽；
只有在課程設定檔下才會記錄。執行 claude-native，就不會寫入日誌。

與 AI 的互動經過哪台伺服器

還有一件事，坦白說出來比避而不談更重要。

課程中使用 AI 的費用由 CodeGym 支付，連線則經過我們的伺服器 llm.codegym.cc。這表示您送給模型的請求和模型的回應，實際上都會經過 CodeGym 的基礎設施。

學員的免費存取就是這樣運作的。如果您需要直接使用自己的個人帳號，claude-native 指令就是為此準備的。

7. 如何檢查、如何復原

您不必單憑這篇文章的一面之詞就相信。安裝程式有幾種模式，讓您事先查看、事後還原。

先看看，什麼都不安裝

--dry-run 旗標（Windows 上是 -DryRun）會讓安裝程式以"只顯示"模式執行。它會列出真正執行時會做的所有事情，包括下載哪些檔案、放到哪裡、在 PATH 裡加入什麼，然後直接結束，什麼都不安裝。

老實說，這個模式不能算是完全"什麼都不碰"。它會覆寫上一次執行留下的日誌檔、建立它自己要用的資料夾，並清掉過期的備份。不過，不會安裝任何程式，設定和 PATH 也都不會改變。

不動 PATH

--minimal 旗標（Windows 上是 -Minimal）會安裝所有程式，但不會把路徑寫進系統設定，而是改為印出幾行內容，讓您自己加進去。這個模式是給已經把環境調整成自己習慣的人用的（如果您不確定自己需不需要，那就是不需要）。

在 Windows 上，這個模式目前還沒有完全發揮作用：課程指令的路徑仍然會被加進使用者的 PATH。這個變動可以復原，但這個旗標暫時還沒完全做到它承諾的事。我們知道，會修正。

還原變更

--rollback 旗標（Windows 上是 -Rollback）會把安裝程式改過的設定還原：PATH、shell 設定檔、組態檔、登錄檔項目。每一項變更都會寫進操作日誌，還原時嚴格依照這份日誌進行。

還有一層保護：如果您在安裝之後編輯過某個檔案，還原時不會動它，而是通知您，並告訴您備份放在哪裡。

還原不會做的事：它不會移除已安裝的程式。IntelliJ IDEA、Java、Node 和其他程式都會留在原處。安裝程式會改為列出這些程式，並附上現成的解除安裝指令，要移除哪些，由您決定。

再坦白一個細節：在 Windows 上，Java、Node 和 Python 的安裝程式會自行寫入它們的路徑，不經過我們的操作日誌。這些項目，還原是還原不了的。

在 Windows 上，安裝程式會在安裝結束時直接印出現成的還原命令。執行方式如下：

以系統管理員身分開啟 PowerShell：在 PowerShell 圖示上按右鍵，再選擇"以系統管理員身分執行"。
切換到安裝程式所在的資料夾。
執行以下命令：

powershell -NoProfile -ExecutionPolicy Bypass -File .\resources\Windows_install.ps1 -Rollback

查看做了哪些事

執行結束時，安裝程式會輸出一份報告，列出所有步驟，每個步驟都標有狀態：完成、略過、警告、錯誤或"請手動處理"。失敗不會被隱藏：如果有東西沒裝好，報告會直接寫出來，並附上原因。

安裝程式自己沒能完成的事，會全部集中在一個獨立的"手動完成"區塊裡，並附上具體的指令。

8. 需要您親自動手的事

有些事情，本質上就是無法自動化。

Handy 的權限。第一次啟動時，系統會要求麥克風的存取權限（在 macOS 上還要"輔助使用"的權限）。沒有這些權限，語音輸入就無法運作。權限只能由人來授予，沒有任何程式能替您做這件事。

IntelliJ IDEA 第一次啟動時可能出現的視窗。安裝程式會事先接受授權，但如果授權視窗還是跳出來，請按接受。

9. 常見問題

安裝要花多少時間？

20-40 分鐘，大約要下載 1 GB。大部分時間花在 IntelliJ IDEA 和語音辨識模型上。

為什麼需要系統管理員權限？

程式會安裝到系統資料夾（Program Files、/opt、/Applications），沒有系統管理員權限就寫不進去。至於設定和課程設定檔，則是放在您的使用者資料夾裡，仍然屬於您。

安裝程式可以執行兩次嗎？

可以，不會弄壞任何東西。已經安裝的部分會被略過。另外也有防止不小心重複啟動的保護：第二個執行個體會發現安裝已經在進行中，然後直接關閉。

我自己的 Claude Code 設定會怎麼樣？

什麼事都不會發生。課程設定檔放在獨立的資料夾裡，您個人的設定檔不會被讀取，也不會被修改。個人工作請使用 claude-native 指令。

執行時系統跳出警告。這正常嗎？

正常。從網路下載的任何程式，作業系統都會這樣對待，而我們的安裝程式目前還沒有程式碼簽署憑證。在 Windows 上，請按一下"其他資訊"，再按"仍要執行"。在 macOS 上，如果系統顯示無法驗證開發者的訊息，請在檔案上按右鍵，選擇"打開"，然後再確認一次。

安裝程式會移除檔案上"從網路下載"的標記。為什麼？

不這麼做的話，系統會封鎖內附檔案的執行，安裝就會中途停下來。在 Windows 上，這個動作針對的是解壓縮後的資料夾；在 macOS 上，則是替同一個資料夾解除 Gatekeeper 的隔離。只有安裝程式自己的檔案會被移除這個標記，您其他的檔案，安裝程式一概不碰。

為什麼不能把壓縮檔轉給別人？

裡面有您個人的登入資料。拿到壓縮檔的人，就能用您的帳號操作。下載連結倒是可以分享，每個人都會拿到自己專屬的壓縮檔。

出問題了。該怎麼辦？

請查看最後的報告和 install.log 檔案，從中可以看出是在哪一步、因為什麼原因失敗。如果還是看不懂，就把這個檔案寄給客服。這是正常的處理方式，不是不得已的最後手段。

10. 如果您不想一次全部安裝

安裝程式不是課程的必要步驟，而是節省時間的一種方式。它做的每一件事，課程單元裡都有逐步說明：Claude Code 一個指令就能裝好，設定只要複製一個檔案。

其他工具可以等需要時再加上，到了那個時候，您也會明白為什麼需要它們。這樣記起來，也比一口氣看完十行清單牢靠得多。