BBT for BBT Indonesia

Posted on Nov 7

Menjalankan Claude Code sebagai worker osFoundry dengan langganan Claude sendiri

#claude #mcp #osfoundry #tutorial

Setelah setup ini selesai, role Worker di osFoundry dipegang oleh Claude Code. Saat sebuah langkah dalam plan sampai ke Worker, aplikasi desktop menjalankan claude di folder proyek kamu, dengan login langganan Claude milikmu sendiri. Claude Code mengedit file dengan tool-nya sendiri dan memanggil tool osFoundry, misalnya pencarian di catatan kamu, sebagai mcp__osfoundry__memory_search. Setiap panggilan itu muncul di chat osFoundry sebagai baris "Using …".

Siapa mengerjakan apa

	Claude Code	Aplikasi desktop osFoundry
Login	Langganan Claude kamu, disimpan oleh CLI setelah `/login`	Tidak pernah melihatnya. Menghapus `ANTHROPIC_API_KEY` dan variabel sejenis dari environment proses anak supaya run tidak beralih ke tagihan API
Biaya	Diambil dari langganan kamu	Mencatat run dengan biaya 0
File	Read, Edit, dan Bash miliknya sendiri, di dalam satu folder (`--add-dir`)	Memilih folder itu: yang paling baru di Local Folders
Tool osFoundry	Memanggilnya sebagai `mcp__osfoundry__<tool>`	Menyajikannya di port loopback khusus untuk run ini, dan mencocokkan setiap panggilan dengan allowlist
Persetujuan	Berjalan dengan `--permission-mode bypassPermissions` di foldernya	Setiap panggilan lewat bridge melewati gerbang persetujuan dan policy yang sama dengan panggilan tool dari model lain
Output	Teks akhir	Menjadi output role. Aktivitas tool ditampilkan sebagai baris progres

Setup

1. Instal Claude Code dan login sekali

Instal CLI sesuai dokumentasi Anthropic. Lalu login dari terminal:

$ claude
> /login

osFoundry mencari binary-nya di PATH, di ~/.claude/local, dan di dalam bundle ekstensi VS Code (~/.vscode/extensions/anthropic.claude-code-*/resources/native-binary/claude). Jadi Claude Code yang hanya terpasang lewat ekstensi VS Code juga tetap ketemu.

2. Aktifkan di External AI

Di aplikasi desktop, klik ikon kunci di header (API Keys (BYOK)), lalu buka tab External AI (AI eksternal). Baris Claude Code seharusnya terlihat seperti ini:

Claude Code   Installed                                  [Enabled]
/Users/you/.claude/local/claude
Model id: cli:claude (chat) · cli:claude:agent (autonomous)
[Verify sign-in]  [Sign in]

Contoh: Claude Code dan Codex di tab External AI

Klik Verify sign-in (cek login). Aplikasi menjalankan completion kecil lewat CLI dan menampilkan ✓ Signed in atau Needs sign-in. Sign in membuka Claude Code di jendela terminal dengan petunjuk "Type /login to sign in, then close this window."

Mungkin kamu melihat badge API key in env. Artinya ada variabel seperti ANTHROPIC_API_KEY yang terpasang di environment tempat osFoundry dijalankan. Aplikasi menghapusnya sebelum menjalankan claude, jadi run tetap memakai langganan kamu. Badge itu hanya pemberitahuan.

3. Berikan folder

Agent mode bekerja di direktori sungguhan. Tambahkan proyek kamu di Settings → Local Folders. Kalau ada beberapa, yang terakhir ditambahkan yang dipakai. Run yang dimulai dari surface Code memakai repository yang didaftarkan untuk run itu.

4. Pasang ke role

Buka tab Pipeline → Pipeline Roles. Di bagian Agents, pilih Worker lalu pilih cli:claude:agent dari grup External AI (subscription).

Kedua id itu adalah dua mode yang berbeda:

cli:claude:agent bersifat otonom. Claude Code punya tool-nya sendiri di folder kamu, ditambah tool osFoundry lewat bridge. Pakai untuk Worker, Researcher, Document Agent, dan role sejenis.
cli:claude adalah mode chat. CLI berjalan dengan --disallowedTools '*' dan tidak bisa memanggil apa pun. Cocok untuk role yang hanya teks seperti Titling atau Compaction. Kalau role yang butuh tool dipasang ke id ini, run gagal dengan pesan yang menyuruh kamu memakai cli:claude:agent.

