Codex CLIの使い方 インストール手順と基本コマンド・承認モードの設定を解説

Codex CLIは、OpenAIが提供するターミナル上で動くコーディングエージェントです。指示を出すとコードを読み、修正し、コマンドを実行するところまで自律的に進めるため、補完中心のツールとは作業の進み方が大きく異なります。

導入自体は数分で終わりますが、実務で安定して使えるかどうかは、承認モードの設定と依頼の出し方にかかっています。既定の設定のまま大きな作業を任せると、想定外の範囲まで変更が及ぶこともあります。

本記事では、Codex CLIの特徴とインストール手順、基本コマンド、承認モードとサンドボックスの考え方、AGENTS.mdによる指示の与え方、実務で使う際のコツと注意点までをまとめました。これから導入する方が最初の設定で迷わない内容にしています。

確認したいポイント	結論	詳細
Codex CLIとは何か？	ターミナルで動く開発エージェント	コードの読み取りから変更、コマンド実行までを指示に沿って自律的に進めます。
補完型ツールとの違いは？	作業そのものを任せられる	人が担うのは依頼内容の決定と、出てきた差分を受け入れるかどうかの判断です。
導入に必要なものは？	対応OSとアカウントのみ	macOSやLinux、WindowsはWSL2で動作し、契約中のアカウントで認証できます。
インストール方法は？	コマンド1行で完了する	パッケージ管理の仕組みか、公式配布のインストーラーのどちらでも導入できます。
使い方は何種類ある？	対話・一度きり・レビュー	やり取りしながら進める形、指示を実行させる形、指摘を出させる形に分かれます。
最初に設定すべきは？	承認モードを慎重な側に	読み取りのみから始め、挙動を把握してから自動化の範囲を広げるのが安全です。
出力を安定させるには？	AGENTS.mdに前提を書く	使用する版、テスト方法、命名規則、触れてはいけない領域を記載しておきます。
業務で使う注意点は？	参照範囲と差分の確認	鍵や接続情報は対象から外し、変更内容は必ず差分とテストで確認します。

この記事でわかること

• Codex CLIの特徴と、補完型のコーディング支援ツールとの違い
• 動作環境の確認からインストール、認証、起動までの具体的な手順
• 対話モード・非対話モード・レビュー用途という3つの使い分け
• 承認モードとサンドボックスの段階、AGENTS.mdでの指示の与え方
• 実務で安定させるコツと、機密情報や生成コードの取り扱いの注意点

開発現場へのAI導入を検討している方へ コーディングエージェントの導入は、ツールを配るだけでは定着しません。ネクストスケールでは、開発フローへの組み込み方の設計から、社内ルールの整備、エンジニア向けの研修までを一貫して支援していますので、まずは無料相談をご利用ください。 ▶ 開発現場のAI活用について相談する

Codex CLIとは？ターミナルで動くコーディングエージェント

最初に、このツールがどのような位置づけにあるのかを整理します。エディタの補完機能とは役割が異なるという点を押さえておくと、使いどころを判断しやすくなります。

補完型ツールとの違い

エディタ上で次の行を提案するタイプのツールは、人が書く作業を横から支えるものでした。Codex CLIは、指示を受けてコードを読み、変更を加え、コマンドを実行し、結果を確認するところまでを一連の流れで進めます。

人が担うのは、依頼の内容を決めることと、出てきた差分を確認して受け入れるかどうかを判断することです。作業そのものよりも、依頼と検収の比重が大きくなります。

ターミナルで動くため、特定のエディタに依存しません。普段使っている開発環境をそのままにして導入できる点は、チームで試すときの利点になります。

自律的に作業を進める仕組みの考え方は、AIエージェントの仕組みと業務への活かし方でも整理しています。

3つの使い方に整理できる

実際の使い方は大きく3種類に分かれます。対話しながら進める形、一度きりの指示を実行させる形、レビューを目的に走らせる形です。

対話形式は、コマンドを実行してターミナル上でやり取りを重ねる基本の使い方です。方針を確認しながら修正を進める場面に向いています。

