GitHubのリモートリポジトリURLを変更する方法

GitHubのリポジトリ移行や名称変更に伴い、ローカル環境の接続先（リモートURL）を更新する必要が出てくることがあります。

本記事では、安全かつ迅速にリモートリポジトリの設定を変更する手順を解説します。

1. 現在のリモートリポジトリ設定を確認する

まずは、現在ローカルリポジトリがどのURLを向いているかを確認しましょう。
このコマンドを実行することで、現在の fetch（取得元）と push（送信先）のURLが表示されます。

git remote -v

2. 新しいリポジトリURLへ変更する

次に、接続先を新しいリポジトリのURLへ更新します。

git remote set-url origin {New-url}

Point: URLの間違いを防ぐため、GitHubの「Code」ボタンからコピーした最新のURLを使用してください。

3. カレントブランチがデフォルトブランチであることを確認する

作業ミスを防ぐため、現在のブランチがデフォルトブランチであることを確認します。

git branch

もし、デフォルトブランチ以外のブランチにいる場合は、以下のコマンドで切り替えます。

git switch {default-branch}

4. 新しいURLで動作確認（Pullの実行）

URLの設定が正しく反映されているか、実際に通信を行って確認します。

git pull origin {default-branch}

エラーが出ずに最新のコードが取り込まれれば、URLの変更は成功です。

5. VSCodeとGitHubの連携・認証

VSCodeを使用して操作している場合、URL変更後の最初の通信時に認証を求められることがあります。

Point: MFA（多要素認証）を設定している場合: 認証画面が表示されますので、GitHubのMFAコード（認証アプリの数字など）を入力して連携を完了させてください。

まとめ：スムーズなリポジトリ移行のために

リモートURLの変更は頻繁に行う作業ではありませんが、手順を間違えると同期エラーの原因になります。変更後は必ず git pull で確認を行う習慣をつけましょう。