Three things break most often: Claude Code refusing to start, the dev server failing to launch, and git getting confused. Here are the fixes for each. Bookmark this lesson; you'll come back to it.
Troubleshooting Common Issues
Claude Code Won't Start
- Check that you're signed in (run claude and sign in again if needed)
- Update Claude Code: claude update
- Reinstall with the native installer: curl -fsSL https://claude.ai/install.sh | bash (Mac/Linux) or irm https://claude.ai/install.ps1 | iex (Windows PowerShell)
Development Server Won't Start
- Press Ctrl + C to stop it
- Run npm run dev again
- Check if port 5173 is already in use by another program
Git/GitHub Issues
- Forgot to initialize git? Run git init
- Wrong remote? Check with git remote -v
- Need a fresh start? Delete the .git folder and start over
Key Takeaways
- Specific is better than vague. The more detail you give Claude Code, the better the result.
- Test early and often. Don't wait until the end to see if something works.
- Iterate in small steps. Ask for one thing at a time, not everything at once.
- Document your decisions. Help future you and your teammates understand why you made choices.
- Use git effectively. Meaningful commit messages are your documentation.
You're Ready!
- How to set up Claude Code
- How to create prototypes
- How to save your work on GitHub
- Best practices for working with Claude Code
Congratulations! Start building! Create a prototype, share it with your team, and iterate. Claude Code is a tool to speed up your ideas, have fun with it!
Stuck on your own project? Book 45 minutes with me for $49.
The patterns behind this lesson
Contextual AssistanceOffer timely, proactive help and suggestions based on user context, history, and needs.Augmented CreationEmpower users to create content with AI as a collaborative partner.Progressive DisclosureGradually reveal information, options, or AI features to reduce cognitive load and simplify complex tasks.