CodexのGPT-6 AstraでBlenderを操作する方法

CodexのGPT-6 AstraでBlenderを操作するために、最初からすべてのモデリングツールを覚える必要はありません。作りたい物を言葉で伝えると、公式Computer Useプラグインを通じてエージェントがBlenderの画面を確認し、操作できます。形を調整し、結果を確認しながら、段階ごとにプロジェクトを保存していきます。

まず、モデルへの接続方法を選びます。

利用状況	接続方法
CodexとAstraを利用できるアカウントとサブスクリプションがある	公式アカウントでログインし、GPT-6 Astraを選択
サブスクリプションがない	BetterToken API Keyで接続。Codexの公式アカウントへのログインは不要

どちらも、Pluginsから同じ公式Computer Useをインストールします。API Keyで変わるのはモデルへの接続とリクエストの課金方法で、プラグインの導入手順は同じです。

ここではインストールから、編集可能な卓上ランプと短いアニメーションの制作まで進めます。Blenderが動作するMacまたはWindowsパソコンが必要です。モデルへのリクエストはインターネットを経由し、Blenderとレンダリングは手元のパソコンで動作します。

OpenAIの公式解説に掲載された事例です。これは別の建築プロジェクトであり、このチュートリアルでは小さなランプから始めます。

1. アプリをインストールし、Codexのモデル接続を設定する

ChatGPTの公式ダウンロードページから、使用するOSのデスクトップアプリをインストールします。現在のアプリではモード切り替えからCodexを開けます。独立したCodex Appをすでに使っている場合は、更新してそのCodexセクションを利用してください。

サブスクリプションを利用する場合

1. アプリを起動し、ChatGPTでのログインを選びます。
2. サブスクリプションを利用できるアカウントでログインします。
3. Codexに切り替えます。
4. メッセージ入力欄付近のモデル選択でGPT-6 Astraを選びます。表示されない場合は、アカウントで利用可能なモデルを確認してください。

この方法ではBetterTokenのキーは不要です。プロジェクト作成へ進みます。

サブスクリプションがない場合：BetterToken API Keyを設定する

この方法はCodexの公式アカウントがなくても利用できます。自分のBetterTokenアカウントを使い、モデルへのリクエストは使用量に応じて支払います。

BetterToken API Keyを作成し、CodexのGPT-6 AstraでBlenderを操作する。

CodexをすでにAPI Keyで使っている場合

既存のAPI接続のBase URLとAPI KeyをBetterTokenの設定に置き換えれば接続できます。インストーラーの再実行は不要です。

1. BetterTokenでGPTプロバイダー用のキーを作成します。
2. Codexの現在のAPIプロバイダー設定を開き、Base URL（base_url）をhttps://www.bettertoken.ai/v1に、API Keyを自分のBetterTokenキーに変更します。環境変数にキーを保存している場合は、その値を更新します。
3. モデルが**gpt-6-astra**になっていることを確認します。以前に別のモデルを使っていた場合は、モデルIDも変更します。
4. 保存し、Codexを完全に再起動して、短いメッセージで接続を確認します。

接続できたらプロジェクトとBlenderの準備へ進みます。Computer Useがインストール済みならそのまま使えます。未導入の場合は、後述の手順でインストールしてください。

API接続を初めて設定する場合

1. BetterTokenのWorkspaceでGPTプロバイダー用のAPI Keyを作成し、手元のパソコンで設定するためにコピーします。
2. キーの接続設定でCodexと**gpt-6-astra**を選択します。モデルIDをastraに省略しないでください。
3. BetterTokenのCodexガイドのCommand-line setupを開きます。インストーラーにはNode.jsが必要です。未導入ならガイドに従って先にインストールします。
4. Codexを完全に終了し、MacではTerminal、WindowsではPowerShellを開き、対応するコマンドを実行します。
5. インストーラーがAPI Keyを求めたら、ローカルで入力します。エージェントとのチャットには送らないでください。設定と接続確認が終わるまで待ちます。

macOS — Terminal：

curl -fsSL "https://www.bettertoken.ai/install-codex-provider.sh" -o /tmp/install-codex-provider.sh
bash /tmp/install-codex-provider.sh --model gpt-6-astra

Windows — PowerShell：

iwr "https://www.bettertoken.ai/install-codex-provider.ps1" -OutFile "$env:TEMP\install-codex-provider.ps1"
powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-codex-provider.ps1" -Model "gpt-6-astra"

インストーラーはBetterTokenプロバイダーとResponses API接続を設定し、短いモデル確認リクエストを実行します。この確認にもAPIトークンを消費します。完了後にアプリを開き直してCodexを選びます。この接続方法ではChatGPTでのログインは必要ありません。

設定に失敗した場合は、先にキー、モデルへのアクセス、API呼び出し用の残高を確認してください。Computer Useをインストールしても、モデル接続のエラーは解決しません。

2. ローカルプロジェクトを作る

