Claude Codeばかり触っている私ですが、研修で「比較のためにCodexも使ってみたい」と言われることが増えてきました。そこで、非エンジニアの受講者と一緒にゼロから始めてみた手順を、つまずいた箇所も含めて残しておきます。

OpenAI Codexは、OpenAIが出しているコーディング用のAIエージェントです。Claude Codeと同じく、ターミナル(文字でパソコンに命令する画面)で動きます。この記事はCodexの始め方が主役で、Claude Codeは比較対象として出てきます。

ターミナルは、Macなら「ターミナル」アプリ、Windowsなら「PowerShell」や「ターミナル」アプリで開けます。アプリ一覧から探して起動しておいてください。

まずChatGPTのプランを確認する

Codexは単体で契約するのではなく、ChatGPTのプランに紐づいて使えます。だから最初の一歩は、自分のChatGPTアカウントのプランを確認することです。

無料プランでも限定的に試せますが、まともに使うならPlus($20/月)以上が現実的です。料金の全体像は別記事に整理しました。

ここでつまずく人が多いので先に言っておくと、Codex用に別アカウントを作る必要はありません。普段使っているChatGPTのアカウントでそのままログインします。

CLIをインストールする

ターミナルが使える状態なら、インストールはコマンド1行です。npm(プログラムの部品を配布する仕組み)経由で入れます。npmはNode.jsというソフトを入れると一緒に入るので、まだ入っていない人は先にNode.jsを入れておきます。

先ほど開いたターミナルに、次の1行をそのまま打ち込みます。

# npm経由でCodex CLIをインストール
npm install -g @openai/codex

インストールが終わったら、codex と打って起動します。初回はブラウザが開いて、ChatGPTアカウントでのログインを求められます。ここで普段のアカウントでログインすれば準備完了です。

ログインでつまずいたとき

実際にやってみて、一番つまずいたのがログイン周りでした。

ブラウザが自動で開かない、開いても認証後にターミナルへ戻ってこない、という症状です。私の場合、会社のプロキシ(社内ネットワークの中継)が原因でした。個人のネットワークで試し直したらすんなり通った。社内ネットワークで動かないときは、まず個人回線で切り分けるのが早いです。

最初の作業を頼んでみる

起動できたら、いきなり難しいことを頼まず、軽いお願いから始めるのが安全です。私が研修で最初にやらせるのは、こんな頼み方です。

$ codex
> このフォルダにどんなファイルがあるか、一覧と役割を日本語で説明して。

枠のなかの $> は「ここから入力」を示す記号なので、実際に打つのはそのうしろの文字だけです。Codexは「今いる場所のフォルダ」のファイルを見て動くので、自分が作業したいフォルダでターミナルを開いてから起動するのがコツ。

いきなりコードを書かせるのではなく、「読んで説明させる」ところから入る。これでCodexがちゃんと自分のプロジェクトを見られているか確認できます。ここで的外れな返事が返ってきたら、起動した場所(フォルダ)が違う可能性が高い。

Claude Codeとの違いで戸惑った点

Claude Codeに慣れた身として、戸惑った違いを正直に書きます。

設定ファイルの名前が違います。Claude CodeはCLAUDE.mdですが、CodexはAGENTS.mdというファイルにプロジェクトの方針を書きます。中身の考え方は近いので、CLAUDE.mdを書いたことがある人ならすぐ馴染めます。

機能面の細かい違いは、比較記事にまとめています。

両方触ってから選ぶのがいい

2週間ほどCodexを併用してみて思ったのは、「カタログを見て選ぶより、両方少し触って選ぶほうが早い」ということです。

どちらも$20で始められます。1週間ずつ同じ作業をやらせてみて、自分の手になじむほうを残す。最初から1つに決めず、手を動かして比べる。この入り方を研修でも勧めています。

両者の市場での立ち位置は、別記事で整理しました。

まとめ

  • Codexは単体契約ではなくChatGPTのプランに紐づいて使う
  • まともに使うならPlus($20/月)以上が現実的、別アカウントは不要
  • インストールは npm install -g @openai/codex の1行
  • 初回はブラウザでChatGPTログイン。プロキシ環境では個人回線で切り分けると早い
  • 最初は「読んで説明させる」軽い作業で起動を確認する
  • 設定ファイルはCLAUDE.mdではなくAGENTS.md。考え方は近い
  • どちらも$20で始められるので、両方少し触ってから選ぶのが早い