Skip to main content

​
Installation

npm -i -g claude-space

# Run ClaudeSpace
claude-space

# or open in the porject canvas directly (where the .claude folder is located)
claude-space project .
The Code base is available in the following repository: 
# Clone the repository
git clone https://github.com/FilipeBorges1993/ClaudeSpaceElectron.git
cd ClaudeSpaceElectron

# Install dependencies
npm install

# Run ClaudeSpace
npm run dev
Success: ClaudeSpace opens automatically

​
Configuration

​
Claude API Setup

ClaudeSpace requires Claude API access for agent testing. Two authentication methods: 
# Install Claude CLI if not already installed
npm install -g @anthropic-ai/claude-cli

# Authenticate
claude auth login
Benefits:
  • No API key management
  • Automatic token refresh
  • Secure credential storage

​
Next Steps

Now that ClaudeSpace is installed, you’re ready to build your first agent!

​
Having Issues?

Get help: When reporting issues, include:
  • Node.js version (node --version)
  • npm version (npm --version)
  • Operating system and version
  • Error messages (full text or screenshots)
  • Steps to reproduce

​
Development Commands

For developers working on ClaudeSpace: 
# Development mode with hot reload
npm run dev

# Type checking
npm run typecheck           # All
npm run typecheck:node      # Main process
npm run typecheck:web       # Renderer process

# Code quality
npm run lint                # ESLint check
npm run lint:fix            # Auto-fix issues
npm run format              # Prettier format

# Build for production
npm run build:mac           # macOS
npm run build:win           # Windows
npm run build:linux         # Linux
npm run build:all           # All platforms

# Clean build artifacts
rm -rf dist node_modules
npm install

​
System Architecture

Understanding how ClaudeSpace works under the hood: 
┌─────────────────────────────────────┐
│    Electron Main Process (Node.js)  │
│  - IPC handlers (80+ handlers)      │
│  - Agent session management         │
│  - File I/O operations              │
│  - Claude SDK integration           │
└──────────────┬──────────────────────┘
               │ IPC Bridge
┌──────────────▼──────────────────────┐
│     Vue 3 Renderer (Frontend)        │
│  - NodeCanvas (Vue Flow)            │
│  - ChatPage (testing UI)            │
│  - Settings & configuration         │
│  - Pinia state management           │
└─────────────────────────────────────┘
Key directories: 
src/
├── main/           # Electron main process (Node.js)
├── preload/        # Context bridge & IPC
└── renderer/       # Vue 3 application (UI)

​
License

ClaudeSpace is open source software licensed under the MIT License. What this means:
  • Free to use for personal and commercial projects
  • Modify and distribute
  • Private use
  • No warranty or liability
See LICENSE for full details.
Ready to build your first agent?Continue to agent basics →