Installation

Detailed installation options for Claude Dojo.

Installation Methods

The simplest way to run Claude Dojo without installing anything globally:

npx claude-dojo

Global Installation

Install Claude Dojo globally for faster startup:

npm install -g claude-dojo

Then run it anytime with:

claude-dojo

From Source

Clone and build from the GitHub repository:

git clone https://github.com/rahulsub/claude-dojo.git
cd claude-dojo
npm install
npm run build
npm start

System Requirements

RequirementMinimumRecommended
Node.js18.0.020.0.0+
RAM512MB1GB+
Disk Space100MB200MB

Browser Support

Claude Dojo works best in modern browsers:

  • Chrome/Chromium 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+

Troubleshooting

Port Already in Use

If port 3001 is already in use, specify a different port:

npx claude-dojo --port 3002

API Key Issues

If you see authentication errors:

  1. Verify your API key is correct
  2. Check that your key has the necessary permissions
  3. Ensure your API key hasn’t expired

WebGL Not Available

The 3D interface requires WebGL. If you see a blank screen:

  1. Update your graphics drivers
  2. Enable hardware acceleration in your browser
  3. Try a different browser

Updating

NPX

NPX always fetches the latest version automatically.

Global Installation

npm update -g claude-dojo

From Source

git pull origin main
npm install
npm run build