Codex CLIとGitHubの基礎知識
「AIがコードを書いてくれる」
「GitHubと連携できる」
Codex CLIについて調べると、そういった説明を目にするはずです。しかし、Codex CLIが実際に何をしてくれるツールなのか、GitHubとはどう役割が違うのかを知らないまま使い始めると、思っていた動きと違って戸惑ってしまうことも少なくありません。
まずはここで、Codex CLIというツールの正体やGitHubとの関係を掴みましょう。
Codex CLIの役割
Codex CLIは、ローカルPCのターミナル上で動くAIコーディングエージェントです。
ここでのターミナルとは、WindowsのコマンドプロンプトやPowerShell、macOSのターミナルアプリなど、コマンドを打ち込んで操作する画面をまとめて呼ぶときの言葉です。この記事では、そうした画面全般を指してターミナルと表記します。
AIコーディングエージェントは、コードを読んだり書いたりテストしたりといった作業を、人の代わりに進めてくれるAIだと考えてください。
Codex CLIはOpenAIが開発、提供しているツールです。最大の特徴は、難しいコマンドを覚えなくても、普段話すのと同じ言葉でAIに指示を出せる点です。
例えば、Codex CLIには次のような作業を任せられます。
- リポジトリの中にあるコードの内容の解説
- うまく動かない原因の調査
- 見つかった問題の修正
- テストコマンドの実行やテスト結果の報告
こうした一連の作業を、まとめて任せることができるのです。
プログラミングに慣れていない方でも、
「このコードはどんな処理をしていますか？」
「このエラーを直してください」
のように話しかけるだけで作業が進むので、開発の入り口として非常に有用なツールといえるでしょう。コードを自分で書く量を減らしながら、AIとのやり取りを通じて開発の考え方を学べるのも大きな魅力です。
【関連】Codex CLIとは？初心者向けにできることや使い方をわかりやすく解説
Git・GitHubとCodex CLIの関係
Codex CLIの位置づけを理解するうえで、大切なのがGitやGitHubとの関係です。
Codex CLIはGitHub自体を操作するツールではなく、ローカル上にあるGitリポジトリを操作し、その結果をGitHubに反映させるための補助ツールです。
Gitはコードの変更履歴を記録していく仕組みで、GitHubはそのGitのリポジトリをインターネット上で共有・管理するためのサービスです。
Codex CLIはあくまでローカル上で動き、コードの調査や修正をサポートしてくれますが、修正した内容をGitHubに送る際は、git pushのようなGitコマンドを自分で打つか、Codexにそのコマンドを実行するよう頼む必要があります。
つまり、CodexはGitやGitHubを使った作業をより効率的にしてくれる存在であって、GitHub自体を置き換えるツールではないということです。
GitとGitHubがどう連動しているのかを先に押さえておくと、Codex CLIの便利さがより実感しやすくなるでしょう。
GitHub Copilot CLIとの違い
Codex CLIとよく比較されるのが、GitHub Copilot CLIです。どちらもターミナルから使えるAI開発支援ツールという点は共通しています。しかし、提供元もGitHubとの関わり方も異なります。
Codex CLIを使うにはOpenAIのサービスが必要で、ChatGPTアカウントかOpenAI APIキーのいずれかで利用します。
一方のGitHub Copilot CLIはGitHubが提供しており、GitHub Copilotの契約が必要です。
GitHubとの連携の深さにも違いがあります。
GitHub Copilot CLIはGitHubの仕組みに直接組み込まれているため、GitHub操作に特化したサポートを得意としています。
それに対して、Codex CLIはGitHubに縛られず、手元のコードに対してより幅広く作業できる点が強みです。
どちらを選ぶべきかは目的次第ですが、GitHubを日常的に使っていて、リポジトリ操作と柔軟なAIとの対話を両立させたいなら、Codex CLIは有力な候補になります。
Codex CLIでGitHubを使うための準備
いきなりCodex CLIとGitHubを連携させようとしても、準備が整っていなければ動作しません。初めての方でも迷わず進められるようにステップを踏んで説明していきます。ツールのインストールから見ていきましょう。
Codex CLIのインストールと起動
Codex CLIはnpmを使って簡単にインストールできるツールです。まずNode.jsがインストールされている環境を用意し、ターミナルに次のコマンドを入力しましょう。
npm install -g @openai/codexインストールが完了したら、ターミナルで codex と入力してEnterを押すと、Codex CLIが起動します。初回起動時はログインや認証の手順が促される場合があります。
起動した後は、ターミナル上でそのまま会話を始められるので、コマンドを暗記していなくてもすぐに利用できるはずです。
ちなみに、インストール方法はnpmだけではありません。macOSであればHomebrewからも導入できます。Windowsの場合は、PowerShellで公式のインストールスクリプトを実行する方法があります。
自分が使っている環境に合わせて、公式ドキュメントで確認しておくと安心です。
Codex CLIのauthとログイン
Codex CLIを認証する方法は2つあります。ChatGPTアカウントを使うcodex loginと、OpenAI APIキーを使う方法です。どちらも仕組みが異なるため、最初に違いを押さえておきましょう。
codex login を実行すると自動でブラウザが立ち上がり、ChatGPTアカウントでサインインするだけで認証が完了します。ChatGPT Plusなどのプランにすでに加入している方は、この方法が手軽です。
もう一方のAPIキーを使う方法では、OpenAIのダッシュボードで発行したキーを、まず環境変数OPENAI_API_KEYに設定します。そしてcodex login --with-api-keyコマンドを実行し、ログインを完了させる必要があります。環境変数を設定しただけでは認証は完了しない点に注意しましょう。
注意したいのは、この2つはどちらもOpenAIのサービスに対する認証であり、GitHubへのログインとは別物だという点です。
GitHubを操作するには、これとは別にGitHub側の認証が必要になります。この点は、混同しないように覚えておきましょう。
GitHub CLIとGitHubへの認証
GitHubには、コードの変更内容をレビューしてもらうために提案するPR（プルリクエスト）や、不具合や「こんな機能が欲しい」といった要望を書き留めておくIssueといった仕組みがあります。
この仕組みをターミナルから直接操作したいときに欠かせないのが、GitHub CLIです。
GitHubが公式に提供しているコマンドラインツールで、ブラウザを開かずにGitHubを操作できるようになります。
インストールはmacOSであれば brew install gh、Windowsであれば winget install --id GitHub.cli で行えます。
インストールが終わったら、次のコマンドでGitHubアカウントを認証しましょう。
gh auth login実行するとプロンプトが表示され、ブラウザ経由またはトークンを使ってGitHubアカウントにサインインできます。
認証が完了すると、ターミナルから gh pr create でPRを作成したり、 gh issue list でIssueの一覧を確認したりと、GitHubの操作をターミナルから直接行えるようになります。
Codex CLIとGitHub CLIを組み合わせておくと、AIによる作業補助とGitHubの操作を一つの画面で完結させられるので、作業がぐっとスムーズになります。
GitHubリポジトリのcloneとCodex CLIの起動
GitHubにあるリポジトリをローカルに取得するには、git cloneコマンドを使うのが基本です。このコマンドで、GitHubのリポジトリがローカルPCにコピーされ、Codex CLIで操作できる状態になります。
git clone <https://github.com/ユーザー名/リポジトリ名.git>
cd リポジトリ名
codex流れとしては、git clone でリポジトリを取得し、cd コマンドでそのフォルダに移動してから、codex と入力してCodex CLIを起動します。
Codex CLIは、今自分がいるフォルダの中身を読み込んで動作する仕組みになっているため、必ず対象リポジトリのフォルダに移動してから起動するようにしてください。この順番を間違えると、意図したリポジトリを読み込んでくれません。
すでにローカルにクローン済みのリポジトリがある場合は、clone手順を省略して cd と codex だけで使い始められます。GitHubのリポジトリであれば、公開されているものでも非公開のものでも、アクセス権限さえあれば同じ手順で使えます。
GitHubリポジトリを使ったCodex CLIの基本操作
環境が整ったら、いよいよ実際の開発作業です。
ここからは、コードを調査したり編集したりする基本操作から、GitHubへの変更反映、IssueやPRを使ったチーム開発の流れまでを順に見ていきます。実際にどんな場面で使うのかをイメージしながら読み進めてみてください。
コードの調査・編集・テスト
Codex CLIを起動した状態で言葉を打ち込むと、リポジトリのコードをAIが読み解いて、調査から編集、テストまで進めてくれます。コードを自分で読み書きしなくても、会話をしながら作業を進められるのがポイントです。
「このリポジトリのmain.pyはどんな処理をしていますか？」と聞けば、Codexがコードの中身を読んでその場で説明してくれます。
「〇〇という関数にバグがないか確認してください」と頼めば、調査に取りかかります。問題が見つかれば修正案まで提示してくれます。
「テストを実行してください」と伝えれば、実際にテストコマンドを動かして結果を報告してくれます。
指示は、具体的に伝えるほど正確に動いてくれます。人にお願いをするのと同じように指示するのがポイントです。
「〇〇を実行したときに△△というエラーが出ています。原因を調べて修正してください」
のように状況を添えて伝えると、Codexも的確に対応しやすくなります。
branch・diff・commit・pushを使った変更管理
コードを修正する際は、作業用のブランチを作成してから変更を加えるのが基本的なルールです。ブランチとは、メインのコードを保護しながら、安全に変更を試せる独立した作業スペースのことです。
Codex CLIに「feature/fix-bugという名前のブランチを作成してください」と依頼すると、git checkout -b feature/fix-bug を実行してブランチを切り替えてくれます。
変更後は「変更内容を確認してください」と指示すると、git diff が実行され、差分を確認できます。
確認後は「コミットしてください」と依頼して git commit を行い、「GitHubにpushしてください」と伝えると git push が実行されます。
ただし、Codexに任せきりにするのではなく、変更内容を自分の目で確認するのが重要です。AIが生成した変更には意図しない修正が含まれる場合もあるためです。git diff による差分の確認は怠らないようにしましょう。
Issueを起点にした修正作業
GitHubのIssueは、バグ報告や機能の要望などを記録しておく場所です。
このIssueの内容を手がかりにCodex CLIへ作業を依頼するというのは、実際の開発現場でもよく使われるやり方です。
GitHub CLIを使えば、ターミナルからIssueの内容を確認できます。
gh issue view 番号 を実行すると、該当Issueのタイトルや本文が表示されます。
該当するIssueの問題を修正したいなら、その内容をCodex CLIに貼り付けて「このIssueの問題を修正してください」と依頼するだけです。それで、コードの調査と修正が始まります。
「Issue #12に書かれているログイン時のエラーを調査して、原因と修正方法を教えてください」のように、Issue番号と問題の要点を一緒に伝えると、意図に沿った対応をしてもらいやすくなるでしょう。
GitHub CLIとCodex CLIを組み合わせれば、ブラウザを一度も開かずに、Issueの確認から修正までをターミナルの中だけで完結させることも可能です。
PRの作成・確認・レビュー
PRとは、修正したコードをメインのブランチへ取り込んでもらうための申請のことです。Codex CLIとGitHub CLIを組み合わせれば、この申請から内容の確認までをターミナルの中で完結させられます。
ブランチへの変更をpushしたら、gh pr create を実行するとPRを作成できます。
タイトルや説明文の入力を求められますが、そこでCodex CLIに「このブランチの変更内容を参考に、PRの説明文を書いてください」と頼んでみてください。そうすれば、変更内容に沿った文章を用意してくれます。
PR作成後は gh pr diff でコードの差分を確認できます。「このPRの変更に問題がないか確認してください」とCodexに頼めば、レビューの一次チェックも任せられます。
ここで一つ注意したいのは、GitHub上に表示されるCodex Code ReviewはOpenAI（Codexのクラウド版）が提供する機能であり、手元で動くCodex CLIとは別物だという点です。事前に設定しておけばGitHub上でPRを開くと、Codexがクラウド側で自動的にレビューし、その結果をコメントとして投稿してくれます。
ローカルでのレビュー補助はCodex CLIが、GitHub上での自動レビューはCodex Code Reviewが担当する、と役割を分けて覚えておきましょう。
発展的な連携
Codex CLIの基本操作に慣れてきたら、次はGitHub ActionsやMCPサーバーとの連携に挑戦してみましょう。
繰り返し発生する作業を自動化したり、リリース準備を手伝ってもらったりと、より一歩進んだ使い方ができるようになります。
Codex GitHub ActionによるActions連携
openai/codex-action を使うと、GitHub ActionsのワークフローからCodex CLIのcodex execコマンドを実行できるようになります。GitHub Actionsとは、コードのプッシュやPRの作成などをトリガーにして、テストやデプロイといった作業を自動で行える仕組みです。
openai/codex-action をワークフローファイルに組み込めば、PRが作成されたときに自動でコードのレビューコメントを生成したり、指定したプロンプトに基づいてコードを分析させたりできるようになります。
その設定は、GitHubリポジトリの .github/workflows/ ディレクトリにYAMLファイルを追加して行います。これまで手作業で行っていたレビューや確認作業を自動化できれば、開発のスピードも品質も上がるでしょう。
ちなみに、ローカルで使うときとの違いについてもここで説明しておきます。少し発展的な内容になるため、頭の片隅に置いておくだけで構いません。
Codex CLIはローカルのPC上で動くもので、ChatGPTアカウントでログインすれば認証は済んでいました。ところがGitHub Actionsは、GitHub側のサーバー上で自動的に動く仕組みです。
ローカルのPC上でのログイン状態とは関係がないため、「これは正規の利用者からのアクセスです」とOpenAI側に証明するためのAPIキーを、あらかじめGitHub側に渡しておく必要があります。
とはいえ、そのAPIキーをYAMLファイルにそのまま書いてしまうと、リポジトリを見られる人全員に見えてしまい、悪用される危険性があります。そこで使うのが、機密情報を暗号化して保管できるGitHubのSecretsという機能です。ここにAPIキーを登録しておけば、ワークフローの中からは呼び出せるものの、外部からは見えない状態にできます。
GitHub MCP Serverを使ったMCP連携
Codex CLIには、MCPサーバーと接続する機能もあります。GitHub公式のMCP Serverを追加すれば、GitHubのさまざまな機能に直接アクセスできるようになります。MCPとは、AIがいろいろなツールやサービスに接続するための仕組みだと考えてください。
GitHub公式MCP Serverを使うと、Codex CLIからGitHubのリポジトリ情報やIssue、PR、ユーザー情報などをより直接的に扱えるようになります。通常、ローカルで動くCodex CLIはgitやghといったコマンドを個別に実行しない限り、自PC上にあるファイルにしかアクセスできませんが、MCP連携によってGitHub上のデータを扱いやすくなります。
Codex CLIの設定ファイルに、MCPサーバーの接続情報を追加すると設定できます。ただし、MCP連携はやや高度な設定が必要なため、まずは基本的なローカル操作に慣れてから取り組むのがおすすめです。
将来的に、Codex CLIとGitHubをより深く統合したくなったときの有力な選択肢として覚えておきましょう。
Release作業の補助と自動化
コードのリリースに向けた準備作業を、Codex CLIにサポートしてもらうという使い方もできます。
リリース前に必要なテストの実行、変更履歴（CHANGELOG）の整理、バージョン番号の更新確認といった作業を、簡単な言葉でCodexに伝えるだけで済みます。
例えば、下記のように伝えます。
「このリポジトリの変更内容をもとにCHANGELOGを更新してください」
「テストをすべて実行して結果を報告してください」
Codexはターミナルで実際にコマンドを実行しながら結果を返してくれるため、リリース前の最終チェックリストのように活用できます。
さらに、GitHub Actionsと組み合わせれば、例えばmainブランチへのマージのような、ある条件をトリガーに、リリース準備の一部を自動化することも可能です。
何度も発生するリリース作業を自動化すれば、手作業によるミスを防ぎながら、リリースまでにかかる時間も短縮できます。これはかなり大きなメリットです。
よくある質問（Q&A）
Q. Codex CLIは無料で使えますか？
Codex CLIのソフトウェア自体はオープンソースで無料ですが、利用にはOpenAIのAPIキーまたはChatGPTアカウントが必要です。APIキーを使う場合は利用量に応じた料金が発生します。ChatGPT Plusなどの有料プランに加入していれば、そのアカウントでログインして利用できます。
Q. WindowsでもCodex CLIは使えますか？
はい、使えます。現在はWindows上でもネイティブに動作します。Linux向けのツールに依存するプロジェクトであれば、WSL2上で使う方法もあります。ただし環境によって動作が異なる可能性があるため、公式ドキュメントで最新の対応状況を確認してください。
Q. Codex CLIはどのプログラミング言語に対応していますか？
Codex CLIが使用するAIモデルはPython、JavaScript、TypeScript、Ruby、Goなどさまざまな言語に対応しています。特定の言語に限定されるわけではなく、ファイルとして存在するコードであれば読み込んで解析や編集の補助が可能です。
ただし、言語によって精度に差がある場合もあります。
Q. Codex CLIで行った変更は自動的にGitHubに反映されますか？
自動では反映されません。Codex CLIがコードを編集した場合、変更はローカルのファイルに保存されます。GitHubへ反映するには、git add や git commit、git push などのコマンドを実行してください。Codexにこれらの操作を依頼することもできますが、pushの前に必ず変更内容を確認するのをおすすめします。
Q. プライベートリポジトリでもCodex CLIは使えますか？
はい、使えます。プライベートリポジトリも、git clone でローカルに取得してからCodex CLIを起動すれば、公開リポジトリと同じように利用できます。GitHubのプライベートリポジトリへのアクセスにはGitHubの認証が必要なため、事前に gh auth login またはSSH鍵の設定を実施しておきましょう。
まとめ
Codex CLIは、ターミナル上でAIと会話しながらコードの調査や修正、テスト、レビューといった開発全般の作業を進められる強力なツールです。
GitHubと組み合わせれば、ローカルでの作業からGitHubへの反映、さらには自動化まで、開発のあらゆる場面でAIの力を借りられるようになります。
話しかけるように指示を出せるので、プログラミングを学び始めた方にとっても心強い味方になるはずです。
ここで、今回の重要なポイントを振り返りましょう。
重要なポイント
- Codex CLIは、GitHubを操作するツールではなく、ローカルでコードの調査や修正を助けてくれるAIエージェント
- インストールと認証さえ済ませれば、すぐに手元のリポジトリで使い始められる
- IssueやPRとの連携で、開発の流れをターミナルだけで完結できる
- GitHub Actionsとの連携で、レビューやリリース作業を自動化できる
- MCP連携で、GitHubのリポジトリ情報やIssueへ直接アクセスできる
Codex CLIとGitHubを組み合わせれば、効率的かつ学びながら進められる開発スタイルが手に入ります。
まずは環境を整えて、簡単なコードの調査や修正から試してみてください。