mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-03-01 15:03:57 +08:00

Files

catlog22 84610661ca fix(docs): resolve VitePress build errors with custom HTML tags

- Fix custom tags (Good, Bad, Before, After, Tip, Note, Warning) in skill docs
- Replace placeholder variables with HTML entities to prevent Vue parser errors
- Allow manual workflow_dispatch to trigger docs deployment

2026-02-28 16:53:26 +08:00

2.4 KiB

Raw Blame History

Installation

Learn how to install and configure CCW on your system.

Prerequisites

Before installing CCW, make sure you have:

Node.js >= 18.0.0
npm >= 9.0.0 or yarn >= 1.22.0
Git for version control features

Install CCW

Global Installation (Recommended)

npm install -g claude-code-workflow

Project-Specific Installation

# In your project directory
npm install --save-dev claude-code-workflow

# Run with npx
npx ccw [command]

Using Yarn

# Global
yarn global add claude-code-workflow

# Project-specific
yarn add -D claude-code-workflow

Verify Installation

ccw --version
# Output: CCW v1.0.0

ccw --help
# Shows all available commands

Configuration

CLI Tools Configuration

Create or edit ~/.claude/cli-tools.json:

{
  "version": "3.3.0",
  "tools": {
    "gemini": {
      "enabled": true,
      "primaryModel": "gemini-2.5-flash",
      "secondaryModel": "gemini-2.5-flash",
      "tags": ["analysis", "debug"],
      "type": "builtin"
    },
    "codex": {
      "enabled": true,
      "primaryModel": "gpt-5.2",
      "secondaryModel": "gpt-5.2",
      "tags": [],
      "type": "builtin"
    }
  }
}

CLAUDE.md Instructions

Create CLAUDE.md in your project root:

# Project Instructions

## Coding Standards
- Use TypeScript for type safety
- Follow ESLint configuration
- Write tests for all new features

## Architecture
- Frontend: Vue 3 + Vite
- Backend: Node.js + Express
- Database: PostgreSQL

Updating CCW

# Update to the latest version
npm update -g claude-code-workflow

# Or install a specific version
npm install -g claude-code-workflow@latest

Uninstallation

npm uninstall -g claude-code-workflow

# Remove configuration (optional)
rm -rf ~/.claude

Troubleshooting

Permission Issues

If you encounter permission errors:

# Use sudo (not recommended)
sudo npm install -g claude-code-workflow

# Or fix npm permissions (recommended)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

PATH Issues

Add npm global bin to your PATH:

# For bash/zsh
echo 'export PATH=$(npm config get prefix)/bin:$PATH' >> ~/.bashrc

# For fish
echo 'set -gx PATH (npm config get prefix)/bin $PATH' >> ~/.config/fish/config.fish

::: info Next Steps After installation, check out the First Workflow guide. :::

2.4 KiB Raw Blame History