Codex の使い方:初心者がインストールから最初の実務タスクを終えるまでの手順

OpenAI Codex は、コードを読み、書き換え、コマンドを実行できる AI コーディングアシスタントです。この記事では、どの入口を選ぶか、どうインストールするか、最初のタスクをどう頼むか、AGENTS.md で使うほど快適にする方法、そして初心者がつまずきやすいポイントを、ゼロからの順番で解説します。

Codex 使い方Codex 入門OpenAI Codex 初心者Codex CLI インストールAGENTS.md 書き方AI コーディング 入門

初めて Codex を開いて「Web サイトを作って」と入力し、よく分からないファイルの山ができあがって、そこで諦めてしまう人は少なくありません。問題はたいていツールではなく使い方にあります。Codex はチャットボットではなく、あなたのパソコンの前に座った新人エンジニアに近い存在です。プロジェクトを読み、ファイルを編集し、コマンドを実行できますが、タスクをはっきり伝え、範囲をきちんと区切ってあげる必要があります。

ステップ1:まず入口を1つ選ぶ

Codex にはいくつかの使い方があります。コマンドライン版(Codex CLI)、エディタ拡張、デスクトップアプリ、そして Web 上からタスクをクラウドに任せる方法です。まったくの初心者なら、デスクトップアプリかエディタ拡張から始めるのがおすすめです。画面が直感的で、どのファイルが変更されたかを確認できます。慣れてきたらコマンドラインに移ると、速度が上がり、まとめて処理するのにも向いています。どの入口でも ChatGPT アカウントでログインでき、裏側は同じ機能です。

ステップ2:実際のプロジェクトの中で開く

空のフォルダで「ゼロから大きなシステムを作って」と頼むのはやめましょう。よい始め方は、手元にある実際の小さなプロジェクトを1つ選ぶことです。静的な Web ページ1枚でも、Excel を処理するスクリプトでも構いません。そのディレクトリで Codex を起動すると、まずディレクトリ構成を読み、それから指示に沿って作業します。最初は「このプロジェクトは何をするもの?どうやって動かすの?」と聞いてみて、正しく理解しているか確かめるとよいでしょう。

ステップ3:最初のタスクは小さく、検証できるものに

よい最初のタスクはこんな形です。「トップページのタイトルを XXX に変えて、変更後にローカルサーバーを起動し、どのアドレスにアクセスすれば確認できるか教えて」。範囲が小さい、結果がすぐ見える、検証の手順が含まれている、という3つの特徴があります。正しく変更されたことを確認してから、次のタスクを渡しましょう。一度に10個頼むより、1つずつ進めるほうが成功率はずっと高くなります。

ステップ4:AGENTS.md でプロジェクトを覚えさせる

毎回「pnpm を使っている」「テストコマンドは npm test」「config ディレクトリは触らないで」と繰り返すのは大変です。Codex はプロジェクトのルートにある AGENTS.md を読み込むので、プロジェクトの決まりごとを書いておけば、起動するたびにそれに従います。実用的な AGENTS.md に必要なのは、依存関係のインストール方法、実行方法、テスト方法、触ってはいけないディレクトリ、コードスタイルの要件くらいです。まず Codex に下書きを作らせて、それを自分で手直しするのも手です。

ステップ5:権限と承認をすべて開放しない

Codex には、ファイルの変更やコマンドの実行前に確認を求めさせることができます。最初は確認をオンにしたまま、各ステップで何をしようとしているかを見るのがおすすめです。学びにもなり、誤操作も防げます。このプロジェクトでの振る舞いに確信が持てるようになってから、少しずつ緩めていきましょう。また、タスクを始める前に Git で一度コミットしておけば、壊してもいつでも戻せます。これは AI コーディングを使いこなすための一番安い保険です。

初心者がはまりやすい4つの落とし穴

1つ目は、タスクが大きすぎること。一言でプロダクト全体を作らせようとして、途中で方向がずれてしまいます。2つ目は、何が変更されたかを確認せずにそのまま使い、問題がどんどん積み重なること。3つ目は、エラーが出たときに「動かない」とだけ伝え、エラーメッセージを貼らないこと。4つ目は、AGENTS.md を書かず、毎回の会話がゼロからのスタートになること。この4つを避けるだけで、Codex はぐっと使いやすくなります。

パソコンの基礎、インストールと設定から、CLI、MCP、Skills、チームでのワークフローまで順番に体系立てて学びたい方は、ゼロから始める Codex をご覧ください(講座は中国語です)。最初の8講は無料で、ログインなしで視聴できます。AGENTS.md の書き方をさらに知りたい方は、AGENTS.md:プロジェクトの決まりごとをファイルに書く もあわせてどうぞ。