Installation

Download Claudia

Claudia v0.1.0 is now available for Windows, macOS, and Linux systems. The application enhances your Claude Code development workflow with powerful project management and analytics features.

System Requirements

Before installing, ensure your system meets these requirements:

• Operating System: Windows 10+, macOS 11.0+, Linux (Ubuntu 20.04+)
• Claude Code CLI: Must be installed and available in PATH
• Memory: 4GB RAM minimum (8GB recommended for better performance)
• Storage: At least 1GB free disk space
• Network: Internet connection for Claude API access

Prerequisites

Install Claude Code CLI

Before installing Claudia, you must have Claude Code CLI installed:

1. Visit Claude's official site to download Claude Code CLI
2. Follow the installation instructions for your operating system
3. Verify installation by running claude --version in your terminal
4. Set up your Claude API credentials

Installation Steps

Step 1: Download Claudia

1. Visit our GitHub Releases page
2. Download the appropriate installer for your platform:
   • Windows x64: .msi installer
   • macOS Intel: .dmg file for Intel-based Macs
   • macOS Apple Silicon: .dmg file for M1/M2/M3 Macs
   • Linux x64: .AppImage file

Step 2: Install Claudia

Windows:

1. Run the downloaded .msi installer
2. Follow the installation wizard
3. Launch Claudia from the Start Menu

macOS:

1. Open the downloaded .dmg file
2. Drag Claudia to your Applications folder
3. Launch from Applications (you may need to allow it in Security & Privacy settings)

Linux:

1. Make the AppImage executable: chmod +x claudia-*.AppImage
2. Run the AppImage directly: ./claudia-*.AppImage
3. Optionally, integrate with your desktop environment

Step 3: First Launch

1. Launch Claudia from your applications
2. If prompted by system security, allow the application to run
3. Claudia will automatically detect your Claude Code installation

Initial Setup

When you first launch Claudia, you'll be guided through the setup process:

1. Welcome Screen

Choose your primary workflow:

• CC Projects: Manage Claude Code projects and sessions
• CC Agents: Create and manage custom AI agents

2. Claude Code Detection

Claudia will automatically:

• Scan for your ~/.claude directory
• Import existing projects and sessions
• Verify Claude Code CLI installation

3. API Configuration

Configure your Claude API settings:

• API Key: Enter your Claude API key
• Model Selection: Choose default Claude model
• Usage Preferences: Set cost and usage limits

4. Security Settings

Set up sandbox and security preferences:

• Default Security Profile: Choose security level
• Permission Settings: Configure file and network access
• Violation Monitoring: Enable security tracking

5. Analytics Setup

Configure usage analytics:

• Cost Tracking: Enable real-time cost monitoring
• Data Collection: Choose analytics data to track
• Export Preferences: Set up automated reporting

Verification

To verify your installation:

1. Launch Claudia
2. Check that the welcome screen appears
3. Verify Claude Code project detection
4. Navigate to CC Projects to see your existing projects
5. Test creating a new CC Agent to verify functionality

Troubleshooting

Common Issues

Application won't open

• Check operating system compatibility
• Ensure you have sufficient disk space
• Try running as administrator (Windows) or with sudo (Linux)

Claude Code not detected

• Verify Claude Code CLI is installed: claude --version
• Check that ~/.claude directory exists
• Ensure proper permissions for the directory

Projects not appearing

• Verify Claude Code projects exist in ~/.claude/projects/
• Check directory permissions
• Try refreshing the project browser

API Connection issues

• Verify your Claude API key is correct
• Check internet connectivity
• Ensure Claude API services are available
• Review API usage limits and quotas

Next Steps

Once installation is complete:

1. Explore the User Interface Guide
2. Learn about Project & Session Management
3. Discover how to create CC Agents
4. Set up Advanced Sandboxing for security