🌟 Claude Code Dores npm User Manual

npm Package Overview

Claude Code Dores is a powerful extension suite that brings multi-language support, Live2D model management, and automated hook configuration to Claude Code.

Note: This npm package requires the Dores client to unlock its full functionality. The Dores client provides real-time interaction, visual presentation, and quick operations, serving as the core of the entire experience.

🎯 Core Features

| Scenario | Feature Description | | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Editor Launch | When the editor starts, Dores will greet you with encouragement, filling each coding session with motivation. | | Editor Close | When ending work, Dores provides warm reminders, helping you elegantly conclude your day's code journey. | | Start Run and Debug | When debugging starts, Dores offers precise encouragement and practical tips, helping you focus efficiently on troubleshooting. | | Create Project | When a new project is born, Dores warmly welcomes you, helping you start a new chapter of creativity and productivity. | | Switch Working Directory | When switching work environments, Dores gently reminds and encourages, making every transition feel warm. | | Idle State | During long periods of inactivity, Dores thoughtfully reminds you to rest moderately, protecting your energy and keeping creativity flowing. | | Resume Work State | When returning to work, Dores motivates you with sincere praise, bringing focus and efficiency back to full capacity. | | Task Completion | When you complete editor tasks, Dores delivers perfect appreciation, crowning your achievements. | | Plugin Statistics | Dores silently records your coding rhythm and habits, providing intelligent tips and optimization suggestions in each work iteration, naturally improving your efficiency and steadily maintaining focus. |

📦 NPM Package Installation

Method 1: Official Repository

# Install npm package
npm install claude-code-dores
# Use npx to run initialization project
npx init-dores

Method 2: Local tgz Package

# Install npm package
npm install ./claude-code-dores.tgz
# Use npx to run initialization project
npx init-dores

🚀 Quick Start

1. Ensure client is started and connected
2. Initialize project

init-dores
# Silent mode
init-dores --silent
# Force overwrite
init-dores --force

3. Language switching examples

# Switch to Chinese
/dores:lang cn

# Switch to English
/dores:lang en

# 日本語に切り替え (Switch to Japanese)
/dores:lang jp

4. Live2D Model Management

/dores:live2d list
/dores:live2d switch model_name

🖥 Dores Client (Core Dependency)

📥 Download Links

• macOS: Dores Client Download

⚡ Installation Steps

1. Download the installation package for your system.
2. macOS: Drag the .app file into the "Applications" folder and launch.
3. On first launch, allow the client to access the network to enable WebSocket communication with Claude Code.

⌨ Dores Client Shortcuts Overview

🎙 Microphone Shortcut Settings

For quickly enabling voice input functionality

| Step | Operation | Available Shortcuts | | ---- | ----------------------------- | ------------------------------------------------------------------------------------------------------- | | 1 | Click Dores icon in menu bar | - | | 2 | Select Microphone submenu | - | | 3 | Select shortcut combination | ⌃M (Ctrl+M) — Default⌘⇧M (Cmd+Shift+M)⌃⇧M (Ctrl+Shift+M)⌥M (Option+M)⌥⌘M (Option+Cmd+M) |

🔍 Model Zoom Shortcut Settings

Quickly adjust the display scale of the virtual character model

| Step | Operation | Available Shortcuts | | ---- | ----------------------------- | --------------------------------------------------------------------------------------------------------------- | | 1 | Click Dores icon in menu bar | - | | 2 | Select Model Zoom submenu | - | | 3 | Select zoom in/out shortcuts | ⌘= / - (Cmd = / -) — Default⌃⇧= / - (Ctrl+Shift = / -)⌃= / - (Ctrl = / -)⌥⌘= / - (Option+Cmd = / -) |

🧭 Suggested Usage Order

1. Install and launch Dores client (Core environment)
2. Install Claude Code Dores npm package (Enhanced features)
3. Launch Claude Code in VSCode/Cursor and connect to client

📥 Client Installation Steps

1️⃣ Download and Open DMG File

Download Dores.dmg and double-click to open

2️⃣ Drag to Applications Folder

3️⃣ Launch Dores

Click Finder → Applications, find DoresApp and launch directly.

🔧 Troubleshooting

• Client not running → Launch Dores and check connection status
• WebSocket connection failed → Check firewall and port usage
• Language switching not working → Delete .dores/config.json and reinitialize

Technical Support

• GitHub Issues: Submit Issues
• Discord Community: Join Discussion

Version Information

• Version: 3.0.0
• Updated: September 2025
• Development Team: Dores AI Team