この記事でやること
-
osFoundryのWorkerロールに
cli:claude:agentを付けたあと、本当にClaude Codeが自分のサブスクで動いているかを確かめる - 確認は「バイナリ」「ログイン」「課金の経路」「作業フォルダ」「ロールのID」「ツールの見え方」の6か所
- それぞれ、ターミナルで叩くコマンドか、デスクトップアプリで見る場所を1つずつ挙げる
前提・環境
- macOSのosFoundryデスクトップアプリ
- Claude CodeのCLIを入れていて、Claudeのサブスクがある
- 設定 → ローカルフォルダに、作業させたいプロジェクトを1つ以上追加済み
- 「パイプライン」タブ →「パイプラインロール」でWorkerに
cli:claude:agentを選択済み
ここから先のコマンドはすべて自分のMacで叩くものです。osFoundryの設定ファイルを書き換えるものはありません。
1. バイナリが見つかる場所にあるか
osFoundryが claude を探すのは次の3か所です。
PATH~/.claude/local- VS Code拡張の同梱バイナリ（
~/.vscode/extensions/anthropic.claude-code-*/resources/native-binary/claude）
どこに入っているかは、次の3行で分かります。
command -v claude
ls -l ~/.claude/local/claude 2>/dev/null
ls -d ~/.vscode/extensions/anthropic.claude-code-*/resources/native-binary/claude 2>/dev/null
どれか1行でもパスが出れば、osFoundryからも見つかります。VS Code拡張でしか入れていない場合は、3行目だけが当たります。ターミナルで claude が打てなくても、osFoundryからは使えます。
アプリ側では、鍵アイコン（APIキー（BYOK））→「外部AI」タブのClaude Codeの行で確かめます。「インストール済み」の下に、見つかったパスが出ています。
Claude Code インストール済み [有効]
/Users/you/.claude/local/claude
モデルID： cli:claude （チャット） · cli:claude:agent （自律）
[サインインを確認] [サインイン]
表示例：外部AIタブのClaude CodeとCodex
2. ログインが通っているか
同じ行の「サインインを確認」を押します。CLI経由で小さな補完を1回走らせ、結果が「✓ サインイン済み」か「サインインが必要」で出ます。
「サインインが必要」なら、隣の「サインイン」を押します。ターミナルのウィンドウでClaude Codeが開き、英語で "Type /login to sign in, then close this window." と出ます。そのまま /login を打ってログインし、ウィンドウを閉じてから、もう一度「サインインを確認」を押します。
$ claude
> /login
ログイン情報はCLIが自分で保存します。osFoundryはその中身には触れません。
3. API課金に流れていないか
ここがいちばんハマりやすいところです。osFoundryを起動した環境に ANTHROPIC_API_KEY などが入っていると、外部AIタブに「環境内のAPIキー」のバッジが出ます。
env | grep -E '^ANTHROPIC_' | sed 's/=.*/=<set>/'
値そのものは表示しないように sed で伏せています。何か出てきても、慌てて消す必要はありません。デスクトップアプリは claude を起動する前に、子プロセスの環境からこれらを外します。なので実行はサブスクのままです。バッジは「この環境にはキーがある」という注意書きです。
課金の経路は、実行の記録でも確かめられます。サブスクでの実行はコスト0として記録されます。
4. 作業フォルダはどれになるか
エージェントモードは実在するディレクトリで動き、Claude Codeが読み書きできるのはそのフォルダの中だけです（--add-dir）。どのフォルダになるかは次の順で決まります。
| 状況 | 使われるフォルダ |
|---|---|
| Codeサーフェスから始めた実行 | その実行に登録したリポジトリ |
| それ以外 | 設定 → ローカルフォルダのうち、一番新しく追加したもの |
ローカルフォルダを複数登録している場合は注意が要ります。「さっき足したテスト用のフォルダで動いていた」というのは、この順番どおりの挙動です。意図したフォルダで動かしたいなら、そのフォルダを最後に追加し直すか、Codeサーフェスから始めます。
5. ロールに付けたIDは合っているか
外部AIタブには、IDが2つ並んでいます。役割がはっきり違います。
| ID | モード | ツール | 向いているロール |
|---|---|---|---|
cli:claude:agent |
自律 | フォルダ内のClaude Code自身のツール ＋ ブリッジ経由のosFoundryのツール | Worker、Researcher、Document Agent など |
cli:claude |
チャット | なし（--disallowedTools '*' 付きで起動） |
Titling、Compaction などテキストだけのロール |
ツールが要るロールに cli:claude を付けると、cli:claude:agent を使うよう促すメッセージが出て、そこで止まります。これは付け間違いに気づくための表示です。メッセージを見たら、「パイプラインロール」でIDを付け直します。
エージェント画面で作るエージェントの場合は、モデル選択のCLI agentsの下に「自律型（ローカルフォルダで実行）」付きで出ているほうを選びます。
6. ツール呼び出しがどう見えるか
試しに、osFoundryのノートとフォルダ内のファイルの両方に触る小さなタスクを流します。以下は表示例です。
ノートから次の定例の日時を探して、NOTES.mdの末尾に1行追記して。
実行中のチャットには、ツール呼び出しが1件ずつ「Using …」の行で流れます。
Using memory_search — {"query":"定例"}
Using Read — {"file_path":"NOTES.md"}
Using Edit — {"file_path":"NOTES.md", …}
ここで見るポイントは3つです。
-
memory_searchが出ていれば、MCPブリッジ経由でosFoundryのツールが呼べています。Claude Codeの中ではmcp__osfoundry__memory_searchという名前ですが、進捗行では接頭辞が外れて表示されます -
ReadやEditは、Claude Code自身のツールです。ファイルの中身はosFoundryを通らず、Claude Codeが直接読み書きします -
read_file、write_file、execute_commandは出てきません。ブリッジはこの3つをわざと出していません。フォルダ内に限定された同じ機能が、Claude Codeにすでにあるからです
よくある疑問
自分で入れたMCPサーバーもワーカーから使えますか
この実行では使われません。osFoundryは --strict-mcp-config 付きでCLIを起動するので、グローバルやプロジェクトに登録したMCPサーバーは混ざりません。付くのは osfoundry の1つだけです。ターミナルで普段どおり claude を使うときは、これまでどおり自分の設定が読まれます。
リストにないツールをClaude Codeが呼んだらどうなりますか
ブリッジがJSON-RPCのエラーを返します。文面は "tool '…' is not available to this agent" です。許可リストはCLIのフラグではなくブリッジ側で照合しているので、bypassPermissions で動いていても、この判定は変わりません。
承認ダイアログはいつ出ますか
フォルダ内のClaude Code自身の操作には出ません（--permission-mode bypassPermissions）。ブリッジ経由のosFoundryのツールは、ほかのモデルと同じ承認・ポリシーのゲートを通ります。画面やCanvasエディタへの書き込み（ui_agent_act など）は毎回確認が出ます。チャンネルのメンションへの応答のように誰も見ていない実行では、承認の要るツールは待たずに断ります。
実行のたびにポートが変わるのは正常ですか
正常です。ブリッジは実行ごとに 127.0.0.1 の新しいポートと新しいトークンで立ち上がり、プロセスが終わるとリスナーも閉じます。ワークスペースとチャンネルも、ブリッジを立てた時点で固定されます。
Workerのほかにも割り当てられますか
割り当てられます。Researcherなど、ツールを使うロールなら cli:claude:agent が付けられます。割り当てられるロールの一覧はパイプラインロールのページにあります。作業フォルダの決まり方はローカルフォルダのページにまとまっています。
まとめ
- バイナリは
PATH、~/.claude/local、VS Code拡張の3か所のどこかにあれば見つかります - 環境にAPIキーがあっても、子プロセスからは外されるのでサブスクのまま動きます
- 作業フォルダは「Codeサーフェスのリポジトリ」か「一番新しく追加したローカルフォルダ」です
- 進捗行に
memory_searchとRead/Editの両方が並べば、2系統のツールが両方通っています