タイトル: fatal: remote origin already exists.
SEOタイトル: git「fatal: remote origin already exists」の原因と対処（remove/set-url）
| この記事の要点 |
|
このエラーの概要
git remote add origin を実行したときに出ます:
$ git remote add origin https://github.com/user/repo.git
fatal: remote origin already exists.
# 確認すると確かにある
$ git remote -v
origin https://github.com/old-user/old-repo.git (fetch)
origin https://github.com/old-user/old-repo.git (push)git にとって 「リモート」は名前付きの参照です。origin という名前が既に使われていれば add は失敗します。これは安全機構で、知らずに別 URL に上書きされるのを防いでくれます。
解決パターン3つ
| やりたいこと | コマンド | 備考 |
|---|---|---|
| origin の URL を変えたいだけ | git remote set-url origin | 最も安全。履歴・upstream 維持 |
| origin を消して付け直す | git remote remove origin → git remote add origin | upstream 設定もリセットされる |
| 別名で並行追加 | git remote add upstream | fork 元参照などで定番 |
対処A: set-url で URL だけ変更（推奨）
# 現在の origin URL を確認
git remote -v
git remote get-url origin
# URL を変更
git remote set-url origin https://github.com/new-user/new-repo.git
# SSH ↔ HTTPS 切替
git remote set-url origin git@github.com:user/repo.git
# fetch 用と push 用で別 URL にする (ミラーリング時)
git remote set-url --push origin git@gitlab.internal:user/repo.git
# 確認
git remote -v
# origin https://github.com/new-user/new-repo.git (fetch)
# origin https://github.com/new-user/new-repo.git (push)
# 試しに fetch
git fetch origin対処B: 削除して付け直し
# remove (rm) でリモート削除
git remote remove origin
# あるいは古い書き方
git remote rm origin
# 確認（何も出ない）
git remote -v
# 改めて追加
git remote add origin https://github.com/user/repo.git
# 初回 push で upstream 設定
git push -u origin main
# upstream 設定だけ後から付けることもできる
git branch --set-upstream-to=origin/main main対処C: 別名で追加（fork 開発で多用）
OSS の fork 開発では、自分の fork を origin、本家を upstream として両方扱います:
# 自分の fork
git remote add origin git@github.com:my-user/my-fork.git
# 本家を upstream として追加
git remote add upstream https://github.com/original-author/repo.git
git remote -v
# origin git@github.com:my-user/my-fork.git (fetch)
# origin git@github.com:my-user/my-fork.git (push)
# upstream https://github.com/original-author/repo.git (fetch)
# upstream https://github.com/original-author/repo.git (push)
# 本家の最新を取り込む
git fetch upstream
git checkout main
git merge upstream/main
git push origin maingit clone 直後にこのエラーが出るのはなぜ?
git clone は自動的に origin を設定します。そのため clone 直後にもう一度 git remote add origin すると重複エラーになります。
git clone https://github.com/user/repo.git
cd repo
git remote -v
# origin https://github.com/user/repo.git (fetch) ← 既にある
# origin https://github.com/user/repo.git (push)
# ここで以下を実行するとエラー
git remote add origin https://github.com/user/repo.git
# fatal: remote origin already exists.リモート一覧と詳細表示
# 一覧（URL 付き）
git remote -v
# 名前のみ
git remote
# 詳細
git remote show origin
# * remote origin
# Fetch URL: ...
# Push URL: ...
# HEAD branch: main
# Remote branches:
# main tracked
# Local branch configured for 'git pull':
# main merges with remote main
# Local ref configured for 'git push':
# main pushes to main (up to date)
# 名前変更（origin → upstream に rename したいとき）
git remote rename origin upstream関連エラーと対処
| エラー | 状況 | 対処 |
|---|---|---|
error: No such remote: 'origin' | 削除済み or 未設定 | git remote add origin URL |
fatal: refusing to merge unrelated histories | 新規リモートに既存ローカルを push | git pull --allow-unrelated-histories origin main |
error: src refspec main does not match any | commit が一つも無い | git add . && git commit -m init |
! [rejected] main -> main (fetch first) | リモートに先行コミットあり | git pull --rebase 後 push |
FAQ
Q: set-url したのに古い URL に push されている
A: --push オプション付きで別 URL を設定した可能性。git remote -v で (fetch) と (push) を両方確認してください。
Q: リモートを丸ごとリセットしたい
A: .git/config を直接編集して [remote "origin"] セクションを削除する手もありますが、git remote remove origin の方が安全です。
Q: GitHub から GitLab に移行したい
A: git remote set-url origin git@gitlab.com:user/repo.git → git push --all + git push --tags で全ブランチとタグを移行できます。