1. パソコン上に**astra-blender**フォルダーを作ります。Documents内などで構いません。
2. Codexで**Projects横の「+」**を押し、そのフォルダーをローカルプロジェクトとして追加します。言語やバージョンで表示名は異なる場合がありますが、パソコン上のプロジェクトを選びます。
3. プロジェクト内で新しいタスクを開き、Astraが選択されていることを確認します。
4. 「一言だけ『準備完了』と返信して」と送ります。

接続エラーなく返答があれば、Blenderへ進めます。API接続の場合はBetterTokenの利用履歴にも呼び出しが表示されるはずです。ここで確認したのはモデル接続で、Blenderのウィンドウへのアクセスは別にテストします。

このフォルダーには.blendファイル、画像、アニメーションを保存します。次の変更も同じタスクで続けると、Codexが以前の指示を参照できます。

3. Blenderをインストールして開く

Blenderは3Dモデリング、マテリアル、アニメーション、レンダリングを扱える無料ソフトです。Blender公式ダウンロードページから入手します。

1. OSに合ったビルドを選びます。MacではApple SiliconかIntelかを確認します。
2. macOSではダウンロードしたディスクイメージを開き、BlenderをApplicationsへ移動します。Windowsではインストーラーを実行し、案内に従います。
3. Blenderを起動します。初回設定は標準のままで、新規ファイルのGeneralを選べます。
4. 通常は中央に初期キューブ、右側のシーン一覧にCube、Camera、Lightが表示されます。まだ削除しないでください。
5. File → Save Asから、astra-blender内に**desk-lamp.blend**として保存します。

Codexにインストールを手伝ってもらう場合は、作成したプロジェクトで次を送ります。

Help me install Blender from https://www.blender.org/download/ for this computer.
Check whether Blender is already installed first. Use the official stable build.
Explain any installer or system-permission step I need to complete myself.
Open Blender and tell me which version is running.

Blenderのウィンドウが開いたらインストール完了です。Codexがダウンロードリンクを返しただけでは完了ではありません。OS別の手順はBlenderマニュアルにあります。

4. 公式Computer Useをインストールする

サブスクリプションでもBetterToken API Keyでも、次の手順は同じです。

1. アプリでPluginsを開きます。
2. OpenAIのComputer Useを探し、Install pluginを押します。
3. インストール後にEnableが表示されたら有効にします。
4. プラグインのカードでMCP serverとSkillを有効にします。サーバーは操作ツールを、Skillはその使用方法を提供します。
5. Settings → Computer useを開き、使用中のバージョンにAny Appが表示されていれば有効にします。Blenderへのアクセスを求められたら許可します。
6. Macではシステム設定で、要求されたScreen RecordingとAccessibilityの権限を付与します。再起動を求められたらアプリを再起動します。
7. プロジェクトのタスクに戻ります。必要なら新しいタスクを開き、プラグインのツールを読み込みます。

設定の場所はComputer Use公式ガイドで確認できます。WindowsではBlenderをアクティブなデスクトップ上に表示し、作業中はパソコンをロックしないでください。エージェントはそのセッションのマウスとキーボードを使います。

実際に画面を操作できるかテストします。

Use the official Computer Use plugin to inspect the open Blender window.
Tell me the current file name and the objects visible in the scene list.
Through the Blender interface, rename Cube to Connection_Test.
Show the updated scene list, then stop. Do not create or delete objects.

Blenderを確認してください。キューブは元の場所に残り、一覧の名前だけがConnection_Testになっているはずです。Codexが操作を説明するだけなら、Computer Useで実行するよう伝えます。この小さなテストで、正しいウィンドウを見て変更できることを確認します。

5. 最初のモデルを作る

確認しやすい卓上ランプから始めます。丸い台座、支柱、傾いたシェードを持つ形です。最初は操作を追えるよう、画面のインターフェースを使うよう依頼します。

Use Computer Use to build a small desk lamp in the current Blender project.
Work through Blender's graphical interface for this first pass. Do not generate
the geometry with a Python script or command-line process.

Replace only the Connection_Test object from our connection check.
Create a round base, a vertical stem, a short angled arm, a conical shade,
and a bulb. Keep the parts as separate editable objects named Lamp_Base,
Lamp_Stem, Lamp_Arm, Lamp_Shade, and Lamp_Bulb.

Use simple proportions and place the lamp upright on a flat surface.
Set a camera that shows the entire lamp. Save desk-lamp.blend in this project.
Show a front view and a side view, then stop for my feedback.

まずシルエットを確認します。台座が床面に接し、支柱がシェードにつながり、ランプ全体が画角に収まっているでしょうか。オブジェクト一覧で部品を選び、台座とシェードを別々に選択できれば、編集可能な状態です。

「台座を広くして」「支柱を短くして」「シェードを机へ向けて」など、目立つ問題を一つずつ直します。うまく変更できたら保存して、次の修正に失敗しても採用済みの形へ戻れるようにします。

OpenAI公式プロジェクトのジオメトリです。この表示では照明の美しさとは別に、オブジェクトや交差を確認できます。手法の参考であり、ランプ課題の完成例ではありません。

