How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

start-0-6 - Prompt - OpenSmartRoute

Name: start-0-6
Author: minicoohei

Prompt file imported from minicoohei/ai-agent-camp (.cursor/commands/lesson/start-0-6.md). Copyright stays with the author.

Lesson 0-6: Codex CLI セットアップ

セットアップ進捗の確認

AIが自動実行: uv run python tools/setup_progress.py show を実行して現在のセットアップ進捗を表示する。

このセッションでやること

項目	内容
ゴール	Codex CLI をインストール・認証し、ai-agent-camp でレッスンを実行できる状態にする
所要時間	約15分
前提条件	Node.js 18以上、OpenAI APIキーを取得済み
教材ページ	コース教材トップを並行参照

ヒント: このレッスンは Codex CLI ユーザー向けです。Cursor ユーザーは Lesson 0-1 から始めてください。

Step 1: Codex CLI のインストール

Codex CLI は npm でインストールします。ターミナルで以下を実行してください（ターミナルの開き方がわからない場合はターミナル入門ガイドを参照）:

推奨: npx で直接実行（インストール不要）

npx @openai/codex --version

npx を使えばグローバルインストールなしで最新版を実行できます。

代替: グローバルインストール

nvm や fnm を使っている場合は sudo 不要です:

npm install -g @openai/codex
codex --version

注意: Node.js 18以上が必要です。node --version で確認してください。権限エラーが出る場合は、npm 公式ガイドを参照して prefix を変更してください。sudo npm install -g は推奨されません。

Step 2: 認証（OpenAI API キー）

Codex CLI は OpenAI API キーで認証します。以下のいずれかの方法で設定してください:

方法A: credential_manager を使用（推奨）

tools/credential_manager.py を使うと、APIキーを安全に管理できます:

uv run python tools/credential_manager.py store OPENAI_API_KEY

プロンプトに従ってキーを入力すると、暗号化されたキーストアに保存されます。

方法B: 環境変数で設定

export OPENAI_API_KEY="your-api-key-here"

.bashrc や .zshrc に追記すると永続化できます。

方法C: .env ファイルで設定（fallback）

上記の方法が使えない場合のみ、ai-agent-camp リポジトリの .env に以下を追加:

OPENAI_API_KEY=your-api-key-here

セキュリティ警告: .env ファイルには秘密情報が含まれます。絶対に Git にコミットしないでください。 .gitignore に .env が含まれていることを必ず確認してください。誤ってコミットすると、APIキーが漏洩するリスクがあります。

Step 3: ランタイム設定

Codex CLI の推奨設定は以下の通りです:

Codex CLI の承認モードは -a（--ask-for-approval）で指定します:

承認モード	説明
`on-request`	モデルがユーザー承認を求めるタイミングを自動判断する（学習時の推奨）
`never`	確認なしで自動実行（上級者向け、非推奨）

起動コマンド例:

codex -a on-request

重要: サンドボックスは Codex が自動管理します。詳細な設定は AGENTS.md の推奨設定に従ってください。never モードは通常の学習フローでは使用しないでください。詳しくは docs/codex-safety.md を参照。

Step 4: Codex でのレッスン実行方法

Cursor では /start-0-1 のようなスラッシュコマンドでレッスンを開始しますが、Codex CLI では代わりに スキル を使います。

スラッシュコマンドとスキルの対応表

Cursor コマンド	Codex での方法
`/overview`	`aiagent-guide` スキルを使用
`/check-setup`	`aiagent-check-setup` スキルを使用
`/start-0-1`	`aiagent-lesson-runner` スキルで `start-0-1` を指定
`/setup-security`	`aiagent-tooling-setup` スキルを使用

使い方

Codex CLI を起動し、以下のように依頼してください:

aiagent-lesson-runner スキルを使って start-0-1 レッスンを開始してください

または:

start-0-1 のレッスンを始めたい

Codex は AGENTS.md と skills/ ディレクトリを自動的に認識し、適切なスキルを使用します。

Step 5: 動作確認

以下の手順で Codex CLI が正しく動作するか確認します:

ai-agent-camp ディレクトリで Codex を起動:
```
cd /path/to/ai-agent-camp
codex
```

