|
63 | 63 | { |
64 | 64 | "cell_type": "markdown", |
65 | 65 | "metadata": {}, |
66 | | - "source": [ |
67 | | - "## 2. Setup & Installation {#setup}\n", |
68 | | - "\n", |
69 | | - "### Prerequisites\n", |
70 | | - "\n", |
71 | | - "- Python 3.8 or higher\n", |
72 | | - "- Anthropic API key with BYOC access from [console.anthropic.com](https://console.anthropic.com/)\n", |
73 | | - "- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI installed on your runner infrastructure\n", |
74 | | - "- Infrastructure to run the BYOC worker (VM, container, etc.)" |
75 | | - ] |
| 66 | + "source": "## 2. Setup & Installation {#setup}\n\n### Prerequisites\n\n- Python 3.11 or higher\n- Anthropic API key with BYOC access from [console.anthropic.com](https://console.anthropic.com/)\n- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI installed on your runner infrastructure\n- Infrastructure to run the BYOC worker (VM, container, etc.)" |
76 | 67 | }, |
77 | 68 | { |
78 | 69 | "cell_type": "code", |
|
91 | 82 | { |
92 | 83 | "cell_type": "markdown", |
93 | 84 | "metadata": {}, |
94 | | - "source": [ |
95 | | - "### Configure API Key" |
96 | | - ] |
| 85 | + "source": "### Configure API Key\n\nCreate a `.env` file in this directory with the following environment variables:\n\n```\nANTHROPIC_API_KEY=sk-ant-... # Your Anthropic API key\nANTHROPIC_SERVICE_KEY=... # Environment service key (generated in Console)\nANTHROPIC_ORG_ID=... # Your Anthropic organization ID\n```\n\n- **`ANTHROPIC_API_KEY`** - Required for all API calls. Get yours from [console.anthropic.com](https://console.anthropic.com/).\n- **`ANTHROPIC_SERVICE_KEY`** - Required to authenticate the Environment Runner. Generate this in the Console under your environment settings.\n- **`ANTHROPIC_ORG_ID`** - Required to identify your organization when running the Environment Runner." |
97 | 86 | }, |
98 | 87 | { |
99 | 88 | "cell_type": "code", |
|
326 | 315 | { |
327 | 316 | "cell_type": "markdown", |
328 | 317 | "metadata": {}, |
329 | | - "source": [ |
330 | | - "### Starting the Runner\n", |
331 | | - "\n", |
332 | | - "The runner uses `orchestrator` mode to poll for work and process sessions. Key flags:\n", |
333 | | - "\n", |
334 | | - "| Flag | Description |\n", |
335 | | - "|------|-------------|\n", |
336 | | - "| `--organization-id` | Your Anthropic organization ID |\n", |
337 | | - "| `--environment-id` | The BYOC environment to serve |\n", |
338 | | - "| `--service-key-file` | Path to the environment service key file |\n", |
339 | | - "| `--sandbox-backend` | Sandbox type (`none` for macOS dev, `srt` for Linux production) |\n", |
340 | | - "\n", |
341 | | - "> **Note:** On macOS, use `--sandbox-backend=none` since the Linux sandbox runtime (`srt`) is not available. In production Linux environments, omit this flag to use the default sandbox for security isolation." |
342 | | - ] |
| 318 | + "source": "### Starting the Runner\n\nThe runner uses `orchestrator` mode to poll for work and process sessions. Key flags:\n\n| Flag | Description |\n|------|-------------|\n| `--organization-id` | Your Anthropic organization ID |\n| `--environment-id` | The BYOC environment to serve |\n| `--service-key-file` | Path to the environment service key file |\n| `--sandbox-backend` | Sandbox type (`none` for macOS dev, `srt` for Linux production) |\n\n> **Security Warning:** The `--sandbox-backend=none` flag **disables all security isolation** for code execution. This means agent-generated code runs directly on your host machine without any sandboxing. **Only use this for local development and testing.** In production, always use the default sandbox backend (`srt` on Linux) to ensure that agent sessions are isolated from your host system and from each other.\n\n> **Note:** On macOS, use `--sandbox-backend=none` since the Linux sandbox runtime (`srt`) is not available. In production Linux environments, omit this flag to use the default sandbox for security isolation." |
343 | 319 | }, |
344 | 320 | { |
345 | 321 | "cell_type": "code", |
|
0 commit comments