VS Code is the recommended editor for working with Claude Code. This guide covers the extensions and workspace configuration used in this project.
Download from code.visualstudio.com. Install the stable release.
Install these from the Extensions panel (Cmd+Shift+X on Mac, Ctrl+Shift+X on Windows/Linux):
| Extension | Publisher | Purpose |
|---|---|---|
| Claude Code | Anthropic | AI pair programmer — the core tool |
| GitHub Pull Requests | GitHub | PR review and GitHub integration |
| GitLens | GitKraken | Enhanced git history and blame |
| Extension | Publisher | Purpose |
|---|---|---|
| Markdown All in One | Yu Zhang | Markdown editing, preview, shortcuts |
| markdownlint | David Anson | Keeps docs consistent and lint-free |
| GitHub Copilot | GitHub | Inline code completion (optional if using Claude Code heavily) |
| Extension | Publisher | Purpose |
|---|---|---|
| Rainbow CSV | mechatroner | Makes CSV files readable |
| SQLite Viewer | Florian Klampfer | Browse SQLite databases inline |
| Python | Microsoft | Python language support |
Each project has a .vscode/settings.json file at the root. The minimum configuration for this framework:
{
"claudeCode.selectedModel": "sonnet",
"claudeCode.respectGitIgnore": true
}respectGitIgnore: true ensures Claude Code doesn't index large files in temp/ or data/.
| Action | Mac | Windows/Linux |
|---|---|---|
| Open Claude Code | Cmd+Shift+P → "Claude Code" |
Ctrl+Shift+P → "Claude Code" |
| Toggle terminal | Ctrl+` |
Ctrl+` |
| Open file by name | Cmd+P |
Ctrl+P |
| Search across files | Cmd+Shift+F |
Ctrl+Shift+F |
| Markdown preview | Cmd+Shift+V |
Ctrl+Shift+V |
- Open the project as a workspace (File → Open Folder), not individual files. Claude Code works best with full project context.
- Keep the terminal panel open — you'll use it for git commands and running scripts.
- Use the Source Control panel (
Cmd+Shift+G) to review changes before committing.
- claude-code.md — Claude Code installation and model setup
- github.md — connecting to GitHub
- first-session.md — your first session walkthrough