414 文字
2 分
Codex 指定された git ref main は存在しません

先日、Codex を使っていた際に「Codex 指定された git ref main は存在しません」というエラーが発生して少し悩んだので、備忘録として共有します。

問題 : 「Codex 指定された git ref main は存在しません」#

GitHub と Codex を連携し、いざ実行しようとすると 「ブランチが存在しない」 というエラーが表示されます。
おそらく main ブランチをデフォルトで選択する仕様になっているため、古いリポジトリで master ブランチのみ存在する場合に発生するようです(エラー文のスクリーンショットを撮り損ねました)。

Codex エラー例

解決方法 1 : プロンプト入力 UI からブランチを選択する#

もっとも簡単な方法は、プロンプト UI 下部の プルダウン から目的のブランチを選択することです。
一覧から master を選ぶと、それ以降は master が保持された状態で実行できます。

解決方法 2 : ブランチ名を main に変更する#

根本的に解決したい場合は、リポジトリ側でブランチ名を master から main に変更してしまいましょう。最近の多くのツールでは main が標準になっています。以下のコマンド 1 行で変更できます。

git branch -m master main

まとめ#

Codex を使い始めてみると、細かなところで不便さを感じる場面もありますが、設定を見直すことで快適に利用できます。
同じエラーでお困りの方は、まずは ブランチ設定 を確認してみてください。

Codex 指定された git ref main は存在しません
https://naonao-na.com/posts/codex-error-branch/
作者
[object Object]
公開日
2025-07-07
ライセンス
CC BY-NC-SA 4.0