Claude CodeでSwiftの課題を壊してしまったら？2026年版・初心者向け復元ガイド

Claude CodeでSwiftの課題を開いたら、見覚えのない変更やエラーが出ている。
いったん編集を止め、プロジェクトのコピーを保存してから差分を確認し、必要な変更だけを復元してXcodeで検証します。

Swiftを学び始めたばかりで、Claude Codeに課題コードの説明や修正を頼んでいる学生向けです。
変更を消す前に、何が起きたかを順に切り分けます。

まず症状を分けて、元のプロジェクトを守ります

「壊れた」と感じても、問題は同じとは限りません。ファイルの中身が変わった、ビルドできない、実行結果が変わった、新しいコードの意味が分からない、という状態を分けて記録します。

最初にClaude Codeへ追加の修正を頼むのは止めます。エラー文、画面の変化、最後に行った操作をメモし、プロジェクトのフォルダを別の場所へコピーしてください。バックアップがない状態で修復を進めると、戻したい内容まで上書きするおそれがあります。

Claude Codeは、macOS、Linux、Windowsなどで利用できると公式ドキュメントに記載されています。ただし、どの環境でも提案や変更が課題の採点基準に合うとは限りません。Claude Codeの利用開始と対応環境を確認し、依頼内容と実際の差分を別々に判断します。

Claude CodeがSwiftプロジェクトで何を変更したか分からない場合は、ファイル名だけで判断せず、差分を確認します。追加、削除、変更されたファイルを一覧にしてから、内容を一つずつ見ます。画像や設定ファイルも課題の動作に関わることがあるため、見慣れない名前だけを理由に削除しないでください。

変更の範囲は一覧と差分で確かめます

プロジェクトにGitが設定されている場合は、まずターミナルでプロジェクトのフォルダへ移動して状態を確認します。

git status --short
git diff -- ファイル名

git status --shortは変更の状態を短い形式で表示します。Gitの状態には、作業中の変更、ステージされた変更、追跡されていないファイルなどがあります。表示の意味はGitのstatus公式説明で確認できます。

git diff -- ファイル名では、そのファイルの変更内容を行単位で見られます。たとえば、課題の関数だけが書き換わったのか、プロジェクト設定まで変更されたのかを見分ける助けになります。Gitのdiff公式説明を参照し、変更箇所を確認してから復元対象を決めてください。

コマンドの結果にファイル名が出たら、すぐ削除してよいですか。いいえ。新しいファイルが課題に必要な可能性もあります。元の課題資料、プロジェクト内の参照、差分の内容と照らし合わせ、役割が分からないファイルはコピーに残したままにします。

Claude Codeの操作や権限について不明点があれば、CLIの使い方と権限の公式説明も確認できます。実行を許可した操作と変更されたファイルを照らし合わせると、原因の切り分けがしやすくなります。

Gitの記録がある場合は、対象を絞って戻します

復元前に、コピーが別に保存されていることを確認します。そのうえで、変更範囲に応じて次のように選びます。

git restore -- ファイル名は、作業中の変更を復元する操作です。手元に残したい編集が含まれていないか、実行前に必ず差分を見てください。公式のgit restoreの説明には、復元元や対象を指定する方法が記載されています。

すでにコミットした変更を扱う場合は、先にgit logで記録を調べます。過去の内容をそのまま現在の作業へ戻す操作は、未コミットの変更を戻す場合とは異なります。意味が分からないまま復元コマンドを追加せず、Gitのlog公式説明で記録の見方を確認してください。

Gitの記録がない場合は、比較してから手作業で戻します

Gitを使っていないSwift課題では、まずプロジェクト全体のコピーを作ります。その後、授業で配布された元ファイルや、以前に保存したバックアップと照らし合わせ、違いが分かるファイルから戻します。

元資料と一致しないファイルや、作成時期が分からないファイルは、いったん残してください。課題ファイルだけ戻すつもりで設定やリソースまで置き換えると、プロジェクトが開けなくなることがあります。復元したファイルと保留したファイルをメモしておくと、後から原因を追いやすくなります。

授業で配布されたファイルが見当たらない場合は、どうすればよいですか。クラスの配布場所や保存済みのコピーを探し、見つからない場合は教員に元ファイルの入手方法を確認します。出どころを確認できないファイルを、名前だけで元の課題ファイルと決めつけないでください。

ビルドできないときは、コード・設定・環境を切り分けます

復元後もSwiftの課題が動かない場合、コードだけが原因とは限りません。エラー全文と、どの操作の直後に出たかを保存します。画面の一部だけでなく、対象ファイル名やエラーの前後も残すと、授業資料や公式資料と照らし合わせやすくなります。

切り分けでは、まず変更されたコードを確認し、次にターゲットやビルド設定を見ます。さらに、利用中のXcodeとmacOSが対応条件を満たしているかを確認します。AppleのXcodeドキュメントとXcodeのシステム要件は、環境の確認先になります。

ビルドの設定を変更した形跡があれば、Appleのビルドフェーズ設定に関する説明も参照してください。Xcode 27を使っている場合も、番号だけで対応可否を判断せず、授業で指定された環境とAppleの要件を確認します。

コードは実行できても、課題として正しいか分からない場合はどうしますか。課題文にある機能、ファイル構成、提出形式を項目ごとに照合します。Claude Codeの説明は変更を理解する手がかりにはなりますが、本人がコードを説明できることや、授業の評価基準を満たすことの証明にはなりません。理解できない部分は行ごとに読み、必要なら教員に確認してから提出します。

手元にMacがない場合も、検証環境を先に選びます

課題でmacOSとXcodeが必須なのに使えるMacがない場合は、学校の設備や、授業で認められたリモート環境が利用できるかを先に確認します。Windows上で作業できる範囲と、Xcodeでビルド・実行する工程は分けて考えてください。課題の指定環境に合わない方法で検証を済ませると、提出前の確認が不十分になることがあります。

手元のPCで続ける場合とMac環境を使う場合の違いは、利用環境の比較案内で確認できます。リモートで使う方法を検討する際は、利用開始の案内を読み、授業のルールに合うかを確認してから選びます。

ローカル環境なら通信に左右されず作業できますが、Mac本体の用意が必要です。遠隔のMac環境なら購入せず試せる一方、接続状況に影響され、操作感も手元のPCとは異なる場合があります。まずは課題のコピーで復元と検証を済ませ、継続してMacが必要かを判断してください。短期間だけmacOSとXcodeを使いたい場合は、NUMACSの利用条件を確認してから選択肢に加えるのが現実的です。