Claude Code Architects
Installation
Install the CCA plugin — a structured workflow for learning to build software with Claude Code. Choose your OS and follow the steps.
Need to set up your environment first? Follow the full environment setup guide.
macOS Installation
3 steps
01 Set Up Your Environment
Follow the Mac Environment Setup Guide 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.
claude03 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)
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
claude plugin marketplace add blakesims/cca-marketplace3. Install the student plugin
claude plugin install cca-plugin@cca-marketplace --scope user4. Install the build engine
claude plugin install task-workflow@cca-marketplace --scope userAlternative: One-line install
Before running install scripts from the internet, read this security guide.
curl -sSL https://raw.githubusercontent.com/blakesims/cca-plugin/main/install-simple.sh | bashSame result, but runs a script. Read the security guide first, or inspect it on GitHub.
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.
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:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc02 Sign in to Claude
This opens your browser to sign in. Once signed in, type /exit to close Claude.
claude03 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)
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
claude plugin marketplace add blakesims/cca-marketplace3. Install the student plugin
claude plugin install cca-plugin@cca-marketplace --scope user4. Install the build engine
claude plugin install task-workflow@cca-marketplace --scope userAlternative: One-line install
Before running install scripts from the internet, read this security guide.
curl -sSL https://raw.githubusercontent.com/blakesims/cca-plugin/main/install-simple.sh | bashSame result, but runs a script. Read the security guide first, or inspect it on GitHub.
Windows Installation
3 steps
01 Set Up Your Environment
Follow the Windows Environment Setup Guide 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.
claude03 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)
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
claude plugin marketplace add blakesims/cca-marketplace3. Install the student plugin
claude plugin install cca-plugin@cca-marketplace --scope user4. Install the build engine
claude plugin install task-workflow@cca-marketplace --scope userAlternative: One-line install
Before running install scripts from the internet, read this security guide.
curl -sSL https://raw.githubusercontent.com/blakesims/cca-plugin/main/install-simple.sh | bashSame result, but runs a script. Read the security guide first, or inspect it on GitHub.
What the Install Script Does
3 things, all inside ~/.claude/
Registers the CCA plugin marketplace
Adds the plugin source so Claude knows where to find CCA plugins.
Installs the cca-plugin
The student workflow — PRDs, kits, and build phases.
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:
/cca-plugin:setupTroubleshooting
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):
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
claude plugin listUpdate plugins
claude plugin update cca-plugin@cca-marketplaceSecurity Note
The install script is open source. You can read it before running: install-simple.sh on GitHub. It only installs plugins, doesn't modify system config, and all changes are inside ~/.claude/.