「Codexの使い方がわからない」「インストールしたけど何から始めればいいのか」という声をよく見かけます。Codexは、OpenAIが2025年に公開した、ターミナルで動くオープンソースのコーディングエージェントです。この記事では、基本的な使い方を整理します。
なお、この記事はCodexそのものの使い方を扱っています。Claude Codeとの違いが気になる方はClaude CodeとCodexの違いを参考にしてください。
目次
- Codexとは
- インストール前に確認すること
- インストール手順
- 基本的な使い方・コマンド
- 設定ファイル(config.toml)の基本
- 非エンジニアが使う場合の注意点
- よくある質問
- まとめ
1. Codexとは
Codexは、OpenAIが提供するターミナルベースの自律型コーディングエージェントです。既存のコードベースを読み取り、複数ファイルにまたがる変更を提案したり、設定に応じた権限の範囲内でコマンドを自律的に実行したりできます。CLIツール自体はGitHub上でオープンソースとして公開されていますが、背後で動くAIモデル・API・利用規約はオープンソースではありません。「無料でローカル完結」というわけではなく、利用にはOpenAIのアカウントとネットワーク接続が必要です。
利用方法には、ChatGPTのアカウントでログインして使う方法と、OpenAI APIキーを使って従量課金で使う方法があります。どちらの認証方法になるか、画面上でどのような操作になるかはバージョンによって変わる可能性があるため、初回起動時に表示される案内に従ってください。料金の詳細はCodexの料金プラン完全ガイドで解説しています。
実行の安全性について:「サンドボックス環境で実行される」という説明を見かけますが、これは既定の設定における挙動であり、設定を変更すると実行できる範囲が広がることがあります。非エンジニアの場合、設定はできるだけ既定のままにしておくことをお勧めします(詳しくは6章)。
2. インストール前に確認すること
Codexをインストールする前に、次の点を確認しておくとスムーズです。
- OpenAIのアカウント:ChatGPTのアカウント、またはOpenAI APIキーのいずれかが必要です
- パソコンのOS:Mac・Windows・Linuxに対応しています。Windowsでは、WSL(Windows Subsystem for Linux)の利用が案内される場合があります。ネイティブ環境とWSLで手順が異なる可能性があるため、公式ドキュメントで最新の対応状況を確認してください
- ターミナルの基本操作:Codex CLIはコマンドラインで操作するツールです。フォルダの移動(
cdコマンド)程度の基本操作は、事前に確認しておくことをお勧めします - 試すための空のフォルダ:業務データが入っているフォルダではなく、新しく作った空のフォルダ、またはテスト用にコピーしたフォルダから使い始めてください。最初から重要なファイルがある場所で試すのは避けてください
- バックアップ:試したいフォルダに重要なファイルが含まれる場合は、使い始める前にコピーを取っておいてください。「使ってみたら元に戻せなかった」という事態を防ぐための事前準備です
3. インストール手順
インストール方法は環境によって異なります。代表的な方法は次のとおりです(バージョンやコマンドは更新される可能性があるため、最新の手順は公式リポジトリで確認してください)。
- Node.jsがインストールされていることを確認する
- パッケージマネージャー(npmなど)を使ってCodex CLIをインストールする(
npm install -gのようなコマンドでパソコン全体から使えるようにするのが一般的です。正確なパッケージ名・コマンドは変更される可能性があるため、公式リポジトリの手順を確認してください) - ターミナルで
codexと入力して起動する - 初回起動時の案内に従ってOpenAIのアカウントでログイン(認証)する
Homebrewを使ったインストール方法など、環境ごとに複数の手順が用意されています。うまくインストールできない場合は、公式リポジトリのIssueやドキュメントを確認すると、同じ問題に遭遇した人の情報が見つかることがあります。
4. 基本的な使い方・コマンド
インストールが終わったら、作業したいフォルダに移動してターミナルでcodexと入力すると起動します。起動後は、日本語で指示を入力できます。
このフォルダのコードを読んで、READMEファイルを作成してください
このように、やってほしいことを言葉で伝えると、Codexが必要なファイル操作・コード変更を提案します。コマンドやファイルの変更を実行する前には、承認を求める確認画面が表示されるのが基本的な設計です。内容を確認してから承認するかどうかを判断してください。
5. 設定ファイル(config.toml)の基本
Codexの動作は、設定ファイル(config.toml)で調整できます。使用するモデルの指定や、承認の求め方(自動承認の範囲をどこまで広げるか)といった項目を設定できるのが一般的な設計です。
非エンジニアへの推奨:このファイルを最初から編集する必要はありません。既定の設定のまま使い始めてください。設定ファイルの正確な配置場所(作業フォルダの中か、パソコン全体の共通設定フォルダかなど)はバージョンによって変わる可能性があります。もし作業フォルダの中に設定ファイルを作った場合、その中にAPIキー等を書き込んでしまうと、フォルダをGitHubなどにアップロードした際に一緒に流出する可能性があるため、扱いには注意してください。編集する場合は必ず公式ドキュメントを確認し、変更前の内容をコピーしておくことをお勧めします。
6. 非エンジニアが使う場合の注意点
CodexはOpenAIの公式ドキュメントを見ても分かるとおり、コーディング・ソフトウェア開発を主眼に設計されたツールです。リポジトリ、コミットといった開発の概念に馴染みがない場合、最初のハードルは低くありません。以下の点は、使い始める前に必ず確認してください。
指示した内容に応じてファイルを自動で変更・実行する
Codexのようなエージェントは、指示した内容に応じてファイルの削除・変更・コマンド実行を自律的に行います。プログラミング経験がないと、確認画面に表示されている内容(コマンドやコードの差分)を正しく理解できないまま承認してしまうことが起こり得ます。内容が理解できない場合は、承認せずに操作を中断し、詳しい人に確認してください。「よく分からないが承認する」を避けることが、事故を防ぐ最も基本的な習慣です。特に、curlやwgetのように外部から何かをダウンロードしてそのまま実行しようとするコマンド、sudoのようにパソコン全体に影響する権限を求めるコマンド、大量のファイルを一括削除するコマンドは、内容が分からない場合は承認しないことをお勧めします。
作業内容がOpenAIのサーバーに送信されることを理解する Codexに読み込ませたファイルの内容・入力した指示は、処理のためにOpenAIのサーバーに送信されます。ローカルで完結する処理ではありません。顧客の個人情報・社外秘の情報・パスワードなど、外部に送ってはいけない情報を含むファイルは読み込ませないようにしてください。
APIキー・認証情報を含むファイルを読み込ませない
作業対象のフォルダに、APIキー・パスワード・トークンなどが書かれたファイル(.envファイルなど)が含まれている場合、その内容がAIに読み込まれたり、生成物に含まれてしまったりする可能性があります。こうしたファイルは作業対象から外す、または該当フォルダで作業しないようにしてください。うっかりGitHubなどの公開リポジトリにAPIキーを含むファイルをアップロードしてしまうと、第三者に不正利用され、想定外の高額な請求につながる事故が実際に起こっています。会話の中でAPIキーやパスワードをそのまま入力することも避けてください。
Windowsで利用する場合の注意
WSL(2章)を使う場合、Windows側のファイル(C:ドライブの内容など)にWSL経由でアクセスできる設定になっていることがあります。Codexを実行するフォルダが、意図せずWindows側の重要なファイルにアクセスできる状態になっていないか確認してください。
自動承認の設定を安易に広げない 設定を変更すると、確認なしに実行できる操作の範囲を広げることができますが、非エンジニアの場合はこの設定を変更しないことをお勧めします。既定の「都度確認」の状態のまま使うことが、最も安全な使い方です。
途中で止める・断る 提案された変更に納得できない場合は、承認せずに断って構いません。「一度依頼したら最後までやらせないといけない」ということはありません。ただし、すでに承認して実行が始まった操作は、ツールを終了しても完全には取り消せない場合があります(実行中のコマンドやファイルの変更はそのまま残ることがあります)。判断に迷う場合は、実行前に止めることを優先してください。
本番環境・共有フォルダでは使わない 自分のパソコンの、新しく作った空のフォルダやコピーしたフォルダで試すことをお勧めします(2章)。会社の共有ドライブ、クラウド同期フォルダ(iCloud・OneDriveなど)、本番環境で直接試すのは避けてください。
セキュリティ面のより広い考え方はClaude Codeのセキュリティと企業導入も参考になりますが、Codex固有の設定項目・データの取り扱いについては、必ずOpenAIの公式ドキュメントも確認してください。
よくある質問
Q. Codexは無料で使えますか?
A. Codex単体の無料プランというものはなく、ChatGPTのサブスクリプション(1章)またはOpenAI APIキーでの従量課金のいずれかが必要です。無料の試用枠が用意されているかどうかは変更される可能性があるため、最新情報はOpenAIの公式ページで確認してください。
Q. WindowsでもCodexは使えますか?
A. 対応していますが、環境によって手順や制約が異なる場合があります。公式ドキュメントで最新の対応状況を確認することをお勧めします。
Q. Codexを使うのにプログラミング経験は必要ですか?
A. 必須ではありませんが、公式ドキュメントの多くはエンジニア向けの前提で書かれています。リポジトリやコマンドライン操作に馴染みがない場合は、簡単な操作から少しずつ試すことをお勧めします。
Q. Codexで作業した内容を元に戻すことはできますか?
A. Codexが提案する変更は承認制のため、承認前であれば取り消せます。承認後にファイルを元に戻したい場合は、事前に取ったバックアップやバージョン管理の仕組み(Gitなど)を使うことをお勧めします。
まとめ
- Codexは、OpenAIが公開したターミナル型コーディングエージェント。CLIツール自体はオープンソースだが、背後で動くモデル・API・利用規約はオープンソースではなく、処理内容はOpenAIのサーバーに送信される
- ChatGPTのアカウントまたはOpenAI APIキーで利用でき、インストール後はターミナルで
codexと打って起動する - 動作は設定ファイル(config.toml)で調整できるが、最初は既定の設定のままで十分
- 非エンジニアが使う場合は、確認画面の内容を理解してから承認する習慣、機密情報を読み込ませないこと、影響範囲を限定した環境での試用が重要
料金の詳細はCodexの料金プラン完全ガイド、Claude Codeとの違いはClaude CodeとCodexの違いを参考にしてください。
Claude Codeも同じくターミナルで動く自律型エージェントですが、非エンジニアが段階的に学べる学習コンテンツが複数用意されています。claudecode道場で実践的なClaude Code研修を始める(無料公開中)では、Claude Codeを使ったファイル操作・資料作成などの実務活用を、プログラミング知識なしで学べます。
あわせて読みたい:




