OpenAI Codex で AgentKit を使う方法（2026 年 ステップバイステップ）

- 以下のコマンドと価格は、執筆時点（2026-08）で公式ドキュメント（docs.agentkit.best、ベータチャネル）と照合済みです。ベータチャネルは GA リリースよりも変更が速いため、依存する前に最新のドキュメントで確認してください。

「AgentKit」「Codex」と呼ばれる 3 つのもの - まずこれを読んでください

コマンドを 1 つ入力する前に、混同されがちな 3 つの名前を区別しましょう。これらを取り違えると、単なる言葉のミスにとどまらず、間違った製品を間違った価格で買うことになります。

だからこそ「use AgentKit with Codex」や「AgentKit pricing」で検索すると、OpenAI 自身の Agent Builder の結果が表示されるのです - 間違った製品、間違った価格、間違ったインストール手順です。本記事は上記の 2 番目の行、つまり agentkit.best についてのみ扱います。間違ったものを買わないための完全な内訳は、OpenAI AgentKit と AgentKit（agentkit.best）の徹底比較をご覧ください。

始める前に必要なもの

5 分でできるチェックリスト - 最初のコマンドを入力する前に、全部読んでください。

• Codex CLI、または Codex を含む ChatGPT プランが、OpenAI アカウントでインストール済み・サインイン済みであること。
• すでに購入済みの AgentKit ライセンス - Engineer $99 または Bundle $149。無料プランではありません。
• キットをインストールしたい正確なプロジェクトディレクトリで開いたターミナル。
• 中断されない 5 分ほどの時間。

みんなが見落とすポイント：AgentKit にログインしても Codex にはサインインされませんし、その逆も同様です - これらは完全に別々の 2 つの認証システムなので、2 つの異なるものに対して 2 回ログインすることになります。マシンを切り替えた場合は、それぞれ個別に再認証する必要があります。ak kit init まで進んでから Codex にサインインしていなかった（またはその逆）と気づくことのないように - 先に両方を確認しておけば、無意味なデバッグの繰り返しを避けられます。まだ Codex をインストールしていませんか？まずはCodex CLI のインストール方法をお読みください。Codex が何なのか、Claude Code とどう違うのかよくわからない場合は、OpenAI Codex とは何かをご覧ください。

ステップ 1 - ak CLI をインストールする

AgentKit は ak という単一のネイティブ CLI バイナリを通じて動作します - Node も Bun も、事前にインストールする追加のランタイムも不要です。ご自身の OS を選んでください。

# macOS / Linux
curl -fsSL https://agentkit.best/install.sh | sh

# Windows (PowerShell)
irm https://agentkit.best/install.ps1 | iex

インストーラーは OS とアーキテクチャを自動的に検出します。完了したら、2 つのコマンドで確認してください。

ak --version
ak doctor --json

ak doctor --json はインストールの健全性を JSON として出力します - 後のステップも含め、何か不具合を感じたらいつでも実行してください。ネイティブバイナリなので、このインストール手順は Node が使えないサンドボックス/CI 環境でも問題なく動作します - npm パッケージとして配布されるキットとの本当の違いです。

ステップ 2 - サインインしてライセンスを確認する

メールアドレスまたは API キーのうち、都合の良い方でサインインしてください。

ak login --email [email protected]
# or
ak login --api-key ak_live_...

次に、何かをインストールする前に、正しいライセンスを持つ正しいアカウントであることを確認してください - これはほとんどの人が飛ばしてしまうステップで、後になってライセンスが実際には有効化されていなかった、あるいは購入時に使ったのとは別のメールでログインしていた、と気づくのです。

ak whoami
ak licenses

ak licenses は、あなたが所有しているもの（Engineer、Marketing、または Bundle）を正確に一覧表示します。支払ったはずなのにリストが空で返ってくる場合は、続行する前に注文確認メールか agentkit.best のアカウントページを確認してください - 何も確認せずにインストールして、権限が見つからずエラーになる理由に悩むのはやめましょう。

ステップ 3 - キットを Codex にインストールする

これは記事全体の中心となるコマンドです - 現在どのページも完全な形では書き出していないものです。

ak kit init engineer --target codex

デフォルトではプロジェクトスコープでインストールされます - キットは現在のプロジェクトディレクトリ内でのみ適用され、どこでも使えるわけではありません。毎回インストールし直すことなく、すべてのプロジェクトで使えるようにしたい場合は、グローバルフラグを追加してください。

ak kit init engineer --target codex --global

ディスクに何かを書き込む前に、ak は確認/プレビュー画面を表示します：キット名、出力先、インストールモード（プロジェクトまたはグローバル）、スコープ、そして書き込もうとしているファイルの正確なリストです。「y」と入力する前にこの画面を読んでください - 後から推測して書き込まれた内容を掘り返すのではなく、キットが何に触れるのかを正確に把握できる瞬間です。