一度きりの実行は、指示を渡して結果だけを受け取る形式です。自動化のスクリプトや継続的な検証の仕組みに組み込む用途で使われます。

レビュー用途では、変更内容に対して指摘を出させる形で使います。人によるレビューの前段としてかけることで、明らかな漏れを先に拾えます。

3つは排他的なものではありません。日常の開発は対話形式で進めつつ、定型作業だけを一度きりの実行に切り出すという組み合わせが実務では一般的です。

必要な環境と料金の考え方

動作環境はmacOSとLinux、WindowsではWSL2を使う構成が基本です。Node.jsを利用してインストールする場合は、バージョンが要件を満たしているかを先に確認します。

利用にあたっては、ChatGPTのアカウントでログインする方法と、APIキーを設定する方法があります。前者は契約中のプランの枠内で使う形、後者は使った分だけ課金される形です。

継続的な検証の仕組みに組み込む場合は、後者を選ぶ場面が出てきます。料金体系と対象プランは見直されることがあるため、導入前に公式の案内で最新の内容を確認してください。

個人の契約と組織の契約では、利用枠や管理の仕組みが異なります。チームで導入する場合は、契約形態から検討しておくほうが後の整理が楽になります。

関連記事：Codex CLIとは？OpenAI発AIコーディングエージェントの特徴・使い方・料金を解説

インストールと初期設定の手順

ここからは導入の流れです。環境の確認から起動まで、順番に進めれば10分程度で完了します。

手順1：動作環境を確認する

macOSまたはLinuxであればそのまま進められます。Windowsの場合はWSL2を有効にし、その中で作業する構成が確実です。

Node.js経由で導入する場合は、あらかじめバージョンを確認します。古いバージョンではインストールが中断されるため、必要に応じて更新しておきます。

社内のネットワークに通信の制限がある場合は、配布元への接続が許可されているかも先に確認します。制限が原因で導入が進まない事例は少なくありません。

手順2：インストールする

導入方法は複数あります。パッケージ管理の仕組みを使う方法と、公式が配布するインストーラーを実行する方法のどちらでも構いません。

Node.jsの環境がある場合は、npm install -g @openai/codex を実行すれば導入できます。macOSでHomebrewを使っている場合は、そちらから入れる方法も選べます。参考：npm公式パッケージページ（@openai/codex）

導入が終わったら、バージョンを表示するコマンドで正しく入ったかを確認します。更新は定期的に行われるため、動作がおかしいときはまず版を確認する習慣をつけておくと切り分けが早くなります。

手順3：認証を済ませる

ログイン用のコマンドを実行すると、ブラウザが開いて認証画面が表示されます。契約中のアカウントでログインすれば、追加の設定なしで使える状態になります。

APIキーを使う構成にする場合は、環境変数として設定します。自動化の仕組みに組み込む場合はこの方法が前提になるため、鍵の管理方法もあわせて決めておきます。

鍵をソースコードに直接書き込む運用は避けます。リポジトリに含まれてしまうと、外部から利用される危険があります。

手順4：作業ディレクトリで起動する

起動したディレクトリが、参照と変更の対象範囲になります。リポジトリのルートで起動するか、対象を絞ったサブディレクトリで起動するかを意識して選びます。

範囲を広く取ると全体を把握したうえで作業できますが、意図しないファイルに変更が及ぶ可能性も上がります。最初は範囲を絞って試すほうが安全です。

バージョン管理されていないディレクトリでの実行は避けます。変更を元に戻せる状態を確保しておくことが、安心して任せるための前提になります。

関連記事：Claudeのインストール方法|PC・スマホ・Claude Codeの入れ方と初期設定を解説

基本的な使い方と主要コマンド

導入が済んだら、実際の操作に入ります。覚えるコマンドは多くなく、いくつかの基本を押さえれば作業を回せます。

対話モードでの進め方

起動すると対話用の画面が立ち上がり、そこに日本語または英語で依頼を書きます。まず読むだけの作業から始めると、挙動を把握しやすくなります。