リポジトリのフック設定を確認:

bash scripts/install_hooks.sh を実行してください

セットアップ確認スキルを実行:

aiagent-check-setup スキルで環境を確認してください

期待される出力例

環境チェックレポート
| 項目        | 状態 | 詳細            |
|------------|------|----------------|
| Node.js    | OK   | 22.x           |
| Codex CLI  | OK   | 1.x.x          |
| OpenAI API | OK   | 認証済み         |
| Git        | OK   | 2.x            |
| Hooks      | OK   | pre-commit 設定済み |

よくあるトラブル

codex: command not found → npx @openai/codex で直接実行するか、npm install -g @openai/codex を再実行
API認証エラー → OPENAI_API_KEY が正しく設定されているか確認
パーミッションエラー → nvm/fnm を使用するか、npm prefix の変更で対処
スキルが見つからない → ai-agent-camp のルートディレクトリで Codex を起動しているか確認

チェックポイント

Codex CLI がインストールされている（codex --version が動作する）
OpenAI API キーが設定されている
承認モードを on-request に設定している（AGENTS.md の推奨設定を参照）
bash scripts/install_hooks.sh でフックが設定されている
aiagent-check-setup スキルが正常に動作する

次のステップ

Codex CLI のセットアップが完了したら、レッスンを開始できます。

Codex ユーザーの推奨フロー:

セットアップ確認: aiagent-lesson-runner スキルで start-0-1（環境セットアップ確認）を実行
本格レッスン開始: aiagent-lesson-runner スキルで start-1-1（Module 1 バナー生成入門）を開始
各レッスンのスラッシュコマンドはスキル経由で実行
困ったら aiagent-guide スキルで全体像を確認

補足: .cursor/commands/lesson/ 内のレッスンファイルは Codex でも参照資料として利用できます。ただし、スラッシュコマンドとして直接実行することはできません。

Install start-0-6 and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