実践メモ：初めてこれを実行したとき、確認画面がすべてをはっきりと示してくれました - Engineer キット、.agents/skills への書き込み、プロジェクトスコープ、そして作成されようとしているファイルの具体的なリストです。裏に隠されたものは何もありません。確認を押せば、何に触れたのかが正確にわかります。

まだキットをお持ちでないですか？上記のコマンドが実際に動作するには、Engineer または Bundle ライセンスが必要です。現在の価格と実施中のセールを確認してから、このステップに戻ってきてください。

AgentKit Engineer キットを入手する →

ステップ 4 - $ak:cook で最初のスキルを実行する

Codex は、インストールしたのと同じプロジェクトで新しい Codex セッションを開いた後にのみ、スキルを認識します - スキルを検出するために再スキャンするリロードが必要だからです。古いセッションで入力し続けて、何も起こらない理由に悩むのはやめましょう。

新しいセッションで、Codex の $ak: 構文を使ってスキルを呼び出します。

$ak:cook Add a health-check endpoint

サンプルのタスクはご自身のものに置き換えてください - これは呼び出し構文を示すための例にすぎず、固定の書式ではありません。覚えておく価値があるのは、2 つのランタイム間での構文の違いです：Codex は $ak: を使い、Claude Code は /ak: を使います - 同じキット、同じスキルで、動作する場所によって呼び出し文字が異なるだけです。Codex の中で /ak:cook と入力してキットが壊れていると思い込まないでください。それはほぼ必ずインストールの失敗ではなく構文の不一致です。

実践メモ：新しい Codex セッションで $ak:cook を呼び出すと、追加の設定なしですぐにスキルが認識されました - インストール後に検出には新しいセッションが必要というドキュメントの説明どおりです。

Codex と Claude Code で AgentKit の挙動が異なる点

ここが本当に新しい情報です - 現在、他のどのページもこれを書き出していません。AgentKit はすべてのランタイムで同じように動作するわけではなく、Codex には Claude Code と比べて特定の制限があります。ランタイムアダプターのドキュメント（docs.agentkit.best/en/beta/concepts/runtime-adapters、2026-08 にアクセス）に明記されています。

手短に言うと：スキル、ルール、エージェントのディスパッチは Codex で完全に動作します - それが $ak:cook を呼び出す仕組みのすべてです。Hooks は部分的で、Kit コマンド（スキルとは別の、キット独自のスラッシュ形式のコマンド）とステータスラインは Codex にはそもそも存在しません。依存しているワークフローが Kit コマンドやサポート対象外の hook に大きく依存している場合、その部分は Claude Code では問題なく動いても Codex では黙って実行されないと考えてください - これはバグではなく、アダプターが自らの境界を最初に宣言しているだけであり、依存した後に痛い目を見て気づくようなものではありません。

Claude Code に慣れていて Codex が初めての場合、いくつかのものが「消えた」ように見えても驚かないでください - それらはそもそも Codex ではサポートされていなかったのであって、あなたのインストールで壊れたわけではありません。

具体例を挙げます：Claude Code で慣れているワークフローに、Kit コマンドを通じて起動するステップや、サポート対象外の hook に依存するステップが含まれている場合、その特定のステップは Codex では黙って実行されず、一方でコアのスキルレイヤー（$ak:cook やその他）は問題なく動作し続けると考えてください。安全なやり方は、同じキットだからといって同一の挙動を前提とするのではなく、インストール直後にテストすることです。

無料の Codex と有料の AgentKit - 正直な境界線

最初にはっきり言っておきます：あなたは「Codex を使う」ためにお金を払っているのではありません。Codex CLI、Codex クラウド、さらにはゴールモード /goalまで、無料か、あなたが支払っている ChatGPT プラン（Free/Go/Plus/Pro/Business）にすでに含まれています。AgentKit は、その同じ無料の Codex エンジンの上にインストールするあらかじめ作られたスキル、エージェント、ワークフローのレイヤーです - あなたはスキルを自分で書く手間を省くために支払っているのであって、Codex 内部の何かをアンロックするために払っているのではありません。

上記の価格は執筆時点（2026-08）の価格ページを反映しています。このサイトは ref リンク経由で -20% のセールを頻繁に実施しており（Engineer で約 $79.20） - セールは変わる可能性があるため、どの数字も固定と考えず、支払う前に現在のバナーを確認してください。返金保証はありますが、サイトは具体的な期間を公表していません - 「14 日」や「30 日」と決めつけず、購入手続きの際に正確な条件を確認してください。購入前の製品全体像と時間あたりの ROI の内訳については、AgentKit の完全レビュー、またはAgentKit の価格は価値があるかの詳しい価格情報をお読みください - この 2 つは評価を深く掘り下げています。本記事は、インストール前に判断できる程度に無料と有料の線引きだけを明確に扱います。