具体的には、このリポジトリの構成を説明する、この関数の処理内容を要約するといった依頼から入ります。変更を伴わないため、想定外の結果になっても影響がありません。

挙動が掴めたら、小さな修正を依頼します。計画を提示させ、内容を確認してから実行させる流れにすると、意図とのずれを早い段階で見つけられます。

依頼の書き方は、対象のファイルと期待する結果、満たすべき条件を明示する形が基本です。曖昧な指示ほど、確認と修正のやり取りが増えます。

覚えておきたい操作

セッション中はスラッシュから始まる操作が使えます。設定を初期化する、新しい会話に切り替える、モデルを変更する、会話の履歴を圧縮するといった操作が代表的です。

やり取りが長くなると、扱える文脈の上限に近づいて挙動が不安定になります。区切りのよいところで履歴を整理するか、新しい会話に切り替える運用が有効です。

承認の扱いを切り替える操作も用意されています。作業の性質に応じて途中で変更できるため、最初は慎重な設定にしておき、慣れてから緩める進め方が取れます。

使用するモデルを切り替える操作も覚えておくと便利です。軽い作業と込み入った設計の検討で、使い分けられる場面があります。

非対話モードの使い方

codex exec に続けて指示を書くと、対話せずに一度きりの処理として実行されます。結果を受け取るだけの形式のため、スクリプトから呼び出す用途に向いています。

定型的な作業をこの形式でまとめておくと、毎回同じ手順で実行できます。変更履歴の整理や、決まった形式のドキュメント生成といった作業が対象になります。

自動実行の仕組みに組み込む場合は、承認を求めない設定になる点に注意します。実行される範囲を限定したうえで組み込むことが前提です。

出力を後続の処理で扱う場合は、形式を指定しておきます。決まった形で返させることで、結果を機械的に処理できるようになります。

レビュー用途での使い方

変更内容に対して指摘を出させる使い方も可能です。人によるレビューの前段として通すことで、明らかな漏れや規約違反を先に拾えます。

指摘の内容をそのまま採用するのではなく、確認すべき箇所の候補として扱います。判断そのものは人が行うという前提を崩さないことが重要です。

チームで運用する場合は、どの観点で見させるかを事前に決めておきます。観点が定まっていないと、指摘の粒度が担当者ごとにばらつきます。

開発フローへの組み込み方を設計しませんか コーディングエージェントは、どの工程に置くかで効果が大きく変わります。ネクストスケールでは、現在の開発体制をうかがったうえで、無理なく組み込める形をご提案しています。 ▶ 導入支援サービスの詳細を見る

関連記事：Codex CLIのインストール方法｜Mac・Windows・Linux別の手順と認証・エラー対処

承認モードとサンドボックスの設定

実務で使ううえで最も重要なのがこの設定です。どこまで自動で実行させ、どこから確認を挟むかを決める仕組みにあたります。

承認モードの段階

承認の扱いは段階的に選べます。読み取りのみで提案にとどめる設定、ファイルの編集は自動で行いコマンド実行は確認を求める設定、編集も実行も自動で進める設定という組み立てです。

導入直後は、最も慎重な設定から始めることをおすすめします。どのファイルにどのような変更を加えようとするのかを目で確認しながら進めるほうが、挙動の理解が早まります。

完全に自動で進める設定は、変更を元に戻せる環境が整っている場合に限って使います。バージョン管理下にあり、失敗しても影響が限定される状況が条件です。

設定は途中で切り替えられます。調査の段階は読み取りのみ、実装の段階は編集を自動にするという形で、工程ごとに変える運用も取れます。

サンドボックスの範囲

実行されるコマンドは、既定では作業ディレクトリの範囲に制限されます。その外に影響が及ぶ操作や、外部との通信を伴う操作には確認が入る構成です。

別のディレクトリを参照させたい場合は、対象を明示して追加する方法があります。制限を一括で外すより、必要な範囲だけを開けるほうが安全です。