Agent yang kamu buat di layar Agents juga bisa memakainya. Pemilih modelnya mencantumkannya di bawah CLI agents, dengan label "autonomous — runs in your local folder".

5. Apa yang sebenarnya dijalankan aplikasi

Untuk setiap run, osFoundry menyalakan MCP bridge baru, lalu menjalankan CLI kurang lebih seperti ini. Flag-nya diambil dari build_claude_command di src-tauri/src/providers/agent_cli.rs:

claude -p "<conversation>" \
  --output-format stream-json --verbose --include-partial-messages \
  --permission-mode bypassPermissions \
  --add-dir /Users/you/work/site \
  --mcp-config '{"mcpServers":{"osfoundry":{"type":"http",
      "url":"http://127.0.0.1:<port>/mcp",
      "headers":{"Authorization":"Bearer <per-run token>"},
      "timeout":120000}}}' \
  --strict-mcp-config \
  --append-system-prompt "<role prompt>"

--strict-mcp-config menjaga server MCP global atau proyek milikmu sendiri tetap di luar run ini. Hanya server osfoundry yang terpasang. Port dan token selalu baru di setiap run, dan listener ditutup begitu prosesnya selesai.

Contoh run sungguhan

Contoh. Catatan dan repository-nya adalah konten demo.

Kamu (chat Maestro, Worker = cli:claude:agent)
  Cari di catatanku kapan review anggaran Q4, lalu tambahkan ke TODO.md.

Panggilan tool Claude Code
  mcp__osfoundry__memory_search  {"query": "review anggaran Q4"}
    → "Review anggaran Q4: Kam 14:00."
  Read   TODO.md
  Edit   TODO.md   (+ "- [ ] Siapkan angka untuk review anggaran Q4 (Kam 14:00)")

Baris progres osFoundry
  Using memory_search — {"query":"review anggaran Q4"}
  Using Read — {"file_path":"TODO.md"}
  Using Edit — {"file_path":"TODO.md", …}

Jawaban
  "Siapkan angka untuk review anggaran Q4 (Kam 14:00)" sudah ditambahkan ke TODO.md.
  Waktunya diambil dari catatan kamu "Review anggaran Q4: Kam 14:00."

Prefiks mcp__osfoundry__ adalah cara Claude Code menamai tool dari server bernama osfoundry. osFoundry membuangnya di baris progres, jadi memory_search terbaca sama seperti saat memakai model API.

Di mana batasnya

Bridge menawarkan daftar yang pendek dan tetap. Isinya tool read-only seperti memory_search, web_search, extract_content, code_search, todo_list, transcribe dan tool baca cloud_*, ditambah orkestrasi (spawn_fleet, graph_run, loop_run), layar live, dan tool Canvas. read_file, write_file, dan execute_command sengaja tidak dimasukkan. Claude Code sudah punya versi tool itu yang terbatas pada foldernya, dan executor kedua tanpa batas lewat MCP bisa menjangkau di luar --add-dir.

Allowlist ditegakkan oleh bridge, bukan oleh flag CLI. Run dalam mode bypassPermissions tidak menghormati --allowedTools, jadi osFoundry tidak mengirimkannya. Panggilan ke tool apa pun di luar daftar run mendapat error JSON-RPC: "tool '…' is not available to this agent".

Workspace dan channel dikunci saat bridge dimulai. Panggilan tool tidak bisa mengalihkan dirinya ke workspace lain lewat argumennya.

Penulisan ke layar atau ke editor Canvas (ui_agent_act, tool tulis Canvas) selalu meminta izin kamu dulu, sama seperti dengan model API. Run yang tidak sedang diawasi siapa pun, misalnya agent yang menjawab mention di channel, menolak tool yang butuh persetujuan alih-alih menunggu klik yang tidak akan datang.

File kamu tidak pernah melewati osFoundry. Claude Code membaca dan mengeditnya langsung, dan trafiknya menuju Anthropic dengan login kamu sendiri, sama seperti di terminal.

Langkah berikutnya adalah memasang cli:claude:agent juga ke role Researcher, di samping Worker, lalu menjalankan satu task yang diorkestrasi. Halaman Pipeline roles mencantumkan semua role yang bisa kamu serahkan kepadanya, dan Local Folders menjelaskan cara folder kerja dipilih.

DEV Community