# CCA Plugin Installation ## macOS Installation 3 steps ### 01 Set Up Your Environment Follow the [Mac Environment Setup Guide](installation.html#mac-installation) to install Homebrew and Claude Code. ### 02 Sign in to Claude This opens your browser to sign in. Once signed in, type **/exit** to close Claude. Copy Copied! ``` claude ``` ### 03 Install CCA Plugins Recommended: Run these 4 commands one at a time Official plugin install method. No scripts, nothing piped to bash. Plugins persist across sessions. 1\. Enable HTTPS for GitHub downloads (session only — no permanent changes) Copy Copied! ``` export GIT_CONFIG_COUNT=1 && \ export GIT_CONFIG_KEY_0="url.https://github.com/.insteadOf" && \ export GIT_CONFIG_VALUE_0="git@github.com:" ``` 2\. Add the plugin marketplace Copy Copied! ``` claude plugin marketplace add blakesims/cca-marketplace ``` 3\. Install the student plugin Copy Copied! ``` claude plugin install cca-plugin@cca-marketplace --scope user ``` 4\. Install the build engine Copy Copied! ``` claude plugin install task-workflow@cca-marketplace --scope user ``` Alternative: One-line install Before running install scripts from the internet, [read this security guide](security.html). Copy Copied! ``` curl -sSL https://raw.githubusercontent.com/blakesims/cca-plugin/main/install-simple.sh | bash ``` Same result, but runs a script. Read the security guide first, or [inspect it on GitHub](https://github.com/blakesims/cca-plugin/blob/main/install-simple.sh). ## Linux Installation 3 steps ### 01 Install Git + Claude Code Install Git, then install Claude Code using the official installer: Before running install scripts from the internet, [read this security guide](security.html). Copy Copied! ``` sudo apt-get update && sudo apt-get install -y git curl curl -fsSL https://claude.ai/install.sh | bash ``` \* If you see `~/.local/bin is not in your PATH`, run: Copy Copied! ``` echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc ``` ### 02 Sign in to Claude This opens your browser to sign in. Once signed in, type **/exit** to close Claude. Copy Copied! ``` claude ``` ### 03 Install CCA Plugins Recommended: Run these 4 commands one at a time Official plugin install method. No scripts, nothing piped to bash. Plugins persist across sessions. 1\. Enable HTTPS for GitHub downloads (session only — no permanent changes) Copy Copied! ``` export GIT_CONFIG_COUNT=1 && \ export GIT_CONFIG_KEY_0="url.https://github.com/.insteadOf" && \ export GIT_CONFIG_VALUE_0="git@github.com:" ``` 2\. Add the plugin marketplace Copy Copied! ``` claude plugin marketplace add blakesims/cca-marketplace ``` 3\. Install the student plugin Copy Copied! ``` claude plugin install cca-plugin@cca-marketplace --scope user ``` 4\. Install the build engine Copy Copied! ``` claude plugin install task-workflow@cca-marketplace --scope user ``` Alternative: One-line install Before running install scripts from the internet, [read this security guide](security.html). Copy Copied! ``` curl -sSL https://raw.githubusercontent.com/blakesims/cca-plugin/main/install-simple.sh | bash ``` Same result, but runs a script. Read the security guide first, or [inspect it on GitHub](https://github.com/blakesims/cca-plugin/blob/main/install-simple.sh). ## Windows Installation 3 steps ### 01 Set Up Your Environment Follow the [Windows Environment Setup Guide](installation.html#windows-installation) to install WSL2, Ubuntu, and Claude Code. ### 02 Sign in to Claude This opens your browser to sign in. Once signed in, type **/exit** to close Claude. Copy Copied! ``` claude ``` ### 03 Install CCA Plugins In your **Ubuntu terminal**, run: Recommended: Run these 4 commands one at a time Official plugin install method. No scripts, nothing piped to bash. Plugins persist across sessions. 1\. Enable HTTPS for GitHub downloads (session only — no permanent changes) Copy Copied! ``` export GIT_CONFIG_COUNT=1 && \ export GIT_CONFIG_KEY_0="url.https://github.com/.insteadOf" && \ export GIT_CONFIG_VALUE_0="git@github.com:" ``` 2\. Add the plugin marketplace Copy Copied! ``` claude plugin marketplace add blakesims/cca-marketplace ``` 3\. Install the student plugin Copy Copied! ``` claude plugin install cca-plugin@cca-marketplace --scope user ``` 4\. Install the build engine Copy Copied! ``` claude plugin install task-workflow@cca-marketplace --scope user ``` Alternative: One-line install Before running install scripts from the internet, [read this security guide](security.html). Copy Copied! ``` curl -sSL https://raw.githubusercontent.com/blakesims/cca-plugin/main/install-simple.sh | bash ``` Same result, but runs a script. Read the security guide first, or [inspect it on GitHub](https://github.com/blakesims/cca-plugin/blob/main/install-simple.sh). ## What the Install Script Does 3 things, all inside ~/.claude/ 1. Registers the CCA plugin marketplace Adds the plugin source so Claude knows where to find CCA plugins. 2. Installs the cca-plugin The student workflow — PRDs, kits, and build phases. 3. Installs the task-workflow plugin The build engine — planning, execution, and code review. Plugins persist across sessions — you only need to install once. ## After Installation You're ready to build After the script runs, Claude launches automatically and walks you through project setup. You can also start fresh anytime by running `claude` and then typing: Copy Copied! ``` /cca-plugin:setup ``` ## Troubleshooting Common issues and fixes "Claude Code not found" Make sure you ran step 3 (Install Claude Code) and it completed successfully. Try closing and reopening your terminal. "Plugin install failed" Check your internet connection and try running the curl command again. "Permission denied (publickey)" or SSH errors This means git is trying to use SSH keys you don't have. Run this once to permanently switch to HTTPS (recommended for most users): Copy Copied! ``` git config --global url."https://github.com/".insteadOf "git@github.com:" ``` This is a permanent setting — you only need to run it once. Then retry the plugin install command. "Marketplace already registered" That's fine — it means you already have it. The script will continue installing the plugins. Verify plugins are installed Copy Copied! ``` claude plugin list ``` Update plugins Copy Copied! ``` claude plugin update cca-plugin@cca-marketplace ``` ### Security Note The install script is open source. You can read it before running: [install-simple.sh on GitHub](https://github.com/blakesims/cca-plugin/blob/main/install-simple.sh). It only installs plugins, doesn't modify system config, and all changes are inside `~/.claude/`.