|
| 1 | +# Claude Code Quick Start Guide |
| 2 | + |
| 3 | +Get up and running with Claude Code in 5 minutes! |
| 4 | + |
| 5 | +## Step 1: Install VS Code Extension (2 minutes) |
| 6 | + |
| 7 | +### Option A: From VS Code |
| 8 | +1. Open VS Code |
| 9 | +2. Press `Cmd+Shift+X` (Mac) or `Ctrl+Shift+X` (Windows/Linux) |
| 10 | +3. Search for "Claude Code" |
| 11 | +4. Click "Install" |
| 12 | +5. Sign in with your Anthropic account |
| 13 | + |
| 14 | +### Option B: From Command Line |
| 15 | +```bash |
| 16 | +code --install-extension anthropic.claude-code |
| 17 | +``` |
| 18 | + |
| 19 | +## Step 2: Learn 3 Essential Shortcuts (1 minute) |
| 20 | + |
| 21 | +``` |
| 22 | +Cmd+Option+K (Alt+Ctrl+K) - Reference a file |
| 23 | +Cmd+Esc (Ctrl+Esc) - Toggle between editor and Claude |
| 24 | +@filename.ext - Mention file in conversation |
| 25 | +``` |
| 26 | + |
| 27 | +## Step 3: Try Your First Command (2 minutes) |
| 28 | + |
| 29 | +### Example 1: Review a File |
| 30 | +``` |
| 31 | +@verify.html Review this page for accessibility issues |
| 32 | +``` |
| 33 | + |
| 34 | +### Example 2: Update Code |
| 35 | +``` |
| 36 | +@tools/certificate_automation/src/generate_certificates.py |
| 37 | +Add error handling for missing template files |
| 38 | +``` |
| 39 | + |
| 40 | +### Example 3: Use a Custom Skill |
| 41 | +``` |
| 42 | +Use the accessibility-audit skill on @verify.html |
| 43 | +``` |
| 44 | + |
| 45 | +## That's It! 🎉 |
| 46 | + |
| 47 | +You're ready to use Claude Code effectively! |
| 48 | + |
| 49 | +--- |
| 50 | + |
| 51 | +## Next Steps (Optional) |
| 52 | + |
| 53 | +### Install MCP Servers (5 minutes) |
| 54 | +```bash |
| 55 | +# GitHub integration |
| 56 | +claude mcp add github |
| 57 | +``` |
| 58 | + |
| 59 | +### Explore Custom Skills |
| 60 | +- `review-html` - Review HTML/Liquid templates |
| 61 | +- `optimize-assets` - Optimize website assets |
| 62 | +- `jekyll-build` - Build Jekyll site |
| 63 | +- `test-verification` - Test certificate verification |
| 64 | +- `accessibility-audit` - Accessibility audits |
| 65 | + |
| 66 | +### Read More |
| 67 | +- [Complete VS Code Setup](vscode-setup-guide.md) |
| 68 | +- [All Keyboard Shortcuts](keyboard-shortcuts.md) |
| 69 | +- [Common Workflows](workflows-guide.md) |
| 70 | +- [MCP Servers Guide](mcp-servers-guide.md) |
| 71 | + |
| 72 | +--- |
| 73 | + |
| 74 | +## Quick Reference Card |
| 75 | + |
| 76 | +``` |
| 77 | +┌─────────────────────────────────────────────┐ |
| 78 | +│ Claude Code Essentials │ |
| 79 | +├─────────────────────────────────────────────┤ |
| 80 | +│ │ |
| 81 | +│ 📁 Reference File: │ |
| 82 | +│ @filename.ext │ |
| 83 | +│ Cmd+Opt+K (Alt+Ctrl+K) │ |
| 84 | +│ │ |
| 85 | +│ 🔄 Toggle Focus: │ |
| 86 | +│ Cmd+Esc (Ctrl+Esc) │ |
| 87 | +│ │ |
| 88 | +│ 📤 Send Message: │ |
| 89 | +│ Cmd+Enter (Ctrl+Enter) │ |
| 90 | +│ │ |
| 91 | +│ ✅ Accept Change: │ |
| 92 | +│ Cmd+. (Ctrl+.) │ |
| 93 | +│ │ |
| 94 | +│ 🆕 New Tab: │ |
| 95 | +│ Cmd+Shift+Esc (Ctrl+Shift+Esc) │ |
| 96 | +│ │ |
| 97 | +│ 💬 Commands: │ |
| 98 | +│ /help - Show help │ |
| 99 | +│ /skills - List skills │ |
| 100 | +│ /mcp - MCP servers │ |
| 101 | +│ │ |
| 102 | +└─────────────────────────────────────────────┘ |
| 103 | +``` |
| 104 | + |
| 105 | +--- |
| 106 | + |
| 107 | +## Common First Tasks |
| 108 | + |
| 109 | +### Frontend Development |
| 110 | +``` |
| 111 | +# Review HTML for accessibility |
| 112 | +@verify.html Check accessibility compliance |
| 113 | +
|
| 114 | +# Optimize assets |
| 115 | +Find images over 100KB and suggest compression |
| 116 | +
|
| 117 | +# Update navigation |
| 118 | +@_includes/navigation.html Add "Verify Certificate" link |
| 119 | +``` |
| 120 | + |
| 121 | +### Certificate Automation |
| 122 | +``` |
| 123 | +# Generate certificates |
| 124 | +@tools/certificate_automation/src/generate_certificates.py |
| 125 | +Explain how this works |
| 126 | +
|
| 127 | +# Test verification |
| 128 | +Test the certificate verification page with a sample ID |
| 129 | +
|
| 130 | +# Add certificate type |
| 131 | +@tools/certificate_automation/src/config.json |
| 132 | +Add configuration for "speaker" certificates |
| 133 | +``` |
| 134 | + |
| 135 | +### Content Updates |
| 136 | +``` |
| 137 | +# Add team member |
| 138 | +@_data/team.yml Add new team member profile |
| 139 | +
|
| 140 | +# Create blog post |
| 141 | +Create a new blog post about our latest event |
| 142 | +
|
| 143 | +# Update SEO |
| 144 | +Review SEO meta tags on all pages |
| 145 | +``` |
| 146 | + |
| 147 | +--- |
| 148 | + |
| 149 | +## Troubleshooting |
| 150 | + |
| 151 | +### Extension not loading? |
| 152 | +``` |
| 153 | +1. Reload VS Code: Cmd+Shift+P → "Reload Window" |
| 154 | +2. Check extension is enabled |
| 155 | +3. Sign out and sign back in |
| 156 | +``` |
| 157 | + |
| 158 | +### Can't reference files? |
| 159 | +``` |
| 160 | +1. Ensure file is saved |
| 161 | +2. File must be in workspace |
| 162 | +3. Try absolute path: @/path/to/file.ext |
| 163 | +``` |
| 164 | + |
| 165 | +### Skills not showing? |
| 166 | +``` |
| 167 | +1. Check .claude/skills/ directory exists |
| 168 | +2. Skills must be .md files |
| 169 | +3. Restart Claude Code |
| 170 | +``` |
| 171 | + |
| 172 | +--- |
| 173 | + |
| 174 | +## Get Help |
| 175 | + |
| 176 | +- In conversation: `/help` |
| 177 | +- Full docs: [README.md](README.md) |
| 178 | +- VS Code guide: [vscode-setup-guide.md](vscode-setup-guide.md) |
| 179 | +- Online: https://code.claude.com/docs |
| 180 | + |
| 181 | +--- |
| 182 | + |
| 183 | +**Pro Tip**: Use `@` to reference files - Claude will understand the context automatically! |
| 184 | + |
| 185 | +Happy coding! 🚀 |
0 commit comments