diff --git a/docs/organization/integrations/coding-agents/claude/index.mdx b/docs/organization/integrations/coding-agents/claude/index.mdx
index f622fdcfebe96..27757bea582d9 100644
--- a/docs/organization/integrations/coding-agents/claude/index.mdx
+++ b/docs/organization/integrations/coding-agents/claude/index.mdx
@@ -25,6 +25,18 @@ Sentry Owner, Manager, or Admin permissions are required to install this integra
 2. In Sentry, navigate to **Settings > Integrations** and search for **Claude Agent**.
 
 3. Enter your API key. If your workspace isn't "default" or you want to use a specific environment, update those fields here, then save.
+<Alert level="warning">
+
+If you connect your own Claude environment, it needs access to GitHub so the agent can push a branch with the generated fix.
+
+ In your Claude workspace environment settings, either:
+
+- Add **api.githubcopilot.com** to the list of allowed network hosts
+- Allow **MCP server network access**.
+
+Without one of these, the agent session will not run.
+
+</Alert>
 <br />
 
     <Arcade src="https://demo.arcade.software/GmQwOB82wAeELf3lr43h?embed&show_copy_link=true" width="75%" />