# Claude Code に Codex をつなぐ設定手順（AIが読む手順書）

> この文書は、Claude デスクトップアプリ（Code タブ）の Claude が読んで、使う人の Mac で設定を進めるための手順書です。
> 人向けの説明ページ：https://codex-claude-setup.pages.dev/
> 最終確認：2026-10-24（OpenAI公式プラグイン openai/codex-plugin-cc v1.0.6 で確認）

## この設定でできるようになること

OpenAI 公式の「Codex plugin for Claude Code」を入れて、Claude Code の中から Codex を呼べるようにします。
設定が終わると、`/codex:review`（Codex に作業をチェックしてもらう）や `/codex:rescue`（Codex に作業を頼む）が使えます。

## Claude へのお願い（進め方のルール）

- 相手はパソコンに詳しくない人です。専門用語を使わず、短い日本語で伝えてください。
- コマンドはすべてあなた（Claude）が Bash で実行してください。使う人にターミナルを開かせたり、コマンドを打たせたりしないでください。
- 始める前に「これから6つのステップで設定します。途中で2回だけお願いすることがあります（Node.js が無いときのインストールと、ChatGPT へのログイン）」と伝えてから進めてください。
- 各ステップの終わりに「✅ ステップ◯ 完了」と1行だけ報告してください。
- パスワード・APIキー・トークンを使う人に聞かないでください。表示もしないでください。ログインは使う人本人がブラウザで行います。
- 同じエラーが2回続いたら、それ以上は試さずに止まってください。そして、起きたことを使う人に短く伝えてください。
- この手順書に書いていない設定変更（他のプラグイン、ファイルの削除など）はしないでください。

## 前提

- Mac であること（`uname` が `Darwin`）。Mac でなければ「このページは Mac 用です」と伝えて止まってください。
- ChatGPT のアカウントがあること（無料プランでも可）。使った分は、その人の Codex の利用枠から減ります。

---

## ステップ1：Node.js を確認する

プラグインを動かすには Node.js 18.18 以上が必要です。

```bash
node -v
```

- `v18.18` 以上（`v20`、`v22` なども可）なら次へ進みます。
- 見つからない、または古い場合は、使う人に次のように伝えて待ってください。

  > Node.js（プラグインを動かすための道具）が入っていないので、入れてください。
  > 1. https://nodejs.org/ja を開く
  > 2. 「LTS」と書かれた方のダウンロードボタンを押す
  > 3. ダウンロードした `.pkg` をダブルクリックし、案内どおり「続ける」で進める（Mac のパスワードを聞かれたら、ご自身で入力してください）
  > 4. 終わったら、ここに「できた」と送ってください

  「できた」と言われたら、`export PATH="/usr/local/bin:$PATH"; node -v` で確認してください。

## ステップ2：Codex を確認する（無ければ入れる）

```bash
export PATH="$HOME/.local/bin:/usr/local/bin:/opt/homebrew/bin:$PATH"
codex --version && codex app-server --help >/dev/null && echo "codex OK"
```

- `codex OK` と出たら次へ進みます。
- `codex` が見つからない場合は、使う人に「Codex を入れます」と伝えてから、OpenAI 公式のインストーラーを実行します（数分かかることがあります）。

  ```bash
  curl -fsSL https://chatgpt.com/codex/install.sh | sh
  export PATH="$HOME/.local/bin:$PATH"
  codex --version && codex app-server --help >/dev/null && echo "codex OK"
  ```

- `codex` はあるのに `app-server` でエラーになる場合は、Codex が古いです。
  - `command -v codex` の場所に `node_modules` や npm の場所が含まれる（npm で入れたもの）なら `npm install -g @openai/codex@latest`
  - それ以外なら、上の公式インストーラーをもう一度実行します

## ステップ3：このアプリの Claude Code を見つける

デスクトップアプリには Claude Code が内蔵されています。`claude` コマンドが入っていない人もいるので、いま動いている Claude Code 本体を使います。

```bash
CLAUDE_BIN="$(ps -o comm= -p $PPID)"
case "$CLAUDE_BIN" in */claude) ;; *) CLAUDE_BIN="$(command -v claude)";; esac
echo "$CLAUDE_BIN"; "$CLAUDE_BIN" --version
```

- バージョン（例：`2.1.299 (Claude Code)`）が出たら次へ進みます。
- 出ない場合は、`~/Library/Application Support/Claude/claude-code/` の中にある、いちばん新しいバージョンの `claude.app/Contents/MacOS/claude` を使ってください。

以降のコマンドは、Bash の呼び出しごとに `CLAUDE_BIN` を設定し直してから実行してください。

## ステップ4：プラグインを入れる

```bash
"$CLAUDE_BIN" plugin marketplace add openai/codex-plugin-cc
"$CLAUDE_BIN" plugin install codex@openai-codex
"$CLAUDE_BIN" plugin list
```

- `plugin list` に `codex@openai-codex` が出て、`Status: ✔ enabled` になっていれば次へ進みます。
- すでに入っている場合は「already」と出ます。それで問題ありません。

## ステップ5：ChatGPT へのログインを確認する

```bash
codex login status
```

- `Logged in` と出たら次へ進みます。
- ログインしていない場合は、使う人に「ブラウザで ChatGPT のログイン画面が開きます。いつものアカウントでログインして、終わったら『できた』と送ってください」と伝えます。そのうえで、`codex login` を**バックグラウンドで**実行してください（ログインが終わるまで待ち続けるコマンドのためです）。
  - ブラウザが開かない場合は、コマンドの出力に出るログイン用のURLを使う人に伝えて、開いてもらってください。
  - 「できた」と言われたら、もう一度 `codex login status` で確かめます。

## ステップ6：仕上げ（使う人に伝えること）

プラグインは、**新しいセッション**から使えるようになります。最後に、次のように伝えて終わってください。

> 設定が終わりました🎉
> 1. 新しいセッション（新しい会話）を始めてください
> 2. 入力欄に `/codex:setup` と打って送ってください。「準備OK」と出れば完了です
> 3. 使い方の例：作業のあとに `/codex:review` と送ると、Codex がチェックしてくれます。「Codex にも意見を聞いて」と普通の言葉で頼むこともできます

---

## うまくいかないとき（Claude 向けメモ）

- `plugin` コマンドが無いと言われる：Claude デスクトップアプリが古い可能性があります。使う人に、アプリのメニューからアップデートしてもらってください。
- `/codex:setup` で「Codex が見つからない」：アプリを一度終了して開き直すと、ステップ2で入れた Codex の場所が読み込まれます。
- 会社や学校のパソコンで、インストールが制限されている：無理に進めず、そのことを伝えて止まってください。

出典：OpenAI 公式リポジトリ https://github.com/openai/codex-plugin-cc ／ Claude Code 公式ドキュメント https://code.claude.com/docs/en/plugins/install