docs: Document Claude Code on the web sandbox config (#2616)

Author: TC-MO

sources/_partials/_claude-code-web-egress.mdx

@@ -0,0 +1,18 @@
+:::info Allow Apify in Claude Code on the web
+
+If you're using Claude Code on the web, your cloud sessions run inside a network-restricted sandbox. By default, the sandbox blocks outbound requests to `*.apify.com`, making documentation, the API, and the MCP server unreachable.
+
+To grant access, add `*.apify.com` to a cloud environment's allowed domains:
+
+1. Open the environment selector and select **Add environment**.
+1. Set **Network access** to **Custom**.
+1. Check **Also include default list of common package managers** so existing functionality stays intact.
+1. Add `*.apify.com` to the **Allowed domains** list.
+
+Alternatively, set **Network access** to **Full** to allow any domain.
+
+For more details, see [Claude Code on the web: Network access](https://code.claude.com/docs/en/claude-code-on-the-web#network-access).
+
+Codex Cloud uses a similar default-deny sandbox. See [Codex Cloud internet access](https://developers.openai.com/codex/cloud/internet-access) for the equivalent configuration.
+
+:::

sources/platform/actors/development/quick-start/build_with_ai.md

@@ -11,6 +11,7 @@ import { AGENTS_PROMPT } from "@site/src/utils/agents-prompt";
 import PromptButton from "@site/src/components/PromptButton";
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
+import ClaudeCodeWebEgress from '@site/sources/_partials/_claude-code-web-egress.mdx';
 
 This guide provides best practices for building new Actors or improving existing ones using AI code generation tools by providing the AI agents with the right instructions and context.
 
@@ -29,7 +30,7 @@ The methods on this page are complementary. Start with the [AI coding assistant
 <TabItem value="prompt" label="Start with a prompt">
 
 1. Create a directory: `mkdir my-new-actor`.
-1. Open the directory in _Cursor_, _Claude Code_, _VS Code with GitHub Copilot_, etc.
+1. Open the directory in _Cursor_, _Claude Code_, _VS Code with GitHub Copilot_, etc. Using Claude Code on the web? See the setup note below first.
 1. Copy the [AI coding assistant prompt](#ai-coding-assistant-instructions) and paste it into your AI coding assistant.
 1. Run it, and develop your first Actor with the help of AI.
 
@@ -38,12 +39,14 @@ The methods on this page are complementary. Start with the [AI coding assistant
 
 1. [Install the Apify CLI](/cli/docs/installation) if you haven't already.
 1. Run `apify create` to initialize an Actor from a [template](https://apify.com/templates) (includes AGENTS.md).
-1. Open the project in _Cursor_, _Claude Code_, _VS Code with GitHub Copilot_, etc.
+1. Open the project in _Cursor_, _Claude Code_, _VS Code with GitHub Copilot_, etc. Using Claude Code on the web? See the setup note below first.
 1. Start developing - your AI coding assistant automatically picks up context from AGENTS.md.
 
 </TabItem>
 </Tabs>
 
+<ClaudeCodeWebEgress />
+
 ## AI coding assistant instructions
 
 Use the following prompt in your AI coding assistant such as [Cursor](https://cursor.com/), [Claude Code](https://claude.com/product/claude-code), or [GitHub Copilot](https://github.com/features/copilot):

sources/platform/integrations/ai/agent-onboarding.md

@@ -9,6 +9,7 @@ toc_max_heading_level: 3
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
+import ClaudeCodeWebEgress from '@site/sources/_partials/_claude-code-web-egress.mdx';
 
 Connect your AI agent or application to Apify - the platform for web scraping, data extraction, and browser automation. The typical agent workflow: find an Actor, run it, get structured data back.
 
@@ -22,11 +23,7 @@ Connect your AI agent or application to Apify - the platform for web scraping, d
 
 Sign up to [Apify Console](https://console.apify.com/sign-up). The free plan includes monthly platform usage credits with no credit card required. Get your API token from **[Console > Settings > Integrations](https://console.apify.com/settings/integrations)**.
 
-:::tip Free exploration
-
-The MCP server's `search-actors`, `fetch-actor-details`, and docs tools work without authentication. You can browse Actors and documentation without an account.
-
-:::
+<ClaudeCodeWebEgress />
 
 ## Run your first Actor
 
@@ -111,6 +108,12 @@ See [Usage and resources](/platform/actors/running/usage-and-resources) and [Bil
 
 The [Apify MCP server](/platform/integrations/mcp) connects your agent to the full Apify platform via the [Model Context Protocol](https://modelcontextprotocol.io/). No local installation needed for remote-capable clients.
 
+:::tip Free exploration
+
+The MCP server's `search-actors`, `fetch-actor-details`, and docs tools work without authentication. You can browse Actors and documentation without an account.
+
+:::
+
 #### Remote (recommended)
 
 Works with Claude Code, Cursor, VS Code, GitHub Copilot, and other remote-capable clients.