Blake Sims

Claude Code · HTML

CCA Plugin Installation

Claude Code Architects plugin setup

On this page 16 sections
  1. macOS Installation
  2. 01 Set Up Your Environment
  3. 02 Sign in to Claude
  4. 03 Install CCA Plugins
  5. Linux Installation
  6. 01 Install Git + Claude Code
  7. 02 Sign in to Claude
  8. 03 Install CCA Plugins
  9. Windows Installation
  10. 01 Set Up Your Environment
  11. 02 Sign in to Claude
  12. 03 Install CCA Plugins
  13. What the Install Script Does
  14. After Installation
  15. Troubleshooting
  16. Security Note

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.

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.

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.

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.

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.

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.

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.

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.

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.

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. It only installs plugins, doesn't modify system config, and all changes are inside ~/.claude/.