Codexの基本的な使い方とClaude Codeとの違い｜コマンド・設定・併用方法を解説【2026年版】

Codexの使い方は、Claude Codeを使ったことがある人なら難しくありません。プロジェクトのフォルダで起動し、自然言語で調査・実装・テストを頼む流れはよく似ています。

実際、両者には/model、/permissions、/compact、/mcp、/statusなど、同じ名前のコマンドが数多くあります。しかし、プロジェクト指示はCodexがAGENTS.md、Claude CodeがCLAUDE.mdを使い、設定ファイルや権限管理の考え方にも違いがあります。

この記事では、Codex CLIの基本操作を押さえたうえで、Claude Codeと併用するときに迷いやすいポイントを具体例つきで整理します。

スポンサーリンク

Codexとは？

Codexは、OpenAIが提供するソフトウェア開発向けのAIエージェントです。ターミナルで動くCodex CLIでは、リポジトリの調査、ファイル編集、コマンド実行、テスト、コードレビューまでを会話形式で依頼できます。

この記事で扱うのは主にCodex CLIです。Codexにはデスクトップアプリ、IDE拡張、クラウドなど複数の利用画面がありますが、Claude Codeに最も近い操作感なのはターミナル版です。OpenAIの公式説明でも、Codex CLIはローカルリポジトリを調べ、編集し、既存ツールを実行できるターミナル向けエージェントとして案内されています。

Claude Code経験者が使いやすい理由

両者は「チャットにコードを書かせるツール」というより、作業環境を確認しながら自律的に手順を進めるエージェントです。基本のサイクルは共通しています。

1. プロジェクトのファイルを読む
2. 変更方針を考える
3. 必要なファイルを編集する
4. テストやリンターを実行する
5. 結果を報告する

そのため、Claude Codeで「このエラーの原因を調べて」「実装前に計画を出して」「変更後にテストして」と依頼している人は、ほぼ同じ頼み方をCodexでも使えます。

Codexの基本的な使い方

1. Codex CLIをインストールする

macOSまたはLinuxでは、公式のスタンドアロンインストーラーを利用できます。

curl -fsSL https://chatgpt.com/codex/install.sh | sh

WindowsではPowerShell用インストーラーが用意されています。npmやHomebrewを使う方法もあります。

# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

# npmを使う場合
npm install -g @openai/codex

# Homebrewを使う場合
brew install --cask codex

インストール方法は更新されることがあるため、実行前にCodex CLI公式ページも確認してください。

2. プロジェクトでCodexを起動する

対象のプロジェクトへ移動して、codexを実行します。初回起動時はChatGPTアカウントなど、表示された方法でログインします。

cd /path/to/your-project
codex

起動後は、やりたいことを日本語で入力するだけです。最初は、変更を伴わない調査から試すと安全です。

このプロジェクトの構成と、起動方法を説明してください。
まだファイルは変更しないでください。

3. 具体的なゴールと確認方法を伝える

「ログイン画面を直して」だけでも動きますが、対象・期待結果・検証方法まで伝えると精度が上がります。

ログイン失敗時に画面が白くなる問題を修正してください。

条件:
- 原因を先に特定する
- 既存のエラー表示デザインを使う
- 修正後に関連テストを実行する
- 最後に変更ファイルとテスト結果を報告する

4. 最初に覚えたいスラッシュコマンド

5. 安全な基本ワークフロー

6. codex execで非対話実行する

対話画面を開かず、スクリプトやCIから実行したい場合はcodex execを使います。

codex exec "リポジトリ構成を要約し、リスクが高い箇所を5つ挙げてください"

公式ドキュメントによると、codex execは標準では読み取り専用サンドボックスで動作します。ファイル編集が必要な自動処理では、実行環境を確認したうえで--sandbox workspace-writeを明示します。

CodexとClaude Codeの共通点・違い

両者は操作感が近い一方、永続設定の置き場所とコマンドの細かな意味が異なります。まずは全体像を比較します。

最大の違いはAGENTS.mdとCLAUDE.md

Codexは作業開始前にAGENTS.mdを読みます。グローバル設定からプロジェクトルート、現在の作業ディレクトリまでを順に探索し、現在地に近い指示ほど後から連結されるため優先されます。AGENTS.override.mdを使った上書きも可能です。

Claude CodeはCLAUDE.mdを使います。ユーザー共通の~/.claude/CLAUDE.md、プロジェクトのCLAUDE.mdまたは.claude/CLAUDE.md、個人用のCLAUDE.local.mdなどを読み込みます。

CLAUDE.mdの設計を詳しく知りたい方は、CLAUDE.mdの書き方完全ガイドも参考にしてください。

設定ファイルはTOMLとJSON