# Lesson 0-6: Codex CLI セットアップ ## セットアップ進捗の確認 **AIが自動実行:** `uv run python tools/setup_progress.py show` を実行して現在のセットアップ進捗を表示する。 --- ## このセッションでやること | 項目 | 内容 | |------|------| | ゴール | Codex CLI をインストール・認証し、ai-agent-camp でレッスンを実行できる状態にする | | 所要時間 | 約15分 | | 前提条件 | Node.js 18以上、OpenAI APIキーを取得済み | | 教材ページ | [コース教材トップ](https://ai-agent.camp/ja/course/module-0) を並行参照 | > **ヒント**: このレッスンは Codex CLI ユーザー向けです。Cursor ユーザーは Lesson 0-1 から始めてください。 --- ## Step 1: Codex CLI のインストール Codex CLI は npm でインストールします。ターミナルで以下を実行してください（ターミナルの開き方がわからない場合は [ターミナル入門ガイド](../../../docs/terminal-guide.md) を参照）: **推奨: npx で直接実行（インストール不要）** ```bash npx @openai/codex --version ``` npx を使えばグローバルインストールなしで最新版を実行できます。 **代替: グローバルインストール** nvm や fnm を使っている場合は sudo 不要です: ```bash npm install -g @openai/codex codex --version ``` > **注意**: Node.js 18以上が必要です。`node --version` で確認してください。 > 権限エラーが出る場合は、[npm 公式ガイド](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally) を参照して prefix を変更してください。`sudo npm install -g` は推奨されません。 --- ## Step 2: 認証（OpenAI API キー） Codex CLI は OpenAI API キーで認証します。以下のいずれかの方法で設定してください: ### 方法A: credential_manager を使用（推奨） `tools/credential_manager.py` を使うと、APIキーを安全に管理できます: ```bash uv run python tools/credential_manager.py store OPENAI_API_KEY ``` プロンプトに従ってキーを入力すると、暗号化されたキーストアに保存されます。 ### 方法B: 環境変数で設定 ```bash export OPENAI_API_KEY="your-api-key-here" ``` `.bashrc` や `.zshrc` に追記すると永続化できます。 ### 方法C: .env ファイルで設定（fallback）上記の方法が使えない場合のみ、ai-agent-camp リポジトリの `.env` に以下を追加: ```dotenv OPENAI_API_KEY=your-api-key-here ``` > **セキュリティ警告**: `.env` ファイルには秘密情報が含まれます。**絶対に Git にコミットしないでください。** `.gitignore` に `.env` が含まれていることを必ず確認してください。誤ってコミットすると、APIキーが漏洩するリスクがあります。 --- ## Step 3: ランタイム設定 Codex CLI の推奨設定は以下の通りです: Codex CLI の承認モードは `-a`（`--ask-for-approval`）で指定します: | 承認モード | 説明 | |-----------|------| | `on-request` | モデルがユーザー承認を求めるタイミングを自動判断する（学習時の推奨） | | `never` | 確認なしで自動実行（上級者向け、非推奨） | 起動コマンド例: ```bash codex -a on-request ``` > **重要**: サンドボックスは Codex が自動管理します。詳細な設定は `AGENTS.md` の推奨設定に従ってください。`never` モードは通常の学習フローでは使用しないでください。詳しくは `docs/codex-safety.md` を参照。 --- ## Step 4: Codex でのレッスン実行方法 Cursor では `/start-0-1` のようなスラッシュコマンドでレッスンを開始しますが、Codex CLI では代わりに **スキル** を使います。 ### スラッシュコマンドとスキルの対応表 | Cursor コマンド | Codex での方法 | |----------------|---------------| | `/overview` | `aiagent-guide` スキルを使用 | | `/check-setup` | `aiagent-check-setup` スキルを使用 | | `/start-0-1` | `aiagent-lesson-runner` スキルで `start-0-1` を指定 | | `/setup-security` | `aiagent-tooling-setup` スキルを使用 | ### 使い方 Codex CLI を起動し、以下のように依頼してください: ```text aiagent-lesson-runner スキルを使って start-0-1 レッスンを開始してください ``` または: ```text start-0-1 のレッスンを始めたい ``` Codex は `AGENTS.md` と `skills/` ディレクトリを自動的に認識し、適切なスキルを使用します。 --- ## Step 5: 動作確認以下の手順で Codex CLI が正しく動作するか確認します: 1. **ai-agent-camp ディレクトリで Codex を起動**: ```bash cd /path/to/ai-agent-camp codex ``` 2. **リポジトリのフック設定を確認**: ```text bash scripts/install_hooks.sh を実行してください ``` 3. **セットアップ確認スキルを実行**: ```text aiagent-check-setup スキルで環境を確認してください ``` --- ## 期待される出力例 ```text 環境チェックレポート | 項目 | 状態 | 詳細 | |------------|------|----------------| | Node.js | OK | 22.x | | Codex CLI | OK | 1.x.x | | OpenAI API | OK | 認証済み | | Git | OK | 2.x | | Hooks | OK | pre-commit 設定済み | ``` ## よくあるトラブル - `codex: command not found` → `npx @openai/codex` で直接実行するか、`npm install -g @openai/codex` を再実行 - API認証エラー → `OPENAI_API_KEY` が正しく設定されているか確認 - パーミッションエラー → nvm/fnm を使用するか、[npm prefix の変更](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally) で対処 - スキルが見つからない → ai-agent-camp のルートディレクトリで Codex を起動しているか確認 --- ## チェックポイント - [ ] Codex CLI がインストールされている（`codex --version` が動作する） - [ ] OpenAI API キーが設定されている - [ ] 承認モードを `on-request` に設定している（AGENTS.md の推奨設定を参照） - [ ] `bash scripts/install_hooks.sh` でフックが設定されている - [ ] `aiagent-check-setup` スキルが正常に動作する --- ## 次のステップ Codex CLI のセットアップが完了したら、レッスンを開始できます。 **Codex ユーザーの推奨フロー:** 1. セットアップ確認: `aiagent-lesson-runner` スキルで `start-0-1`（環境セットアップ確認）を実行 2. 本格レッスン開始: `aiagent-lesson-runner` スキルで `start-1-1`（Module 1 バナー生成入門）を開始 3. 各レッスンのスラッシュコマンドはスキル経由で実行 4. 困ったら `aiagent-guide` スキルで全体像を確認 > **補足**: `.cursor/commands/lesson/` 内のレッスンファイルは Codex でも参照資料として利用できます。ただし、スラッシュコマンドとして直接実行することはできません。

