docs: add cross-references to Claude integration guide

Add reference links to the new Claude integration guide in: - agents.md - Add link to the detailed guide - create-template.md - Add tip box for Claude configuration - headless.md - Add reference to multiple Claude usage modes - index.md - Add a quick start tip recommending Claude These changes maintain the existing examples while providing clear pathways to more detailed information. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
coder · EdwardAngert · May 2, 2025 · May 2, 2025 · May 2, 2025 · May 2, 2025
commit f4b1c24971ddc60fcad5ecea8546b3df1dd50e61
diff --git a/docs/ai-coder/agents.md b/docs/ai-coder/agents.md
@@ -54,6 +54,8 @@ Additionally, with Coder, headless agents benefit from:
 
 [Claude Code](https://github.com/anthropics/claude-code) is our recommended
 coding agent due to its strong performance on complex programming tasks.
+See our [detailed Claude integration guide](./claude-integration.md) for comprehensive
+setup and usage instructions.
 
 > [!INFO]
 > Any agent can run in a Coder workspace via our [MCP integration](./headless.md),

diff --git a/docs/ai-coder/create-template.md b/docs/ai-coder/create-template.md
@@ -42,6 +42,10 @@ Follow the instructions in the Coder Registry to install the module. Be sure to
 enable the `experiment_use_screen` and `experiment_report_tasks` variables to
 report status back to the Coder control plane.
 
+> [!TIP]
+> For Claude users: For advanced configuration options, VS Code integration, 
+> and detailed usage instructions, see our [comprehensive Claude integration guide](./claude-integration.md).
+
 > Alternatively, you can [use a custom agent](./custom-agents.md) that is
 > not in our registry via MCP.
 

diff --git a/docs/ai-coder/headless.md b/docs/ai-coder/headless.md
@@ -40,6 +40,10 @@ coder exp mcp configure claude-desktop # Configure Claude Desktop to interact wi
 coder exp mcp configure cursor # Configure Cursor to interact with Coder
 ```
 
+> [!TIP]
+> The Claude integration offers multiple usage modes. See our [complete Claude integration guide](./claude-integration.md) 
+> for details on CLI, VS Code, and headless options.
+
 > MCP is also used for various agents to report activity back to Coder. Learn more about this in [custom agents](./custom-agents.md).
 
 ## Coder CLI

diff --git a/docs/ai-coder/index.md b/docs/ai-coder/index.md
@@ -22,6 +22,10 @@ With Coder, you can self-host AI agents in isolated development environments wit
 
 ![AI Agents in Coder](../images/guides/ai-agents/landing.png)
 
+> [!TIP]
+> **Looking for a quick start?** We recommend [Claude Code](https://github.com/anthropics/claude-code) as the most capable AI coding agent.
+> See our [detailed Claude integration guide](./claude-integration.md) for step-by-step setup instructions.
+
 ## Prerequisites
 
 Coder is free and open source for developers, with a [premium plan](https://coder.com/pricing) for enterprises. You can self-host a Coder deployment in your own cloud provider.