diff --git a/docs/capabilities/claude-code.mdx b/docs/capabilities/claude-code.mdx
index da4b665af..2137fe197 100644
--- a/docs/capabilities/claude-code.mdx
+++ b/docs/capabilities/claude-code.mdx
@@ -77,9 +77,21 @@ Remote execution benefits:
 
 ## Getting Started
 
+### Prerequisites
+
+Before using Claude Code with Codegen, you need to have Claude Code installed on your system:
+
+<Warning>
+  **Claude Code must be installed separately.** The `codegen claude` command requires the Claude Code binary to be available in your system PATH.
+</Warning>
+
+Install Claude Code from Anthropic:
+- Visit [claude.ai/code](https://claude.ai/code) to download and install Claude Code
+- Ensure the `claude` command is available in your terminal by running `which claude`
+
 ### Local Claude with Cloud Benefits
 
-Get up and running in three simple steps:
+Once Claude Code is installed, get up and running in three simple steps:
 
 1. Install the Codegen CLI:
 
@@ -100,11 +112,6 @@ Get up and running in three simple steps:
 
 Your session immediately appears in the cloud with full integration access.
 
-<Tip>
-  The first time you run `codegen claude`, it will download the Claude Code
-  binary. Subsequent runs start instantly.
-</Tip>
-
 ## Analytics and Insights
 
 Transform your Claude Code usage into actionable intelligence. The analytics dashboard provides deep insights into how AI is transforming your development workflow.