CodeGymインストーラー：あなたのパソコンに何をするのか

CodeGymのインストーラーは管理者権限を求め、パソコンに10個ほどのプログラムをインストールします。ここで警戒するのはごく普通のことで、正しい反応です。自分のマシンを大切にしている人なら誰でも、こう尋ねる権利があります。このプログラムは、具体的にマシンに何をしようとしているのか？

この記事は、その問いに包み隠さず、すべて答えます。何がインストールされ、どこに置かれ、何には手を触れないのか、どんなデータが収集され、どうすればすべて元に戻せるのか。

インストーラーを使いたくなければ、使わなくてかまいません。コースはインストーラーなしでも進められます。必要なものはすべて、講義の中で手順を追って手動でインストールできます。インストーラーは、その単調な作業を肩代わりしてくれるだけです。

1. なぜインストーラーが必要なのか

このコースでは、かなり多くのツールを使います。Claude Code本体、開発環境、プログラミング言語、ビルドツール。インストール方法はそれぞれ違い、設定もそれぞれ異なり、一部はさらに互いに連携させてログインまで済ませる必要があります。

これを全部手作業でやることもできます。ただ、数時間かかるうえにミスをしやすく、あとで何が原因で起動しないのかを延々と探すはめになりがちです。インストーラーは同じことを1回の実行で済ませます。地味ですが、何が起きるかは予測できます。

2. 何がインストールされるのか

パソコンに入るものの完全なリストは以下のとおりです。

Claude Codeと音声入力

Claude Code CLI - コースのメインツールで、AIエージェントそのものです。Anthropic公式のインストーラーでclaude.aiからインストールされ、常に最新バージョンが入ります。

Handy - 音声認識ユーティリティです。エージェントへのタスクをキーボードで打つ代わりに、声で口述するために使います。一緒に音声認識モデルParakeet V3（約456 MB）がダウンロードされます。このモデルはあなたのパソコン上で動作し、インターネット接続は必要ありません。

Claude Code用のプラグイン2つ - Anthropic公式マーケットプレイスのsuperpowersとfrontend-designです。

開発環境

IntelliJ IDEA - コースのメインの開発環境です。3つのプラグインが一緒に入ります。Pythonサポート、CodeGymプラグイン（課題の解答を送ってチェックしてもらうためのもの）、Claude Codeプラグイン（開発環境の中にエージェントのパネルを表示）です。

Visual Studio Code - 2つ目の開発環境で、好みで選べるように、あわせてインストールされます。同じセットから2つのプラグインが入ります。CodeGym（ベータ版）と公式の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プロジェクト用のテンプレート）。すべてあなた用に入力済みなので、キーを入力したりログインしたりする必要はありません。

OSごとの違い

macOSでは、Homebrew（パッケージマネージャー）が入っていなければ、インストーラーがそれもインストールします。Git、Python、VS CodeはHomebrew経由で入るためです。

Linuxでは、Node.js、Python、Microsoft（VS Code用）のリポジトリが追加されます。DebianではPython 3.14はインストールされません。インストーラーはそのことをレポートで正直に伝えるので、手動でインストールしてください。

3. どこに置かれるのか

インストーラーはファイルをシステムのあちこちにばらまいたりしません。すべて予測できる場所に置かれるので、あとで何がどこに入ったか確かめたくなっても、探し回らずに見つかります。

プログラム

OS	インストール先
Windows	`Program Files`, `C:\Gradle`
macOS	`/Applications`, `/opt`
Linux	`/opt`

ホームフォルダーの3つのディレクトリ

.claude-codegym - Claude Codeの学習用プロファイルです。設定、エージェントの作業ルール、補助的な手法が入っています。

.codegym - CodeGymプラグインにログインするための設定と、2つの起動コマンド（後述）が入っています。

.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のレジストリ - 書き込むのは3項目だけです。Gradleへのパス、コースのコマンドへのパス、そしてIntelliJ IDEAのライセンス契約への同意です。

4. 2つのコマンド：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には手を触れません。JetBrains ToolboxのIDEAを使っているなら、それには触れず、コース用に別のIDEAをインストールして、そのことをお知らせします。

あなたの同意設定を上書きしません。すでに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、シェルのプロファイルファイル、設定ファイル、レジストリの項目です。変更はすべて操作ログに記録されていて、ロールバックはそのログに厳密に従って行われます。

さらに安全策もあります。インストール後にあなたがファイルを編集していた場合、ロールバックはそのファイルに手を触れません。代わりにそのことを知らせ、バックアップの場所を示します。

ロールバックがしないこと：インストールしたプログラムの削除はしません。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）にインストールされ、管理者権限がなければそこには書き込めないからです。一方、設定とプロファイルはあなたのユーザーフォルダーに置かれ、あなたのものとして残ります。

インストーラーを2回実行してもいいですか？

はい、何も壊れません。インストール済みのものはスキップされます。うっかり二重に起動した場合の保護もあります。2つ目のインスタンスはインストールがすでに進行中だと検知して、そのまま終了します。

私のClaude Codeの設定はどうなりますか？

何も変わりません。学習用プロファイルは別のフォルダーにあり、あなた個人のプロファイルは読まれることも変更されることもありません。個人の作業にはclaude-nativeコマンドがあります。

起動時にシステムが警告を表示します。これは正常ですか？

はい。インターネットからダウンロードしたプログラムには、OSはどれもこう反応します。私たちのインストーラーには、まだコード署名証明書がありません。Windowsでは"詳細情報"をクリックし、続けて"実行"をクリックしてください。macOSで"開発元を検証できない"という趣旨のメッセージが出た場合は、ファイルを右クリックして"開く"を選び、もう一度確認してください。

インストーラーがファイルから"インターネットからダウンロード"の印を外すのはなぜですか？

そうしないと、システムが同梱ファイルの実行をブロックし、インストールが途中で止まってしまうからです。Windowsでは展開したフォルダーに対してこれを行い、macOSでは同じフォルダーのGatekeeperの隔離属性を解除します。印が外されるのはインストーラー自身のファイルだけで、インストーラーはあなたのほかのファイルには一切触れません。

アーカイブを他人に渡してはいけないのはなぜですか？

中にあなた個人のログイン情報が入っているからです。アーカイブを受け取った人は、あなたのアカウントで作業できてしまいます。ダウンロードリンクを教えるのはかまいません。それぞれが自分専用のアーカイブを受け取れます。

何か問題が起きました。どうすればいいですか？

最後に表示されるレポートとinstall.logファイルを見てください。どのステップで、なぜ失敗したかがわかります。それでもわからなければ、このファイルをサポートに送ってください。これは最後の手段ではなく、ごく普通の対応です。

10. 全部を一度に入れたくない場合

インストーラーはコースの必須ステップではなく、時間を節約するための手段です。インストーラーがすることはすべて、講義の中で手順を追って説明しています。Claude Codeはコマンド1つでインストールでき、設定はファイル1つをコピーするだけです。

ほかのツールは、必要になったときに追加していけば大丈夫です。その頃には、なぜそのツールが必要なのかもわかっているはずです。10行のリストで一度に覚えるより、そのほうがずっと記憶に残ります。