6. マテリアルと照明を追加する

形に納得できたら、見た目を整えます。

Continue with the existing desk lamp. Keep its geometry and object names.
Give the base and shade a muted blue painted-metal material, the stem a brushed
metal material, and the bulb a warm glow. Add soft studio lighting and a neutral
background. Do not add decorations or rebuild the lamp.

Render a 640x360 preview from the camera. Inspect the image, fix obvious floating
parts, intersections, or framing problems, and save preview-front.png and
desk-lamp.blend in this project. Stop after the preview for my feedback.

繰り返し操作には、エージェントがBlender Python APIのbpyを提案する場合があります。画面操作だけで進めたい場合は、その条件を再度伝えてください。シーンを素早く変更したいなら、コードを許可するか、次の公式MCPを追加できます。どちらでも、結果を開いて目視確認するよう依頼します。

OpenAI公式事例のマテリアルと照明です。このプロジェクトではAstraがbpyとレンダリング結果の確認を組み合わせています。マウス操作だけで制作したことを示す画像ではありません。

次の作業に向けて：公式Blender MCPを接続する

Computer Useは画面を操作します。MCPは、起動中のBlenderからシーンを読み取り、操作するための別の接続経路をCodexに提供します。手動操作が増えてきた段階で便利ですが、上の最初の課題には必須ではありません。

1. BlenderのMCPページを開き、公式Setup手順へ進みます。
2. Blenderのバージョンを確認します。現在の公式プロジェクトには5.1以降が必要です。
3. 同じCodexタスクにSetupのURLを渡し、Blender拡張機能と独立したMCP serverの両方をインストールして、サーバーをCodexに登録するよう依頼します。接続にはこの二つが必要です。
4. 拡張機能の準備ができたら、BlenderのEdit → Preferences → Add-ons → Install from DiskでZIPを選び、有効にします。CodexはComputer Useでこの操作を案内できます。
5. 拡張機能の設定で接続サーバーを起動します。拡張機能とMCP serverのアドレスとポートは一致させ、現在の公式手順に記載された値を使います。
6. 同じプロジェクトで新しいタスクを開き、MCPでオブジェクト一覧を読むよう依頼します。Lamp_Base、Lamp_ShadeなどがBlenderの一覧と一致するか確認します。

一覧が一致するまで編集しないでください。その後はMCPに制作を、Computer Useに画面や完成画像の確認を任せられます。接続が切れた場合は、部品を重複作成しないよう先に現在のシーンを確認します。

7. 短いアニメーションを作る

まず完成した静止モデルを保存します。最初の動画は、その周囲をカメラが動く構成で十分です。

Use the existing lamp scene to create a 6-second camera orbit at 24 fps,
frames 1 through 144. Keep the lamp still and all parts editable.
Move the camera smoothly through a quarter-circle around the lamp, keeping the
whole object in frame. Do not change the materials or add new objects to the lamp.

Save a separate file named desk-lamp-animation.blend.
Render 640x360 preview images for frames 1, 72, and 144 as
orbit-001.png, orbit-072.png, and orbit-144.png.
Inspect those images and stop before rendering the full animation.

3枚の画像を開きます。カメラがランプを突き抜けていないか、シェードが切れていないか、空のフレームになっていないか確認します。問題がなければ全144フレームを別フォルダーへレンダリングし、**desk-lamp-orbit.mp4**にまとめるよう依頼します。最初は640×360のままにしましょう。高解像度にするとローカルのレンダリング時間が増えます。

処理が遅い場合は、現在のレンダリングの進捗を確認します。最初の処理が終わったか分からないまま、同じシーンのレンダリングを重ねて開始しないでください。

うまく動かない場合

症状	確認すること
Codexが応答しない、401が出る、モデルが見つからない	API接続ではキー、GPTプロバイダー、gpt-6-astra、設定結果を確認し、アプリを完全に再起動
モデルは応答するがComputer Useツールがない	プラグインの導入、serverとSkillの有効化を確認し、新しいタスクを開始
ツールはあるがウィンドウにアクセスできない	Blenderへのアクセスを許可。MacはScreen RecordingとAccessibility、Windowsはアクティブでロックされていないデスクトップを確認
操作を説明するだけで変更しない	Computer Useで小さな操作を実行し、その後の状態を示すよう明示
MCPが別のシーンを表示する	開いている.blend、Blenderのインスタンス、拡張機能のアドレスとポートを確認
呼び出しが中断・タイムアウトした	先にオブジェクトと保存済みファイルを確認し、最後に完了した段階から再開
画像の見栄えが悪い	形と一つの視点に戻り、全体レンダリング前に比率、交差、照明を修正

最後に残るのはdesk-lamp.blend、別のアニメーションファイル、確認画像、そして全体レンダリング後の動画です。.blendを開き直して自分で一つの部品を変更し、次にCodexへ具体的な修正を依頼してプロジェクトを続けてください。