外部との通信を許可すると、依存関係の取得などが自動で進みます。便利な反面、意図しないパッケージが入る可能性もあるため、許可する場面は限定します。

検証用の環境を用意しておくと、制限を緩めた状態でも安心して試せます。本番に近い環境と実験用の環境を分けておく構成が現実的です。

どの設定を選ぶべきか

判断の目安は、作業の可逆性と対象範囲の広さです。元に戻せる状態で、範囲が限定されているなら自動化を進めても問題は起きにくくなります。

本番環境に接続する設定が含まれるディレクトリでは、慎重な設定を維持します。検証用の環境と作業用のディレクトリを分けておく運用も有効です。

組織として使う場合は、許容する設定の範囲をあらかじめ定めておきます。担当者ごとに判断が分かれる状態は、事故につながりやすくなります。

AGENTS.mdと設定ファイルの書き方

出力の質を安定させるには、あらかじめ前提を書いたファイルを置いておく方法が効果的です。毎回同じ説明を繰り返す手間もなくなります。

AGENTS.mdの役割と置き場所

AGENTS.mdは、会話のたびに自動で読み込まれる指示書のような役割を持つファイルです。プロジェクトの前提やコーディング上の決まりを書いておけます。

利用者ごとの共通設定として置く方法と、リポジトリごとに置く方法があります。全体に効かせたい内容は前者、そのプロジェクト固有の内容は後者に分けると管理しやすくなります。

同名のファイルは他のコーディング支援ツールでも採用が進んでいます。ツールを乗り換えても資産として残る点は、記述に手間をかける価値につながります。

内容は長く書きすぎないほうが機能します。分量が増えるほど重要な指示が埋もれるため、要点を絞って更新し続ける運用が向いています。

書いておくと効果が高い内容

優先度が高いのは、使用している言語やフレームワークの版、テストの実行方法、命名やディレクトリ構成の決まり、触れてはいけない領域の4点です。

テストの実行方法を書いておくと、変更後に自動で検証まで進めてくれます。確認の手数が減るため、実務での効果が最も出やすい項目です。

回答を日本語で返すよう指定しておくことも有効です。チーム内で読み合う場面が多い場合は、言語をそろえておくほうが確認が進みます。

指示文の組み立て方の基本は、プロンプトの書き方でもまとめています。

設定ファイルでの調整

細かい挙動は設定ファイルで調整できます。使用するモデル、既定の承認モード、履歴を圧縮する閾値、外部サービスとの接続などが対象です。

外部のツールやサービスと接続する仕組みにも対応しており、社内の情報を参照させる構成も組めます。接続先を増やすほど、権限の管理は慎重に行う必要があります。

設定はチームで共有できる形にしておくと、環境差による挙動の違いを減らせます。個人ごとの設定と共通の設定を分けて管理する運用が現実的です。

組織として一定の制約をかける仕組みも用意されています。承認の方針や接続先を管理側で定められるため、規模が大きい環境では検討する価値があります。

エンジニア向けのAI研修をご用意しています 設定の意味を理解しないまま使うと、効果が出ないまま利用が止まります。ネクストスケールの研修では、実際のリポジトリを題材にした演習を通じて、開発チームが自走できる状態をつくります。 ▶ 法人向けAI研修の内容を確認する

実務で安定して使うためのコツ

導入しても成果が出ないケースには共通点があります。依頼の粒度と確認の方法を整えることが、安定して使うための条件です。

依頼は小さく分ける

大きな作業をまとめて任せると、変更範囲が広がって確認が追いつかなくなります。1回の依頼で扱う対象を絞り、差分を確認できる大きさに保つことが基本です。

目安としては、人がレビューできる範囲に収まるかどうかで判断します。読み切れない量の差分が出た時点で、依頼の分け方を見直す合図と考えます。

手戻りが起きたときも、範囲が小さければ影響を限定できます。速さより確実さを優先するほうが、結果的に早く進みます。

差分とテストで必ず確認する

作業が終わったら、どのファイルにどのような変更が入ったか、どのコマンドが実行されたかを差分で確認します。動いたという報告だけで受け入れないことが重要です。