Codexの個人設定は~/.codex/config.toml、プロジェクト設定は.codex/config.tomlです。モデル、承認ポリシー、サンドボックス、MCPなどを設定できます。プロジェクト設定は、信頼したプロジェクトでのみ読み込まれます。

# .codex/config.toml の例
sandbox_mode = "workspace-write"
approval_policy = "on-request"

Claude CodeはJSON形式です。チーム共有は.claude/settings.json、端末固有の設定は.claude/settings.local.jsonに分けられます。権限、環境変数、Hooks、プラグインなどを設定できます。

Claude Code側の設定例は、Claude Codeのsettings.json完全ガイドで詳しく紹介しています。

同名コマンドでも動作は同じとは限らない

バージョンやプランによって表示されるコマンドは変わることがあります。暗記するより、セッション内で/を入力して候補を確認するのが確実です。

権限管理の設計思想が違う

Codexは、ファイルやネットワークへどこまでアクセスできるかを決めるサンドボックスと、サンドボックス外の操作をいつ確認するか決める承認ポリシーを分けて考えます。

Claude Codeでは、permission modeとツール単位のallow・ask・denyルールが中心です。たとえば、テストコマンドは許可し、.envの読み取りや危険なコマンドは拒否する、といった指定ができます。

どちらも「確認を減らせば便利」というだけではありません。対象リポジトリ、扱う秘密情報、コマンドの影響範囲を見て、必要最小限の権限にすることが基本です。

CodexとClaude Codeをハイブリッドで使う方法

共通ルールをAGENTS.mdにまとめる

2つを併用するなら、同じルールをAGENTS.mdとCLAUDE.mdへ重複して書くより、共通部分を1か所にまとめる方が保守しやすくなります。

おすすめは、AGENTS.mdを共通ルールの本体にして、Claude CodeのCLAUDE.mdから読み込む構成です。

AGENTS.mdには、両方のエージェントに守ってほしいルールを書きます。

# Repository Guidelines

## Commands
- Install dependencies with `pnpm install`.
- Run `pnpm lint` and `pnpm test` after code changes.

## Development rules
- Reuse existing components before adding a new one.
- Do not edit generated files directly.
- Never commit `.env` files or credentials.

## Completion criteria
- Report changed files and verification results.
- Mention any test that could not be run.

CLAUDE.mdでは最初に共通ルールを読み込み、その下へClaude Code固有の内容だけを追加します。

@AGENTS.md

## Claude Code specific
- Use plan mode before changes spanning multiple packages.
- Put personal machine settings in `.claude/settings.local.json`.

この方法はAnthropicの公式ドキュメントでも案内されています。シンボリックリンクも使えますが、Claude Code固有ルールを追加でき、Windowsでも扱いやすいインポート方式が実用的です。

ツール固有の設定は混ぜない

AGENTS.mdには「何を守るか」を書き、権限やMCPなどの機械的な設定は各ツールの設定ファイルへ分けます。

1つを実装担当、もう1つをレビュー担当にする

最も始めやすい併用方法は、同じファイルを同時に編集させるのではなく、役割を分けることです。

作業内容で使い分ける

どちらが常に優れているかではなく、利用できるモデル、契約プラン、既存の設定、作業内容で選ぶのが現実的です。

• 普段の実装: 対象プロジェクトで設定が整っている方を使う
• 難しい設計: 両方に独立して案を出させ、前提とトレードオフを比較する
• コードレビュー: 実装に使っていない方をセカンドレビューに使う
• 自動処理: Codexはcodex exec、Claude Codeはclaude -pでスクリプトへ組み込む
• MCP連携: 同じサーバーを使う場合も、接続設定と認証はそれぞれで確認する

よくある質問

まとめ

Codexの基本的な使い方は、プロジェクトでcodexを起動し、自然言語で調査・編集・テストを依頼することです。Claude Codeと操作感は近く、/modelや/compactなど共通するコマンドも多いため、すでにClaude Codeを使っている人なら短時間で慣れられます。

一方で、AGENTS.mdとCLAUDE.md、config.tomlとsettings.json、権限管理、同名コマンドの動作には違いがあります。名前が同じだから同じ設定だと思い込まないことが大切です。

ハイブリッド運用では、共通ルールをAGENTS.mdへ集約し、Claude CodeのCLAUDE.mdから読み込む構成が管理しやすい方法です。実装とレビューで役割を分ければ、作業の衝突を避けながら異なるモデルの視点を活用できます。

参考にした公式情報

• OpenAI: Codex CLI
• OpenAI: Codex CLI slash commands
• OpenAI: Custom instructions with AGENTS.md
• OpenAI: Codex config basics
• OpenAI: Codex non-interactive mode
• Anthropic: Claude Code Quickstart
• Anthropic: Claude Code Commands
• Anthropic: CLAUDE.md and memory
• Anthropic: Claude Code settings