Nanobot Codex：接続方法と用途別の設定・違いを比較整理

Nanobot Codexとは：二つの役割を分けて理解する

Nanobot Codexという検索語は、二つのソフトウェアをつないで使う場面を指します。NanobotはメッセージやWeb画面から依頼を受け、選んだプロバイダーとモデルに応答を求めるための枠組みです。CodexはOpenAIが提供する、リポジトリを読み、コードの変更やテスト、レビューを進めるためのエージェントです。同じ依頼文を扱えても、どこで会話を受け、どこでファイルを読み、誰が差分を返すのかが違います。先にこの境界を分けておくと、「Nanobotを入れればCodexアプリになる」「Codexを選べばNanobotの機能がすべて使える」といった誤解を避けられます。

Nanobotは入口と会話の場を組み立てる

HKUDSの公式リポジトリは、Nanobotを軽量で自己管理する個人向けAIエージェント基盤として説明しています。Web画面、端末、チャット接続、作業フォルダー、記憶、外部ツールを組み合わせ、選んだプロバイダーへ依頼を送る構成です。利用者は一つの完成済み画面だけに閉じるのではなく、会話の入口と作業場所を自分の環境に合わせて選びます。公式案内は https://github.com/HKUDS/nanobot で確認できます。

Codexはコードベースの仕事を担当する

OpenAI Codexは、コードの作成、修正、調査、テスト、レビューといった開発作業を一つの依頼として扱うサービスです。公式ドキュメントでは、CLI、エディター、アプリ、クラウドという複数の入口が説明されています。どの入口でも、返事の文章だけでなく、変更したファイル、検証結果、残った注意点を確認することが重要です。公式の全体像は https://developers.openai.com/codex/ にまとまっています。

Nanobotから選ぶCodexは接続先として考える

Nanobotの設定でCodex用のプロバイダーを選ぶと、Nanobotの会話からCodex系のモデルへ依頼を送れるようになります。ただし、Nanobotの画面、作業フォルダー、履歴の持ち方はNanobot側の設計に従います。Codex公式アプリの表示や利用条件がそのまま移るわけではありません。接続後に確認すべきなのは、モデル名が表示されたか、対象フォルダーを読めたか、返答だけでなくコード変更の結果を説明できたかという三つの事実です。

NanoClawとNanobotを取り違えない

名前が似たNanoClawとNanobotは別のプロジェクトです。NanoClawはメッセージを受けて隔離環境で処理する小さな個人アシスタント基盤として知られ、NanobotはWeb画面や端末、複数のプロバイダーを含む別の構成を持ちます。検索結果の一行だけで導入手順を混ぜず、開いたリポジトリの所有者、設定ファイルの名前、コマンドの先頭を確認してください。今回の対象は https://github.com/HKUDS/nanobot にあるNanobotです。

なぜ今Nanobot Codexを確認するのか

NanobotからCodexを選ぶ方法は、単なるモデル名の置き換えとして読むと判断を誤りやすくなります。2026年9月にOpenAIとNanobotの双方で、長く続く作業、作業の状態、使う道具、結果の確認を意識した更新が進みました。これはNanobotがOpenAIの公式製品になったという意味ではなく、AIコーディングエージェントを選ぶときに、モデル性能だけでなく実行環境と確認経路も比べる必要が増えたということです。公式発表と公式リポジトリの記載を分けて読むことが、現在の接続判断に役立ちます。

OpenAIのAgents APIが示す変化

OpenAIは2026年9月10日、Codexを支える実行基盤を開発者が使えるAgents APIの公開ベータを発表しました。発表では、クラウド上のエージェントを一つのAPI呼び出しから組み立て、環境を選び、道具を使い、長い作業を続け、必要に応じて複数の担当へ分ける考え方が示されています。Nanobotとの直接連携を発表した記事ではありませんが、Codexの価値がモデル単体から、作業場所や結果の受け取りを含む一連の実行へ広がっていることを確認できます。出典: https://openai.com/index/introducing-the-agents-api/ 。

