diff --git a/docs/capabilities/claude-code.mdx b/docs/capabilities/claude-code.mdx
index da4b665af..801ae3623 100644
--- a/docs/capabilities/claude-code.mdx
+++ b/docs/capabilities/claude-code.mdx
@@ -79,21 +79,25 @@ Remote execution benefits:
 
 ### Local Claude with Cloud Benefits
 
-Get up and running in three simple steps:
+Get up and running in four simple steps:
 
-1. Install the Codegen CLI:
+1. Install Claude Code on your host machine:
+
+   Follow the [Claude Code installation guide](https://claude.ai/code) to install Claude Code locally.
+
+2. Install the Codegen CLI:
 
    ```bash
    uv tool install codegen
    ```
 
-2. Authenticate with your account:
+3. Authenticate with your account:
 
    ```bash
    codegen login
    ```
 
-3. Run Claude with full telemetry:
+4. Run Claude with full telemetry:
    ```bash
    codegen claude "Help me refactor this authentication module"
    ```
@@ -101,6 +105,7 @@ Get up and running in three simple steps:
 Your session immediately appears in the cloud with full integration access.
 
 <Tip>
+  **Prerequisites**: Claude Code must be installed on your host machine before running `codegen claude`. 
   The first time you run `codegen claude`, it will download the Claude Code
   binary. Subsequent runs start instantly.
 </Tip>
diff --git a/docs/introduction/cli.mdx b/docs/introduction/cli.mdx
index 30da2482f..bc985b07d 100644
--- a/docs/introduction/cli.mdx
+++ b/docs/introduction/cli.mdx
@@ -53,7 +53,7 @@ codegen login --token YOUR_API_TOKEN
 - **View and manage agents** - List agent runs, check status, and see detailed execution logs
 - **Pull agent work** - Download branches and code changes created by agents directly to your local environment
 - **Create new agents** - Trigger agent runs from the command line with custom prompts
-- **Run Claude Code** - Execute Claude Code with OpenTelemetry monitoring and comprehensive logging
+- **Run Claude Code** - Execute Claude Code with OpenTelemetry monitoring and comprehensive logging (requires Claude Code to be installed on your host machine)
 - **Manage organizations** - Switch between organizations and configure repositories
 
 <Note>