2025年8月31日日曜日

OpenAI Codex CLI

Codex CLIとは？

Codex CLIは、あなたのローカル開発環境と連携し、AIと一緒にコードを書いたり、バグを直したり、プロジェクトを理解するのを助けてくれるターミナルベースのAIコーディングアシスタントです。

ファイルの読み取り・編集・実行が可能
ターミナルでインタラクティブに操作
コード修正、CIの修復、新機能の追加までサポート
GPT-5ベースで強力な推論を利用

🚀 導入手順

1. Codex CLIのインストール

npm か Homebrew でインストールできます：


# npm の場合
npm install -g @openai/codex

# macOS の場合（Homebrew）
brew install codex

2. Codexを起動


codex

初回起動時にChatGPTのアカウントでログインすることが推奨されます（Plus/Pro/Team/Enterpriseユーザー向け）。

🧑‍💻 Codex CLIの基本的な使い方

Codex CLIを使うと、こんなことができます：

✅ 例：CIエラーを修正したい


codex exec "fix the CI failure"

✅ 例：ファイル内のバグを修正


codex
> fix the bug in index.js where the login always fails

✅ 例：特定機能を実装


codex
> create a REST API endpoint to get karaoke room availability

🔐 アクセスモード（Approval Modes）

Codex CLIは3つのモードで動作可能です：

モード	特徴
✅ Auto（デフォルト）	カレントディレクトリ内のファイル読み取り・編集・コマンド実行を自動で許可
🕵️‍♂️ Read Only	読み取り専用。変更やコマンド実行は不可（計画や相談に便利）
⚠️ Full Access	ネットワーク含む全操作が自動許可。注意して使用！

変更方法：


/approvals auto       # 自動許可
/approvals readonly   # 読み取り専用
/approvals full       # フルアクセス（危険）

🧠 モデルと推論レベル

CodexではGPT-5を使用するのが推奨されています。

推論レベルの変更：


/model high       # 複雑なタスク向け
/model medium     # デフォルト

🔄 アップデート方法


# npm の場合
npm install -g @openai/codex@latest

# Homebrew の場合
brew upgrade codex

📦 よく使うプロンプト例集（テンプレート）

目的	プロンプト例
🔧 バグ修正	`fix the login issue in LoginForm.tsx`
🔨 新機能	`add a logout endpoint in the API`
📋 ドキュメント生成	`add JSDoc comments to all functions in utils.js`
📈 パフォーマンス改善	`optimize the search query in Postgres for large datasets`
🧪 テスト追加	`write unit tests for orderService using Jest`

❓ よくある質問

Q. Windowsで使える？

公式にはmacOSとLinuxをサポート。WindowsではWSL経由で使用を推奨。

Q. APIキーでも使える？

はい。ただしAPIベースの認証には追加設定が必要。基本的にはChatGPTのサブスクリプションアカウントでの利用が簡単。

📚 詳細ドキュメント・ソースコード

GitHub: https://github.com/openai/codex
ドキュメントやカスタム設定、MCP連携についての情報もあり。

Mobile Study