← Back to home

Help & Troubleshooting

Plugin won't update to the latest version

The most common issue. Claude Code caches the marketplace locally, so even after pushing changes to GitHub, your local install may still show the old version.

Fix:

Remove and re-add the marketplace source:

claude plugin marketplace remove ryanxkh-learncc claude plugin marketplace add ryanxkh/learncc

Then start a new Claude Code session and reinstall:

/plugin

Search learncc, press Space to install, Esc to close.

Plugin installed but /learncc doesn't work

Plugin skills are namespaced. The correct command is:

/learncc:learncc

Not /learncc. This is how Claude Code handles plugin skills to avoid naming conflicts.

Plugin installed but skill doesn't appear in /skills

Plugin skills require a full session restart to activate. /reload-pluginsalone isn't enough.

Fix:

Exit Claude Code completely (Ctrl+D or type exit), then start a fresh session with claude.

'Overwrite file' prompts keep appearing and I don't know what they are

LearnCC saves your progress to a small file at ~/.claude/learncc/progress.json. When you see a prompt asking to overwrite this file, it's the course saving where you left off so you can resume later. It's safe to allow.

If you want to see what's stored:

cat ~/.claude/learncc/progress.json

Nothing is transmitted anywhere. Everything stays on your machine.

I want to start the course over from scratch

Delete your progress file:

rm ~/.claude/learncc/progress.json

Next time you run /learncc:learncc, it starts fresh from Module 0.

The course thinks I'm a PM but I'm not

The course classifies your role internally for exercise routing. This only affects which examples you see (code examples vs PRD examples vs report examples), not the core content.

To fix it, edit your progress file:

cat ~/.claude/learncc/progress.json

Find the "role" field and change it to "developer", "pm", or "non-technical". You can also update the "domain" field to better describe what you do — this is what the course uses when greeting you.

Or just tell the tutor during your next session: "My role is wrong, I'm actually a [your role]." It can update the file for you.

Claude Code isn't installed

Mac:

curl -fsSL https://claude.ai/install.sh | bash

Windows (PowerShell):

irm https://claude.ai/install.ps1 | iex

Windows also requires Git for Windows: https://git-scm.com/downloads/win

Requires a Claude Pro, Max, or Team plan.

How do I uninstall LearnCC?

Open Claude Code, type /plugin, find learncc, and select Uninstall. Then remove the marketplace source:

claude plugin marketplace remove ryanxkh-learncc

To also delete your progress data:

rm -rf ~/.claude/learncc/

The course keeps repeating exercises I already did

The course tracks your progress per exercise, but sometimes the tutor skips the save step between exercises. If you return and it starts earlier than where you left off, just tell it: "I already completed exercises 1-3, start at 4." It will skip forward.

Can I use this on the Desktop app or VS Code instead of the terminal?

The plugin installs at the user level, so it's available across all Claude Code surfaces. The exercises are written for CLI but the concepts transfer. Type /learncc:learncc from any surface where Claude Code is running.

The course asked me to allow a tool or permission I don't understand

The course sometimes needs Claude to read or write files (your CLAUDE.md, progress tracking, skill files). If you see a permission prompt you're unsure about, look at the file path. If it's inside ~/.claude/or your project folder, it's safe. The course never writes outside your workspace or transmits data.

How much does this cost in tokens?

LearnCC uses additional tokens beyond normal usage. Each module loads content on demand (not all at once). A typical module session uses roughly the same tokens as a medium-length Claude Code conversation. The full course across all sessions is comparable to a day of normal Claude Code usage.

Can I skip modules or jump ahead?

Yes. Tell the tutor: "Skip to Module 4" or "I want to learn about hooks." It will update your progress and jump. You can also re-do a completed module: "Let's redo Module 3."

I closed my terminal mid-exercise and lost my place

Your progress saves after each exercise. If you closed your terminal mid-exercise, just re-run the module from where you left off. The tutor will recognize your progress and continue.

Something else is broken

Open an issue at https://github.com/ryanxkh/learncc/issues