Claude Code または Codex とチャットする
ローカルのコーディングエージェントを Busabase に接続し、モデルを選んで最初のチャットを安全に実行します。
Busabase の Agents 画面から Claude Code または Codex と会話したい場合は、この手順を使います。Busabase が ACP クライアントになり、同じコンピューター上でコーディングエージェントを起動します。
これはローカルエージェント接続です
Claude Code と Codex は、Busabase Desktop またはオープンソース版 Busabase server をホストするコンピューター上で動きます。Busabase Cloud からコンピューター上のプログラムを直接起動することはできません。Cloud ワークスペースでローカルエージェントを使う場合は、先に Local↔Cloud Tunnel でコンピューターを接続してください。
これは、エージェントが skill・API・MCP server 経由で Busabase を呼び出す エージェントを持ち込む とは逆方向の接続です。
始める前に
- 最新の Node.js をインストールし、ターミナルで
npx --versionが動くことを確認します。 - 使用するコーディングエージェントをインストールして認証します。
- 通常起動する Desktop app では、エージェントの永続的なログインを使います。環境変数だけで設定する custom gateway では、専用ターミナルからオープンソース版 Busabase server を起動します。
標準のホスト型 provider を使う場合は、先に CLI を確認します。
claude --version
claude auth status
codex --version
codex login statusモデル provider を設定する
Claude Code がすでにターミナルで動く場合、Busabase 側の追加設定は不要です。Anthropic 互換 gateway を使う場合は、Busabase を起動する前に変数を export します。
export ANTHROPIC_BASE_URL="https://your-anthropic-compatible.example/v1"
export ANTHROPIC_AUTH_TOKEN="your-token"Codex の永続的な provider 設定は、ユーザー単位の ~/.codex/config.toml に保存します。model_provider は provider table の名前、model はその provider が受け付ける正確なモデル ID です。
model = "gpt-5.6"
model_provider = "OpenAI1"
[model_providers.OpenAI1]
name = "OpenAI1"
base_url = "https://your-openai-compatible.example/v1"
env_key = "CUSTOM_OPENAI_API_KEY"
wire_api = "responses"Busabase を起動する shell で、指定したキーを export します。
export CUSTOM_OPENAI_API_KEY="your-token"認証情報は環境変数またはエージェント自身のログインストアに保存してください。リポジトリ、スクリーンショット、WebSocket URL に token を入れないでください。
custom provider には専用 shell を使ってください
ローカル ACP adapter は、上記の provider 変数だけでなく、Busabase server process の環境全体を引き継ぎます。無関係な GitHub、cloud、database、production の secret を含む deployment・管理用 shell から Busabase を起動しないでください。また、GUI から起動した Desktop app は、ターミナルで export した変数を確実には引き継ぎません。環境変数だけで設定する provider では shell から server を起動してください。
Busabase を起動する
Claude Code または Codex が永続的なログインストアを使う場合は、Busabase Desktop を通常どおり開きます。上記で custom-provider 変数を export した場合は、その同じ専用ターミナルからオープンソース版 server を起動します。
npx busabase serverこのリポジトリから作業する場合は、次を実行します。
pnpm --filter busabase devserver とターミナルは開いたままにします。固定バージョンの ACP adapter は Busabase の child process として動き、その process environment を引き継ぎます。
Claude Code または Codex を接続する
- Dashboard → Agents を開きます。
- Add agent を選びます。
- Claude Code または Codex CLI を探し、Connect を選びます。
- 新しいチャットに
idleと表示されるまで待ちます。
初回は npx が固定バージョンの ACP adapter をダウンロードするため、時間がかかる場合があります。起動コマンドは Busabase が管理するため、ACP WebSocket URL を貼り付けたり acpremote mirror を実行したりする必要はありません。
最初の prompt の前にモデルを選ぶ
エージェントが ACP でモデル候補を公開すると、添付ボタンの横に Model メニューが表示されます。モデルを選び、選択した名前がそのまま表示されるまで待ちます。Busabase はエージェント側の変更完了を確認してから prompt 送信を有効にします。
モデル option を公開しないエージェントではメニューは表示されません。Busabase が独自のモデル一覧を追加することはありません。
最初のメッセージを送る
メッセージを入力して送信します。自分のメッセージがすぐ表示され、処理中は status が変わり、同じ会話に返信が表示されます。turn が完了すると status は idle に戻り、選んだモデルも維持されます。
コマンド実行やファイル編集の許可を求められた場合、Busabase は permission card を表示します。内容を確認し、エージェントが提示した option から選んでください。
トラブルシューティング
card に npx が見つからないと表示される
Busabase を実行しているコンピューターに Node.js をインストールし、Busabase を再起動して Agents → Add agent に戻ります。
Busabase Cloud でローカルエージェントを使えない
Cloud の共有 infrastructure では Claude Code や Codex を起動できません。Busabase Desktop、ローカルのオープンソース版 server、または Local↔Cloud Tunnel を使ってください。
接続中にエージェントが終了する
同じ account と shell 環境で claude auth status または codex login status を実行します。custom provider を使う場合は、Busabase を起動する前に key が export されていることを確認し、Busabase を再起動します。
Model メニューが表示されない
接続した ACP adapter がモデル設定 option を公開していません。エージェントと Busabase を更新して再接続してください。メニューがなくても、エージェントの既定モデルで prompt を送信できます。