{ "prompt": "# Lesson 0-6: Codex CLI セットアップ\n\n## セットアップ進捗の確認\n\n**AIが自動実行:** `uv run python tools/setup_progress.py show` を実行して現在のセットアップ進捗を表示する。\n\n---\n\n## このセッションでやること\n\n| 項目 | 内容 |\n|------|------|\n| ゴール | Codex CLI をインストール・認証し、ai-agent-camp でレッスンを実行できる状態にする |\n| 所要時間 | 約15分 |\n| 前提条件 | Node.js 18以上、OpenAI APIキーを取得済み |\n| 教材ページ | [コース教材トップ](https://ai-agent.camp/ja/course/module-0) を並行参照 |\n\n> **ヒント**: このレッスンは Codex CLI ユーザー向けです。Cursor ユーザーは Lesson 0-1 から始めてください。\n\n---\n\n## Step 1: Codex CLI のインストール\n\nCodex CLI は npm でインストールします。ターミナルで以下を実行してください（ターミナルの開き方がわからない場合は [ターミナル入門ガイド](../../../docs/terminal-guide.md) を参照）:\n\n**推奨: npx で直接実行（インストール不要）**\n\n```bash\nnpx @openai/codex --version\n```\n\nnpx を使えばグローバルインストールなしで最新版を実行できます。\n\n**代替: グローバルインストール**\n\nnvm や fnm を使っている場合は sudo 不要です:\n\n```bash\nnpm install -g @openai/codex\ncodex --version\n```\n\n> **注意**: Node.js 18以上が必要です。`node --version` で確認してください。\n> 権限エラーが出る場合は、[npm 公式ガイド](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally) を参照して prefix を変更してください。`sudo npm install -g` は推奨されません。\n\n---\n\n## Step 2: 認証（OpenAI API キー）\n\nCodex CLI は OpenAI API キーで認証します。以下のいずれかの方法で設定してください:\n\n### 方法A: credential_manager を使用（推奨）\n\n`tools/credential_manager.py` を使うと、APIキーを安全に管理できます:\n\n```bash\nuv run python tools/credential_manager.py store OPENAI_API_KEY\n```\n\nプロンプトに従ってキーを入力すると、暗号化されたキーストアに保存されます。\n\n### 方法B: 環境変数で設定\n\n```bash\nexport OPENAI_API_KEY=\"your-api-key-here\"\n```\n\n`.bashrc` や `.zshrc` に追記すると永続化できます。\n\n### 方法C: .env ファイルで設定（fallback）\n\n上記の方法が使えない場合のみ、ai-agent-camp リポジトリの `.env` に以下を追加:\n\n```dotenv\nOPENAI_API_KEY=your-api-key-here\n```\n\n> **セキュリティ警告**: `.env` ファイルには秘密情報が含まれます。**絶対に Git にコミットしないでください。** `.gitignore` に `.env` が含まれていることを必ず確認してください。誤ってコミットすると、APIキーが漏洩するリスクがあります。\n\n---\n\n## Step 3: ランタイム設定\n\nCodex CLI の推奨設定は以下の通りです:\n\nCodex CLI の承認モードは `-a`（`--ask-for-approval`）で指定します:\n\n| 承認モード | 説明 |\n|-----------|------|\n| `on-request` | モデルがユーザー承認を求めるタイミングを自動判断する（学習時の推奨） |\n| `never` | 確認なしで自動実行（上級者向け、非推奨） |\n\n起動コマンド例:\n\n```bash\ncodex -a on-request\n```\n\n> **重要**: サンドボックスは Codex が自動管理します。詳細な設定は `AGENTS.md` の推奨設定に従ってください。`never` モードは通常の学習フローでは使用しないでください。詳しくは `docs/codex-safety.md` を参照。\n\n---\n\n## Step 4: Codex でのレッスン実行方法\n\nCursor では `/start-0-1` のようなスラッシュコマンドでレッスンを開始しますが、Codex CLI では代わりに **スキル** を使います。\n\n### スラッシュコマンドとスキルの対応表\n\n| Cursor コマンド | Codex での方法 |\n|----------------|---------------|\n| `/overview` | `aiagent-guide` スキルを使用 |\n| `/check-setup` | `aiagent-check-setup` スキルを使用 |\n| `/start-0-1` | `aiagent-lesson-runner` スキルで `start-0-1` を指定 |\n| `/setup-security` | `aiagent-tooling-setup` スキルを使用 |\n\n### 使い方\n\nCodex CLI を起動し、以下のように依頼してください:\n\n```text\naiagent-lesson-runner スキルを使って start-0-1 レッスンを開始してください\n```\n\nまたは:\n\n```text\nstart-0-1 のレッスンを始めたい\n```\n\nCodex は `AGENTS.md` と `skills/` ディレクトリを自動的に認識し、適切なスキルを使用します。\n\n---\n\n## Step 5: 動作確認\n\n以下の手順で Codex CLI が正しく動作するか確認します:\n\n1. **ai-agent-camp ディレクトリで Codex を起動**:\n ```bash\n cd /path/to/ai-agent-camp\n codex\n ```\n\n2. **リポジトリのフック設定を確認**:\n ```text\n bash scripts/install_hooks.sh を実行してください\n ```\n\n3. **セットアップ確認スキルを実行**:\n ```text\n aiagent-check-setup スキルで環境を確認してください\n ```\n\n---\n\n## 期待される出力例\n\n```text\n環境チェックレポート\n| 項目 | 状態 | 詳細 |\n|------------|------|----------------|\n| Node.js | OK | 22.x |\n| Codex CLI | OK | 1.x.x |\n| OpenAI API | OK | 認証済み |\n| Git | OK | 2.x |\n| Hooks | OK | pre-commit 設定済み |\n```\n\n## よくあるトラブル\n\n- `codex: command not found` → `npx @openai/codex` で直接実行するか、`npm install -g @openai/codex` を再実行\n- API認証エラー → `OPENAI_API_KEY` が正しく設定されているか確認\n- パーミッションエラー → nvm/fnm を使用するか、[npm prefix の変更](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally) で対処\n- スキルが見つからない → ai-agent-camp のルートディレクトリで Codex を起動しているか確認\n\n---\n\n## チェックポイント\n- [ ] Codex CLI がインストールされている（`codex --version` が動作する）\n- [ ] OpenAI API キーが設定されている\n- [ ] 承認モードを `on-request` に設定している（AGENTS.md の推奨設定を参照）\n- [ ] `bash scripts/install_hooks.sh` でフックが設定されている\n- [ ] `aiagent-check-setup` スキルが正常に動作する\n\n---\n\n## 次のステップ\n\nCodex CLI のセットアップが完了したら、レッスンを開始できます。\n\n**Codex ユーザーの推奨フロー:**\n\n1. セットアップ確認: `aiagent-lesson-runner` スキルで `start-0-1`（環境セットアップ確認）を実行\n2. 本格レッスン開始: `aiagent-lesson-runner` スキルで `start-1-1`（Module 1 バナー生成入門）を開始\n3. 各レッスンのスラッシュコマンドはスキル経由で実行\n4. 困ったら `aiagent-guide` スキルで全体像を確認\n\n> **補足**: `.cursor/commands/lesson/` 内のレッスンファイルは Codex でも参照資料として利用できます。ただし、スラッシュコマンドとして直接実行することはできません。", "variables": [], "notes": "Lesson command", "metadata": { "source": { "provider": "github-cursor-commands", "repository": "https://github.com/minicoohei/ai-agent-camp", "path": ".cursor/commands/lesson/start-0-6.md", "ref": "66ceb848c302e1f1831ed0f4ecb428fd6df44cfd", "url": "https://github.com/minicoohei/ai-agent-camp/blob/66ceb848c302e1f1831ed0f4ecb428fd6df44cfd/.cursor/commands/lesson/start-0-6.md", "key": "minicoohei/ai-agent-camp/.cursor/commands/lesson/start-0-6.md" } } }

start-0-6

About