CodeWalk
Interactive AI-powered code tours with voice narration — powered by the AI you already have.
CodeWalk lets you walk through any codebase step by step, with AI-generated explanations spoken aloud. It works with your existing GitHub Copilot or Claude Code subscription — no extra API key or account needed.
Why CodeWalk?
Jumping into an unfamiliar codebase is hard. CodeWalk turns it into a guided tour: select a file or function, and CodeWalk explains it to you in plain English, out loud, one step at a time. Whether you're onboarding to a new project, reviewing a pull request, or revisiting code you wrote months ago, CodeWalk makes it faster to understand what's actually going on.
Features
- AI explanations powered by your existing tools — connects to GitHub Copilot or Claude Code CLI automatically. No new subscriptions, no API keys required.
- Voice narration — explanations are read aloud using high-quality local text-to-speech (no internet needed for voice).
- Step-by-step navigation — move forward and backward through code steps with keyboard shortcuts or the sidebar panel.
- Sidebar panel — a clean UI inside VS Code to start, stop, and follow along with tours.
- Multiple AI providers — auto-detects your setup, or you can manually choose: Copilot, Claude Code, Anthropic API, OpenAI API, or a custom endpoint.
- Configurable — control voice speed, model, context size, and more from VS Code settings.
AI Providers
CodeWalk works with what you already have installed:
| Provider |
What you need |
| GitHub Copilot |
Copilot extension installed and active |
| Claude Code |
Claude Code CLI installed (claude in PATH) |
| Anthropic API |
An Anthropic API key |
| OpenAI API |
An OpenAI API key |
| Custom |
Any OpenAI-compatible API endpoint |
By default, CodeWalk is set to auto — it detects Copilot first, then falls back to Claude Code, then API keys.
Getting Started
- Install CodeWalk from the VS Code Marketplace.
- Open any project.
- Press
Cmd+Shift+W (Mac) or Ctrl+Shift+W (Windows/Linux) to open the CodeWalk panel.
- Click Start Tour — CodeWalk will begin explaining your code, step by step, with voice narration.
Keyboard Shortcuts
| Action |
Mac |
Windows / Linux |
| Open panel |
Cmd+Shift+W |
Ctrl+Shift+W |
| Next step |
Cmd+Shift+] |
Ctrl+Shift+] |
| Previous step |
Cmd+Shift+[ |
Ctrl+Shift+[ |
Settings
| Setting |
Default |
Description |
codewalk.aiProvider |
auto |
AI provider to use (auto, copilot, claudecode, anthropic, openai, custom) |
codewalk.voiceEnabled |
true |
Enable or disable voice narration |
codewalk.voiceSpeed |
0.9 |
Speech speed (0.5 – 2.0) |
codewalk.claudeCodeModel |
haiku |
Claude Code model (haiku, sonnet, opus) |
codewalk.apiModel |
claude-sonnet-4-6 |
Model for Anthropic/OpenAI API |
codewalk.autoAdvance |
false |
Auto-advance to next step after explanation |
codewalk.requestTimeout |
180 |
Seconds to wait for AI response |
Requirements
- VS Code 1.85 or later
- At least one of: GitHub Copilot extension, Claude Code CLI, or an API key
License
MIT — see LICENSE.txt
| |