Nanobot v0.3.0以後の確認点

Nanobotの公式リリース v0.3.0 は2026年7月25日付で、Web画面からの設定、セッションごとのモデル切り替え、作業の確認、明示した長期作業の扱いなどを案内しています。公式リポジトリの最近の更新欄には、9月4日のコンテキスト使用量表示と9月5日の圧縮進行表示もあります。これらはCodex専用機能ではありませんが、Nanobotを入口にCodexを選ぶときにも、どの画面でモデルを選び、どの履歴を読み、どの結果を確認するかが以前より見えやすくなっています。出典: https://github.com/HKUDS/nanobot/releases/tag/v0.3.0 。

今回の記事でいう「接続」の範囲

ここでいう接続は、Nanobotのプロバイダー設定でCodexの入口を選び、Nanobotの会話から依頼を送り、返答を確認するところまでを指します。OpenAIがNanobotを公式に保守している、Nanobotのすべての機能がCodex側で動く、あるいは同じ利用枠が二つの製品で共有されるといった意味ではありません。料金、利用条件、モデルの提供状況はそれぞれの案内を確認します。公式Codexの現行仕様は https://github.com/openai/codex 、Nanobot側の設定は https://github.com/HKUDS/nanobot を基準にしてください。

接続前に決める三つの判断

設定画面を開く前に、何をNanobotへ任せ、何をCodexへ任せるのかを決めておくと、接続後の評価がぶれません。第一に、会話の整理や通知を中心にするのか、リポジトリの変更と検証を中心にするのかを決めます。第二に、対象となる作業フォルダーを一つに絞ります。第三に、どのモデル名と利用枠で試すのかを記録します。三つを決めずに接続すると、返答が良くても、どの設定が効いたのか、どの場所を読んだのか、次に同じ結果を再現できるのかが分からなくなります。

Step 1: Codexを開発作業の担当にするか決める

Nanobotの会話を整えることが目的なら、まずNanobot単体の応答を確認します。コードの調査や複数ファイルの変更が目的なら、Codexを選んだ場合に差分と検証結果を返せるかを見ます。メール整理や一般的な質問をコード担当のモデルへ送り続けても、違いを評価しにくくなります。最初の題材は小さな読み取り、短い修正、テスト結果の説明など、完了条件を一文で表せるものが適しています。

Step 2: 作業フォルダーを一つに絞る

Nanobot公式案内では、設定に作業場所を指定し、必要に応じてコマンド単位で作業場所を上書きする例が示されています。最初から複数のプロジェクトを混ぜると、返答の根拠がどのファイルにあるのか確認しづらくなります。検証用の小さなリポジトリを一つ選び、読み取りだけの依頼から始め、次に変更を伴う依頼へ進む順番にします。作業場所を示す値と、会話を保存する場所が同じとは限らない点にも注意が必要です。

Step 3: モデル名と利用枠を記録する

Nanobotの公式READMEには、Codex用のモデル値として openai-codex/gpt-5.1-codex を使う例があります。ただし、これはREADMEに掲載された設定例であり、すべての時期、プラン、入口で利用できることを保証する表示ではありません。設定した文字列、実際に表示されたモデル、サインインしたアカウント、応答が返った日時を同じメモへ残してください。後からモデルが見つからないときに、入力ミスと提供条件を切り分けられます。

NanobotでCodexプロバイダーを選ぶ手順

ここからは、公式READMEに掲載されている構成を読み取り、最小の確認を行う順番を説明します。導入方法はOSや配布版によって変わるため、コマンドを丸ごと別の環境へ移すのではなく、現在の公式リポジトリの案内を先に開いてください。重要なのは、Nanobot本体の導入、Codex用のサインイン、モデル値の指定、短い会話による確認を別々の事実として扱うことです。どこか一つが通らなくても、他の層まで失敗したと決めつけないようにします。

Step 1: 公式リポジトリの現行案内を読む

