diff --git a/docs/capabilities/claude-code.mdx b/docs/capabilities/claude-code.mdx
index fb7b40255..76719546c 100644
--- a/docs/capabilities/claude-code.mdx
+++ b/docs/capabilities/claude-code.mdx
@@ -6,6 +6,10 @@ icon: "code"
 
 Claude Code brings the power of Anthropic's coding assistant directly into your development workflow through Codegen. Whether you're running Claude locally or in the cloud, Codegen provides the infrastructure to enhance your AI coding experience with telemetry, integrations, and seamless deployment options.
 
+<Note>
+  For comprehensive Claude Code documentation, visit the [official Claude Code docs](https://docs.claude.com/en/docs/claude-code/overview).
+</Note>
+
 <Frame>
   <video
     controls
@@ -14,6 +18,36 @@ Claude Code brings the power of Anthropic's coding assistant directly into your
   />
 </Frame>
 
+## Common Use Cases
+
+Claude Code excels at a wide range of development tasks. Here are some of the most popular workflows:
+
+### Code Understanding & Exploration
+- **Understand new codebases** - Get quick overviews of unfamiliar projects and their architecture
+- **Find relevant code** - Locate specific functions, patterns, or implementations across large codebases
+- **Trace code paths** - Follow execution flows and understand how different components interact
+
+### Development & Refactoring
+- **Refactor legacy code** - Modernize old code while preserving functionality
+- **Add new features** - Implement new functionality with proper integration into existing systems
+- **Fix bugs and issues** - Debug problems and implement comprehensive fixes
+- **Write tests** - Generate unit tests, integration tests, and test coverage improvements
+
+### Documentation & Maintenance
+- **Generate documentation** - Create README files, API docs, and inline code comments
+- **Code reviews** - Get detailed feedback on code quality, security, and best practices
+- **Dependency updates** - Safely upgrade libraries and handle breaking changes
+- **Performance optimization** - Identify bottlenecks and implement performance improvements
+
+### DevOps & Automation
+- **CI/CD pipeline setup** - Configure GitHub Actions, GitLab CI, and other automation
+- **Infrastructure as code** - Write and maintain Terraform, Docker, and Kubernetes configurations
+- **Deployment scripts** - Create reliable deployment and rollback procedures
+
+<Tip>
+  Claude Code understands your entire codebase context, making it particularly effective for complex, multi-file changes that require understanding relationships between different parts of your system.
+</Tip>
+
 ## Cloud Logging for Local Sessions
 
 Every local Claude Code session is automatically logged to the cloud through the Codegen CLI. This seamless integration means your local development gains enterprise-grade observability without any extra configuration.