トラブルシューティング

• インストールが壊れていると疑う場合：最初から再インストールする前に ak doctor --json を実行し、JSON のエラーセクションを読んでください。
• キット/スキルのバージョンを確認したい場合：ak versions は最新リリースと比較します。キットが古いのではと疑うときに便利です。
• $ak:cook が認識されない：ほぼ必ず、キットをインストールした正確なプロジェクトディレクトリで新しい Codex セッションを開いていないことを意味します - 古いセッションを閉じ、正しいディレクトリで開き直して、もう一度試してください。
• プロジェクトスコープでインストールしたが、他の場所でも必要：これはバグではなく想定どおりの動作です - プロジェクトスコープはインストールした場所でのみ適用されます。どこでも使いたい場合は --global を付けてコマンドを再実行してください。
• ライセンスがまだ有効か不明：ak whoami と ak licenses で、アカウントと実際に所有しているキットを確認できます。
• 確認画面に予想外のものが表示される（スコープが違う、出力パスが違う）：いったんキャンセルし、--global を付けるつもりだったか再確認してから、再実行してください - プレビューをキャンセルする方が、間違った場所に書き込まれたファイルを片付けるより安上がりです。

よくある質問（FAQ）

Codex で使う場合、AgentKit は無料ですか？

いいえ。Codex（CLI/クラウド/ChatGPT）は無料か、すでにあなたが支払っているプランに含まれています。AgentKit はその上にインストールする有料のキットです - Engineer $99、Bundle $149 で、Codex を含むどのターゲットでも同じ価格です。

/ak: と $ak: の違いは何ですか？

同じキット、同じスキルで、ランタイムごとに呼び出し構文が異なるだけです。Claude Code は /ak:cook、Codex は $ak:cook を使います。間違った文字を入力することが、スキルが「動かない」最も一般的な理由です。

Claude Code も必要ですか、それとも Codex 用だけに AgentKit をインストールできますか？

Codex だけで十分です。ak kit init engineer --target codex は Codex 用に単独でインストールします - 併せて Claude Code が必要になることはありません。

これは OpenAI 自身の AgentKit と同じですか？

いいえ。本記事の AgentKit は agentkit.best で、ak CLI で動作するサードパーティ製品です。OpenAI AgentKit は OpenAI 自身の Agent Builder/ChatKit で、名前が同じだけのまったく別の製品です。

AgentKit は Claude Code より Codex の方が高いですか？

違いはありません。同じライセンスが同じ価格（キット 1 つあたり $99、Bundle は $149）で、どの --target をインストールしても適用されます - Codex が別料金や割高になることはありません。

1 つのライセンスを Claude Code と Codex の両方で使えますか？

1 つのライセンスで無制限に複数のターゲットを同時に使えるという公式な確認はありません - ライセンスはデバイスのアクティベーションで管理され、--target はキットの配置先を決めるインストール時のパラメータにすぎません。同じライセンスで両方のランタイムを動かす予定なら、決めつけずに購入手続きの際にアクティベーション上限を確認してください。

まだ Codex をインストールしていません - 先に AgentKit をインストールできますか？

あまり意味がありません。ak kit init … --target codex は Codex が読み込むディレクトリ（.agents/skills）にスキルを書き込むだけです。Codex がインストールされていないと、それを実行するものがまだ何もありません。まずはCodex CLI インストールガイドから Codex をインストールしてサインインし、それから上記のステップに戻ってきてください。

確認画面では、何かが書き込まれる前に本当にキャンセルできますか？

はい - それがこの画面の目的です。ak kit init は、何かを書き込む前にキット名、出力先、インストールモード、スコープ、ファイルリストを表示します。スコープや保存先がおかしいと感じたら、後から気づくのではなく、その画面で引き返せます。

まとめ

本当の手順全体は 4 ステップに収まります：ak をインストール、ak login、ak kit init engineer --target codex、新しい Codex セッションを開く、そして $ak:cook を呼び出す。Codex は無料のまま、またはあなたが支払っている ChatGPT プランにすでに含まれています。AgentKit はあらかじめ作られたスキル/エージェントのレイヤーに対する追加費用であって、Codex を「アンロック」するための料金ではありません。すでに毎日 Codex を使っていて、スキルを一から書きたくないなら買う価値があります。まだ素の Codex に慣れている途中なら、急ぐ必要はありません。