Nanobotには配布版、ソースからの導入、Web画面、端末からの利用など複数の入口があります。公式READMEに書かれたPythonの前提、導入方法、設定ファイルの場所、バージョン確認方法を読み、自分のOSに合う経路を選びます。ここで古い記事の設定を先に写すと、画面や項目の名前が現行版と合わないことがあります。参照先は https://github.com/HKUDS/nanobot です。

Step 2: Codex用の入口へサインインする

公式READMEには、Codex用プロバイダーへサインインするコマンドとして次の形が示されています。実際に実行する前に、Nanobotの版と表示された案内が一致することを確かめてください。

nanobot provider login openai-codex

この操作が成功しても、すぐにコード変更を依頼する必要はありません。まずNanobotの状態表示や設定画面で、Codex用プロバイダーが選択可能になったかを確認します。ブラウザーが開かない、別のアカウントが表示される、完了表示が出ない場合は、モデル設定へ進まず、サインインの層だけを切り分けます。出典: https://github.com/HKUDS/nanobot 。

Step 3: モデル名を設定する

Nanobotの公式READMEでは、既定のエージェント設定にモデル値を追加する例が示されています。例をそのまま鵜呑みにせず、現在表示されるモデル候補と照合してから、自分の設定ファイルへ反映します。

{
  "agents": {
    "defaults": {
      "model": "openai-codex/gpt-5.1-codex"
    }
  }
}

モデル値の前半にある openai-codex はNanobot側のプロバイダー識別子で、後半は選択するモデル名です。ここを一つの長い名前として覚えると、プロバイダーだけが認識される場合やモデルだけが見つからない場合の切り分けが難しくなります。設定を書き換えたら、表示された値を確認し、短い会話を一回だけ行います。出典: https://github.com/HKUDS/nanobot 。

Step 4: 短い会話で応答を確認する

最初の確認は、コードを変更しない質問にします。たとえば「この作業場所にあるREADMEの目的を三文で説明してください」と依頼し、返答のモデル表示、参照した場所、説明の根拠を確認します。Nanobotの公式READMEには、エージェントへメッセージを送る基本形として次の例があります。

nanobot agent -m "READMEの目的を短く説明してください"

返答が戻ったら、次の依頼でいきなり大きな修正を求めず、変更対象のファイル名、変更してよい範囲、確認方法を明示します。結果が会話文だけで返るのか、差分や実行結果まで返るのかを確認し、Nanobotの表示と対象フォルダーの状態を別々に見ます。

Codexを使うときの設定の読み方

NanobotとCodexの接続で混乱しやすいのは、プロバイダー、モデル、作業場所、会話の入口が一つの設定に見えることです。実際には、それぞれが別の役割を持ちます。プロバイダーはどのサービスへ依頼を送るか、モデルはどのモデル名を選ぶか、作業場所はどのファイルを読むか、入口はどの画面やコマンドから会話を始めるかを決めます。どれか一つを変えたときに、残り三つを同じ条件で固定すると、接続の結果を比較しやすくなります。

プロバイダー名とモデル名を混ぜない

openai-codex/gpt-5.1-codex のような表記は、Nanobotのプロバイダーとモデルを一つの値で示す形式です。前半の認識に失敗すればサインインや接続の問題になり、後半の認識に失敗すればモデル候補や提供条件の問題になります。設定エラーを見たときは、最初にスラッシュの前後を分けて読み、公式READMEに同じ表記があるか確かめます。OpenAI Codexの公式CLIソースにある --model の説明も、別の入口でモデルを選ぶ場合の比較材料になります。出典: https://github.com/openai/codex/blob/main/codex-rs/exec/src/cli.rs 。

workspaceを分けて検証する

Nanobotの作業場所は、モデルへ渡すコードや文書の範囲を決める重要な境界です。個人用の会話を保存する場所、プロジェクトの作業場所、Nanobot本体の設定ファイルを同じものだと考えないでください。公式READMEには、設定ファイルと作業場所をコマンド単位で指定する例があります。最初は専用の検証フォルダーを選び、対象ファイルを少数にして、返答が実際の内容を参照しているかを確認します。出典: https://github.com/HKUDS/nanobot 。

