CategoryWeightCategory scoreContribution
Securityprompt, exec, net, exfil, eval
35%
35.0 pts
Supply chainhash, typosquat, maintainer, lockfile
20%
20.0 pts
Maintenancestaleness, pinning, CI
15%
15.0 pts
TransparencySKILL.md, perms, README
15%
15.0 pts
Communityinstalls, verify, response
15%
15.0 pts
Findings & checks · 0 flagged
Security
✓—All security checks passedNo findings in this category for the latest scan.pass
Supply chain
✓—All supply chain checks passedNo findings in this category for the latest scan.pass
Maintenance
✓—All maintenance checks passedNo findings in this category for the latest scan.pass
Transparency
✓—All transparency checks passedNo findings in this category for the latest scan.pass
Community
✓—All community checks passedNo findings in this category for the latest scan.pass
Every scanned point with the score it earned and what moved between them.
6166361
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
claude-code-guide
The beginner's hands-on guide to Claude Code — learn by building real projects.
Who is this for?
- Developers who know basic Python but have never used an AI coding agent
- Anyone curious about Claude Code and wanting to learn by doing
- People who prefer hands-on projects over reading docs
Prerequisites
- Python 3.8+ installed on your machine
- An Anthropic API key (get one here)
- A terminal you're comfortable typing commands into
- Basic familiarity with Python (variables, functions,
pip install)
Table of Contents
| Chapter | What you'll learn |
|---|---|
| 00 — Setup | Install Claude Code, configure your API key, verify everything works |
| 01 — First Commands | Run your first prompts — create files, edit code, explain things |
| 02 — Project Scaffolding | Generate a full Flask app from a single prompt |
| 03 — Working with Existing Code | Fix bugs and add features in a real (intentionally broken) app |
| 04 — Writing Tests | Ask Claude Code to write and run tests for you |
| 05 — Real Project: CLI Tool | Build a complete CLI tool end-to-end using Claude Code |
| 06 — Tips & Pitfalls | Common mistakes, better prompts, and a cheatsheet |
Quick Start
# 1. Install Claude Code
npm install -g @anthropic-ai/claude-code
# 2. Set your API key
export ANTHROPIC_API_KEY="your-key-here"
# 3. Clone this repo and verify your setup
git clone https://github.com/AhmedShaikh0/claude-code-guide.git
cd claude-code-guide/00-setup
bash verify.shThen open Chapter 00 and follow along.
How to Use This Repo
Each chapter is a standalone folder. Work through them in order — each one builds on skills from the previous chapter. Every chapter takes under 10 minutes to read and includes exercises you run in your own terminal.
Contributing
See CONTRIBUTING.md for how to add chapters or fix issues.