Windows側にはClaude Codeを入れたのに、リモートMacのプロジェクトが表示されません。
最短の解決策は、プロジェクトを保存してコマンドを実行するリモートMacへ、Claude Codeを直接インストールすることです。2026年の初心者は、公式のネイティブインストール、バージョン確認、環境診断、ブラウザー認証の順に進み、最後に捨ててもよい練習用プロジェクトで動作を確かめます。
最終更新:2026年9月1日。システム要件、インストール方法、認証資格、更新方法は、公開時点のClaude Code公式セットアップ資料を基準に確認しています。
今週の作業予定と対象者
| 時点 | 実施すること | 完了の判定 |
|---|---|---|
| 接続直後 | 利用者、作業場所、書き込み権限を確認 | 個人用ディレクトリを開ける |
| 導入時 | 公式のネイティブ方式でClaude Codeを入れる | claude --version が実行できる |
| 初回利用 | 認証と環境診断を行う | アカウントと端末状態を確認できる |
| 学習開始 | 小さな練習用プロジェクトを読み込ませる | 差分と実行結果を確認できる |
この記事は、Windowsしか持っていないもののmacOSで学習したい学生、すでにリモートMacを借りていてターミナルに慣れていない人、Claude Codeを短期間だけ試してから継続利用を決めたい人に向いています。すでにMac上の開発環境が安定しており、企業向けの権限管理を設計したい人には、より専門的な資料が必要です。
置き場所の確認
リモートデスクトップは教室のモニター、SSHは教室へ入る入口、Claude Codeは質問に答えながら作業する助教に近い役割です。モニターだけをWindows側に用意しても、助教が遠い別の教室にいれば、Mac上のファイルを読めません。
したがって、インストール先は画面を表示するWindowsではなく、実際にソースコードを保存し、git や実行コマンドを動かすMacです。SSHで接続した場合も、グラフィカルな画面から開いたターミナルでも、同じリモートMacの同じ利用者アカウントを使う必要があります。
Claude CodeはmacOSに対応し、公式資料ではネイティブインストールが推奨されています。対応するmacOSの下限や利用できるアカウントの範囲は変更される可能性があるため、導入前に公式のインストールと認証の説明でその時点の条件を確認します。
MacにNode.jsを先に入れる必要はありますか。
現行の公式ネイティブ方式を使う場合、Node.jsを先に導入することを前提にした手順ではありません。古い記事にあるNode.jsや別のパッケージ管理方式をそのまま採用せず、公式ページに表示された現行コマンドを確認してから実行します。
最初の接続と学習机
まずWindowsからリモートMacへ接続し、ターミナルで現在の利用者と場所を確認します。SSHを使う場合の設定範囲は、Apple公式のSSHリモートログイン案内で確認できます。学校の端末で接続が制限されている場合は、管理者の許可を得ずに制限を回避してはいけません。
whoami
pwd
ls -la
出力例は次のような形です。
student
/Users/student
ここで停止する条件は明確です。利用者が想定外の名前になっている、pwd がシステム用ディレクトリや他人と共有する場所を示している、ファイル一覧を表示できない場合は、Claude Codeをまだ起動しません。
個人用の学習ディレクトリを作り、そこへ移動します。
mkdir -p ~/learning/claude-first-project
cd ~/learning/claude-first-project
touch README.md
ls -la
README.md が一覧に現れれば、少なくともその場所へ書き込めます。学校や他人の共有フォルダーではなく、退出後も本人が見つけられる場所を選ぶことが重要です。
公式方式によるインストール
公式資料に掲載されているネイティブインストールのコマンドだけを使います。記事、掲示板、ファイル共有サービスからコピーした不明なスクリプトは実行しません。コマンドは公開後に変わることがあるため、次のブロックは「公式ページで現行内容を確認してから置き換える」ための位置として扱います。
# 公式ページの現行インストールコマンドを確認して実行
インストール後は、シェルがコマンドの場所を認識しているかを確認します。
claude --version
command -v claude
バージョン文字列と実行ファイルの場所が返れば、単にインストーラーが終了しただけでなく、現在のシェルから呼び出せる状態です。公式のCLIリファレンスでも、Claude Codeのコマンド実行や利用方法が案内されています。公式CLIリファレンスを見ながら、知らないオプションを追加しないようにします。
インストール後に「コマンドが見つからない」と表示された場合の確認順
最初に、インストールが完了しているか、次に実行ファイルの保存場所がシェルの検索対象に入っているかを調べます。
command -v claude
echo $SHELL
echo $PATH
何も返らない場合は、公式の現行手順を再確認し、ターミナルを開き直してから再試行します。改善しなければ、ネットワーク接続、書き込み権限、シェル設定の順に切り分けます。企業や学校のプロキシが通信を止めている可能性がある場合は、公式のプロキシ設定資料を参照します。
Homebrewは便利ですが、今回は主経路にしません。複数の導入方法を同時に試すと、どの実行ファイルを呼び出しているのか分からなくなり、更新方法も混乱するためです。
認証と環境診断
コマンドが動いたら、リモートMac上でClaude Codeを起動します。
cd ~/learning/claude-first-project
claude
初回認証では、表示された案内に従ってブラウザーでアカウントを確認します。Windows側のブラウザーが自動で開かない場合は、ターミナルに示された認証用URLを目視で確認し、公式ドメインのページだけを開きます。URLをチャットや公開メモへ貼り付けたり、認証情報を他人へ渡したりしてはいけません。
ブラウザーが自動的に戻らないときはどうしますか。
認証ページで完了した後、ターミナルへ戻り、画面に示された待機状態を確認します。自動転送が失敗しても、別の認証手順やコード入力が公式画面に示される場合だけ、それを使います。表示がないまま推測でコマンドを追加したり、認証確認を無効にしたりしてはいけません。
続いて、公式の環境診断方法を実行します。
claude doctor
利用できる診断項目や表示内容はリリースによって変わる可能性があるため、実行結果と公式の診断・利用資料を照合します。ログインできたことだけで成功と判断せず、作業ディレクトリ、通信、権限、アカウント状態を確認します。
APIキーを作業ファイル、課題提出物、チャット履歴、公開リポジトリへ書き込まないでください。アカウントの種類や認証方式、組織側のアクセス制御は変わり得るため、公式のID・権限管理資料を基準にします。
初回プロジェクトの安全な検証
最初から授業の本番課題や重要なリポジトリを開かず、削除しても困らない練習用プロジェクトを使います。次のように小さなファイルを用意します。
printf 'print("hello")\n' > hello.py
printf '# Claude Code practice\n' > README.md
claude
Claude Codeには、まず読み取りだけを依頼します。
この練習用プロジェクトのファイル構成を説明し、変更せずに改善案だけを示してください。
提案を確認してから、対象ファイルを限定して編集を依頼します。
hello.pyだけを変更対象にしてください。変更内容を先に説明し、承認を待ってください。
読み取り、ファイル変更、シェルコマンド実行は同じ操作ではありません。公式の権限説明に沿って、初回は自動承認を広げず、変更対象と実行内容を一つずつ確認します。特に削除、外部通信、認証情報の読み取りを含む命令は、意味を理解できない限り承認しません。
最後に、差分と実行結果を確認します。
git diff -- hello.py
python3 hello.py
Git管理を始めていない場合でも、変更前後のファイルを比較します。AIが「完了しました」と返したことではなく、コード差分が依頼どおりで、実行結果または授業のテストを通過したことを完了条件にします。
接続方式と導入経路の選び方
| 状況 | 接続方法 | 導入判断 | 次の行動 |
|---|---|---|---|
| Macの画面も操作したい | リモートデスクトップ | Mac側のターミナルで導入 | 同じ利用者の作業フォルダーを開く |
| 端末操作に慣れている | SSH | SSH先のMacへ導入 | pwd と権限を確認する |
| 導入方法を迷っている | 公式ネイティブ方式 | 最初の選択肢にする | 公式ページの現行コマンドを使う |
| 既存環境を壊したくない | 練習用ディレクトリ | 本番プロジェクトを後回しにする | 読み取りから始める |
この表で「現在のプロジェクト場所」と「Claude Codeを起動する場所」が一致しない場合は、いったん接続を見直します。WindowsにCLIだけを入れても、リモートMacのファイルを自動的に共有できるわけではありません。
終了後の保存と継続判断
作業を終える前に、プロジェクトが個人用ディレクトリや本人のバージョン管理領域に保存されているか確認します。
pwd
ls -la
git status
SSHやリモート画面を閉じてもファイルが残る場所か、別の端末から再接続して同じファイルを開けるかを確認します。保存先が一時領域だった場合は、授業の成果物を移す手順を先に決めます。
Claude Codeの更新方法は、ネイティブ方式、Homebrewなどの導入経路によって異なる可能性があります。導入経路をメモしておき、更新時は公開時点の公式資料を再確認します。
短期講座だけで使うなら、まず必要な週や授業期間に合わせて環境を維持し、継続的に使うかを後から判断できます。長期間の安定した重い処理、物理的なUSB機器、常時ローカル接続が必要な学習では、自分でMacを所有する方が合う場合もあります。反対に、学校のWindowsしかなく、特定の課題でmacOSとClaude Codeを試したい場合は、NodeMiniのMac環境を候補に加え、Macの利用方法と申し込み条件を確認してから期間を決めると無駄がありません。
Windowsの現在の学習環境だけで進める場合、macOS専用のツールを使えない、学校端末の権限でソフトを追加できない、環境を毎回作り直す必要があるという制約が残ります。自分でMacを購入する方法は自由度が高い一方、初期費用と保守を負担し、短期の授業には余りやすい選択です。
そのため、まず短期間だけClaude Codeを試し、授業用の小さなプロジェクトで接続・保存・権限を確認したい学生には、NodeMiniのリモートMacを学習期間に合わせて使う方が判断しやすい場合があります。完了後にファイルを回収し、継続利用が必要かを決めるという順番なら、長期契約を先に固定せずに済みます。