テストが用意されている環境であれば、変更後に実行させて結果まで確認します。検証の手順をAGENTS.mdに書いておけば、毎回指示しなくても実行されます。

確認の観点をチームで共有しておくと、レビューの質がそろいます。変更範囲、実行したコマンド、確認できていない点の3つを報告させる形が扱いやすくなります。

チーム全体で使い方の水準をそろえたい場合は、AI研修の選び方と導入手順もあわせてご確認ください。

文脈を整理して渡す

関係のないファイルまで読ませると、判断の材料が散らかって精度が下がります。対象を絞って起動するか、参照すべき範囲を明示するほうが結果は安定します。

やり取りが長くなったら、区切りをつけて新しい会話に切り替えます。前の作業の前提が残ったままだと、意図しない変更が混ざる原因になります。

参照させたいファイルが決まっているなら、依頼の中で名前を挙げます。探させる手間が省け、対象の取り違えも防げます。

作業の記録を残す

ターミナル上のやり取りは、時間が経つと追えなくなります。変更の意図と確認した内容を、コミットや課題管理の仕組みに残しておきます。

AIが作業した箇所ほど、後から経緯を説明できる状態にしておく価値があります。担当者が変わったときの引き継ぎも進めやすくなります。

業務で使う際の注意点

開発の現場で使う以上、扱う情報と生成物の品質について確認が必要です。導入前に整理しておくべき点をまとめます。

コードと機密情報の取り扱い

参照させるディレクトリに、鍵や接続情報が含まれていないかを確認します。環境変数を記載したファイルや認証情報は、参照の対象から外しておくことが前提です。

IPAは、組織向けの脅威として人工知能の利用をめぐるリスクを上位に挙げ、利用者側での対策の必要性を示しています。参考：IPA「AI利用者のためのセキュリティ豆知識」

社内での取り扱い基準の整え方は、生成AI利用時のセキュリティ対策で詳しく解説しています。

生成されたコードの品質確認

動作するコードが出力されても、保守しやすい設計になっているとは限りません。既存の設計方針との整合と、依存関係の妥当性は人が判断します。

追加されたライブラリについては、必要性とライセンスを確認します。自動で導入された依存が、後の運用で問題になる場合があります。

外部から取り込む情報に指示が紛れ込む形の攻撃も想定されています。信頼できない内容をそのまま読ませない運用が必要です。

生成された内容をそのまま統合するのではなく、通常の変更と同じ手順でレビューを通します。作成者がAIであっても、確認の基準は変えません。

チームで使うためのルール

担当者ごとに設定や使い方が異なると、成果物の質にばらつきが出ます。許容する承認モード、参照させてよい範囲、確認の手順を文書化して共有します。

複数のツールを併用する場合は、役割分担も決めておきます。考え方はAIツールの使い分けと選び方で整理しています。

社内で本格的な仕組みを構築する段階に進む場合の検討材料は、AI受託開発の依頼先の選び方と費用相場もあわせてご覧ください。

まとめ

Codex CLIは、ターミナルからコードの読み取り、変更、コマンド実行までを任せられるコーディングエージェントです。導入は環境の確認、インストール、認証、起動という流れで、10分程度あれば使い始められます。

使い方は、対話しながら進める形、一度きりの実行、レビュー用途の3つに整理できます。最初は読むだけの依頼から始め、挙動を把握してから変更を伴う作業に移る進め方が安全です。

実務で安定させる鍵は、承認モードの設定とAGENTS.mdの整備、そして依頼を小さく分けて差分で確認する運用にあります。参照させる範囲と機密情報の扱いを先に決めたうえで、対象を広げていく形が無理のない導入になります。

開発現場のAI活用を成果につなげませんか ネクストスケールは、法人企業向けにAI研修・システム開発・業務改革の支援を提供しています。コーディングエージェントの導入から開発フローへの定着までを伴走します。現状の課題をうかがったうえでご提案しますので、まずはお気軽にご相談ください。 ▶ 無料相談・資料請求はこちら