会話入口とコード作業を分ける

NanobotのWeb画面やチャット入口は、会話を始めたり結果を受け取ったりする場所です。CodexのCLIや公式クラウド入口は、コード作業の状態や差分を確認するための別の画面として設計されています。Nanobot経由で依頼した結果を読むときも、返答の文章だけで完了と判断せず、ファイルの変更、テストの成否、残った確認事項を分けて見ます。入口が便利になった分、どの画面が一次情報なのかをメモしておくことが大切です。

CodexとNanobotを用途で使い分ける

二つを比べるときは、どちらが高性能かを一言で決めるより、作業の入口と成果物で分ける方が実用的です。会話を複数の場所から受けたい、同じ設定でモデルを切り替えたい、Web画面で状態を見たいという目的ならNanobot側の価値が中心になります。リポジトリを読み、変更差分を作り、テストを確認し、コードレビューへつなげたい目的ならCodex側の機能が中心になります。NanobotからCodexを選ぶ構成は、この二つを接続するものですが、どちらかの責任範囲を消すものではありません。

リポジトリの調査はCodexを中心にする

既存コードの構造を読んだり、関係するファイルを探したりする仕事では、Codexがどのファイルを参照し、どの前提から結論を出したかを確認できることが重要です。Nanobotの会話を入口にしても、依頼文には対象のフォルダー、調べる範囲、返してほしい形式を含めます。調査結果だけが必要なら変更を依頼せず、参照したファイル名を返してもらいます。まず読む、次に小さく変える、最後に検証するという順番にすると、接続の良し悪しを評価しやすくなります。

会話の整理や複数入口はNanobotを中心にする

チャットやWeb画面から同じエージェントへ相談したい場合、Nanobotの入口と設定管理が役立ちます。ただし、会話を受けられることと、コードの変更を安全に完了できることは別の能力です。メッセージの要約や調査の下書きはNanobotで行い、変更を伴う依頼は対象フォルダーと確認方法を明示してCodexへ渡します。結果を受け取った後は、元の会話に戻るだけでなく、実際の差分と検証結果を確認してください。

判断が曖昧な仕事はすぐに接続しない

「何か改善して」「使いやすくして」のように完了条件が曖昧な依頼は、NanobotとCodexのどちらを選んでも比較が難しくなります。最初に対象、困っている事実、触れてよい範囲、期待する結果を言葉にします。目的が整理できない段階では、Nanobotへ要件の質問を投げ、変更を依頼する前の確認にとどめる方法が向いています。モデルの違いを測りたいときほど、入力の条件をそろえることが重要です。

失敗したときの切り分け

Nanobot Codexでエラーが出た場合、最初から「Codexが使えない」と考えないでください。サインイン、プロバイダー識別子、モデル名、作業場所、依頼内容、返答表示という順に、止まった場所を一つずつ確認します。公式リポジトリに掲載されたコマンドと自分の版が違う場合もあるため、エラー文を検索する前にバージョンと設定ファイルを控えます。確認の順番を固定すると、設定を何度も書き換えて原因を増やすことを避けられます。

Step 1: サインイン完了とアカウントを確認する

nanobot provider login openai-codex を実行したあと、完了表示が出たか、Nanobotの状態画面にプロバイダーが現れたかを見ます。ブラウザーが別のアカウントで開いていないか、利用している契約にCodex用の入口が含まれるかも分けて確認します。ここで止まっているなら、モデル名や作業場所を変えても解決しません。公式READMEの現在の案内と、手元で表示されたメッセージを照合してください。

Step 2: プロバイダーとモデルの表記を確認する

設定値を見て、openai-codex とモデル名の綴り、区切り文字、引用符、設定ファイルの階層を確かめます。プロバイダーは認識されるのにモデルが選べない場合、モデルの提供状況、版、利用枠が原因かもしれません。READMEに掲載された例を基準にしつつ、現在の候補一覧に同じ値が出るかを確認します。異なる値を試すときは、一度に一つだけ変え、前の設定を記録しておきます。

