SUPPORT
Sanary Build Interface Support
SBIの使い方や、よくある質問をご案内します。
GETTING STARTED
はじめに
SBIは、VS CodeでClaude CodeやCodexを実行し、結果を表示する無料の拡張機能です。実行するCLIは、あなたがインストールしたものです。
- 拡張機能をインストール
- ワークスペースのフォルダを開く
- コマンドパレットで「SBI: Run Agent」を実行(Chatなら「@sbi /claude」「@sbi /codex」)
- Agent(Claude CodeまたはCodex)を選び、指示を入力
- 結果を「SBI」の出力パネルと通知で確認
SBIは、Sanaryにデータを送りません。
アカウント不要、テレメトリなし。通信はMac内の127.0.0.1に限られます。
FAQ
よくある質問
SBIは無料ですか?
はい。SBIは無料で、アカウントも不要です。
動作環境を教えてください。
macOS 13以降のApple Silicon(arm64)と、VS Code 1.100以降です。IntelのMac、Windows、Linuxでは動作しません。Claude Code CLIまたはCodex CLI(使うほう)が必要です。
「Claude Code / Codexが見つからない」と表示されます。
SBIが、実行に使うCLIを見つけられていません。VS Codeの設定 sbi.claudeCodeExecutablePath / sbi.codexExecutablePath にフルパスを指定するか、環境変数 CLAUDE_CODE_EXECUTABLE_PATH / CODEX_EXECUTABLE_PATH、またはPATHをご確認ください。SBIがCLIを自動でインストールすることはありません。
SBBがなくても使えますか?
はい。SBB(Sanary Build Bridge)は任意です。なくてもAgentは通常どおり動作し、評価は「利用不可」と表示されます(承認としては扱いません)。
「:8788 が使用中」と表示されます。
別のプログラムがポート8788を使っています。SBI同梱のRuntimeは 127.0.0.1:8788 を使います。そのプログラムを終了して、VS Codeのウィンドウを再読み込みしてください。
「Runtimeが古い」または「localRequestGuard」という警告が出ます。
すでに動いているRuntime(たとえば古いSBBが内蔵しているもの)が、新しい安全確認(ブラウザ上のWebページからのリクエストを拒否する仕組み)に対応していない場合に表示されます。動作は続きますが、SBIはそのRuntimeを止めたり置き換えたりしません。同梱の新しいRuntimeを使うには、その古いRuntimeを終了して、ウィンドウを再読み込みしてください。
SBIは何を書き換えますか? 無効化・アンインストールすると?
Claude Code / Codexのhook登録のため、~/.claude/settings.json、~/.codex/hooks.json(と ~/.codex/config.toml のSBI管理ブロック)、~/.sbi/hooks を書き換えます。ほかの設定は保持します。無効化・VS Codeの終了では、何も書き戻しません。アンインストールすると、SBIが追加したものだけを取り除きます(VS Codeの次回起動時に一度だけ実行)。
VS Codeのウィンドウを複数開いても大丈夫ですか?
はい。すべてのウィンドウが1つのRuntimeを共有します。Runtimeを起動したウィンドウを閉じても、残りのウィンドウが約20秒で新しいRuntimeを起動します。そのとき、閉じたウィンドウのRuntime経由で実行中だったAgentは中断されます。
Xcodeとの関係は?
SBIの拡張機能は、Xcodeの設定を書き換えません。SBIのRuntimeは、同じMac上のXcode内蔵のコーディングエージェントを読み取り専用で観察できます。
PRIVACY
プライバシーについて
SBIは、アカウント・サーバー保存・解析ツールを使わず、Sanaryへデータを送りません。Sanaryプライバシーポリシーでは、このようなアプリは個人情報を収集しないものとされています。SBIがMacの中で行うことは、次のとおりです。
- 書き込む:
~/.claude/settings.jsonと~/.codex/hooks.jsonのSBIのhook項目、~/.codex/config.tomlのSBI管理ブロック、~/.sbi/hooks/(hook用の小さなヘルパー)。 - 読み取る:Claude Codeのセッションファイル(
~/.claude/sessions)、Codexのセッション記録(~/.codex/sessions)、開いているワークスペースのファイル変更・デバッグ・ターミナルの動き(「作業中」の判定用。ターミナルに入力した内容は読みません)。 - hookが渡す:hookが動くと、プロンプト、作業ディレクトリ、Agentの最後の返答が、Mac内のSBI Runtimeへ渡され、SBBが起動していれば評価のためSBBへ送られます。
SBB・SBG・SBRを使う場合
SBB(SBGを内蔵)が起動していると、SBIのRuntimeはMac内のSBG(127.0.0.1:8790)へ、次の内容だけを渡します。
- ワークスペースのフォルダ名と、パスの一方向ハッシュ、そのワークスペースが開かれていて作業中かどうか、Claude Code / Codexが動いているかどうか。
- SBBやSBRから送られた指示でAgentが動いた場合の作業状況:指示の冒頭(最大100文字)と、結果またはSBBの指摘を示す短い行(それぞれ最大160文字)。
- Claude Code / Codexのhook:プロンプトの最初の1行(最大40文字)と、SBBの判断の短い理由。
プロンプトや返答の全文は、SBGへは送られません(SBBにだけ、Mac内で評価のために渡されます)。SBGはこれらをメモリに保持し、保存するのはペアリング情報とRemote Accessの設定だけです。SBR(iPhone)とペアリングすると、SBGがペアリング時に発行した端末の資格情報で認証したうえで、同じローカルネットワークを通じて、あなたのiPhoneにだけ提供します。SBIもSBGも、これらをSanaryのサーバーへは送りません。
CONTACT
解決しない場合
FAQで解決しない場合はお問い合わせください。以下の情報があると、状況を確認しやすくなります。
- SBI version(拡張機能のバージョン)
- VS Code version
- macOS versionとMacのモデル
- 「SBI」出力パネルのログ(機密情報は除いてください)
- Claude Code / Codexのバージョン、発生している操作
パスワード、APIキー、Apple ID、購入情報などの機密情報は送らないでください。ログや画面の画像を添える場合も、機密情報が含まれていないことをご確認ください。