Step 3: 作業場所と読み取り範囲を確認する

返答が一般論だけになる場合は、Nanobotが意図した作業場所を開いているかを見ます。設定ファイルで指定した場所、コマンドで上書きした場所、実際に開いている端末の場所が一致しているかを確認してください。READMEの説明にある作業場所の指定例を使い、検証用フォルダーのREADMEなど、内容が明らかなファイルを対象にします。ファイルを読めたかどうかを返答の中で説明させれば、モデルの問題と入口の問題を分けられます。

Step 4: 変更結果と会話結果を別々に確認する

返答が成功しても、ファイル変更が正しいとは限りません。返答の文章、差分、テスト結果、実行時の警告をそれぞれ確認します。変更がないのに「完了」と書かれている場合は、依頼の範囲が読み取りだけだった可能性があります。変更があった場合も、対象外のファイルまで触れていないかを見てください。Nanobotの会話表示を根拠にせず、作業場所にある実際の差分と検証結果を一次情報として扱います。

利用前に確認したい安全と費用

NanobotからCodexを選ぶ構成では、二つの製品にまたがってアカウント、設定、作業場所、外部ツールが動きます。接続できたことだけを成功条件にすると、意図より広い情報を渡したり、利用枠の計算を誤ったりしやすくなります。最初は会話と読み取りに限定し、変更を伴う作業へ進むときは対象フォルダーと確認方法を明示します。公式ドキュメント、Nanobotの公式README、実際の画面表示の三つを分けて記録することが、長く使うための基本です。

コードの範囲を小さく始める

作業場所は、Nanobotと選択したモデルが参照できる範囲を左右します。プロジェクト全体を最初から見せるのではなく、説明用の小さなフォルダーや検証用の複製で読み取りを試します。変更を依頼する場合は、対象ファイル、触れてはいけないファイル、実行してよい確認方法を依頼文へ書きます。外部ツールを追加する場合も、最初からすべてを有効にせず、一つずつ結果と必要性を確認してください。

アカウントと利用枠を分けて見る

Nanobotの導入が無償でも、選んだプロバイダーやモデルの利用条件まで無償になるとは限りません。サインインで使う契約枠、API経由で使う場合の従量計算、Nanobot本体の配布条件は別々に確認します。公式READMEに掲載されたモデル例を、そのまま自分のアカウントで使えると決めつけないことが重要です。利用前と利用後に、どの入口で、どのモデルを、どのアカウントで使ったかを記録すれば、請求や上限の確認が容易になります。

外部ツールを追加する順番を決める

Nanobotは外部のツール接続や複数の入口を扱えますが、Codexを試す初回からすべてを組み合わせる必要はありません。まずモデルの返答だけを確認し、次に作業場所の読み取り、最後に必要なツールを一つ追加します。問題が出たときに接続先を一つずつ戻せる状態を保つことが大切です。利用者が意図した範囲と実際の動作が一致しているかを、短い依頼と明確な結果で確認してください。

まとめ：Nanobot Codexは入口と担当を分けて選ぶ

Nanobot Codexは、Nanobotの会話や設定の入口から、Codex用のプロバイダーとモデルを選ぶ構成です。Nanobotは入口、会話、作業場所の組み立てを担当し、Codexはコードベースの調査、変更、検証を担当します。2026年9月10日のAgents API発表と、Nanobot v0.3.0以後の更新を踏まえると、モデル名だけを比べるより、どの環境で何を任せ、どの差分や結果を確認するかを決めることが重要です。

最初は公式READMEの例にある nanobot provider login openai-codex とモデル値を確認し、変更を伴わない短い会話で接続を試します。その後、作業場所を一つに絞り、対象ファイル、変更範囲、テスト方法を明示した小さな依頼へ進みます。うまくいかないときは、サインイン、プロバイダー、モデル、作業場所、結果表示の順に切り分けてください。NanobotとCodexを一つの製品だと扱わず、それぞれの公式案内を基準にすれば、用途に合う接続方法を落ち着いて選べます。