通俗版 Claude Code 文档

结构照原 docs,内容改成真能照着做的人话版。

查看原始文档 目录顺序与官方保持一致

平台和集成

VS Code

VS Code 这一页讲的,就是 VS Code 这件事在 Claude Code 里到底怎么用。

页面信息

对应原页

VS Code

页面性质

第三方中文解释页

使用建议

先看人话解释,再对照原页命令和代码

这页不是官方原文,而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留,解释部分则尽量讲成人能照着做的话。

如果你碰到特别敏感的配置、权限或企业环境差异,最好顺手点上面的“查看原始文档”再核一遍。

这一页先讲明白

VS Code 集成让你在编辑器里直接用 Claude Code。

好处是写代码、看 diff、继续对话都在一个地方完成。

这就像把帮工请到你常坐的工位边上,不用总在终端和编辑器之间来回跑。

尤其适合边看文件边讨论改动。

如果你平时主力就是 VS Code,这通常是最顺手的入口。

先用它做局部修改、解释代码、审查差异,熟了再处理更大的任务。

预留广告位

正文中段响应式广告 等你后面真接 AdSense,这里再放正式广告。

Documentation Index

这里不是让你背"Documentation Index"这个词,而是让你看它真干活时怎么使。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Prerequisites

这一块主要是在说"Prerequisites"真到手上该怎么用,哪里最容易踩坑。

Install the extension

这里属于实操步骤,重点是照着顺序做,不要自己脑补省略中间步骤。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Get started

看到这里,就把"Get started"当成一件真要上手的活来看。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Use the prompt box

这一段不只是挂个标题,它是在说明"Use the prompt box"这一块到底负责什么。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Reference files and folders

看到这里,就别靠猜了,字段、格式和写法都得按说明来。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

直接对 Claude 说

Reference files and folders

最省事的做法,就是把下面这句原样说给 Claude。

> Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)
> What's in @src/components/ (include a trailing slash for folders)

Resume past conversations

看到这里,就把"Resume past conversations"当成一件真要上手的活来看。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Resume remote sessions from Claude.ai

这一段更像在讲判断条件,什么时候该上,什么时候先别急。把触发条件看清,比背标题更重要。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Customize your workflow

这一块主要是在说"Customize your workflow"真到手上该怎么用,哪里最容易踩坑。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Choose where Claude lives

这段主要是让你挑,不是让你全要。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Run multiple conversations

这一段是在说怎么用 Open in New Tab or Open in New Window from the Command Palette to start additional conversations. Each conversation maintains its own history and context, allowing you 去做 work on different tasks in parallel.。看这种内容,光知道名字没用,还是得落到手上。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Switch to terminal mode

这里不是让你背"Switch to terminal mode"这个词,而是让你看它真干活时怎么使。

Manage plugins

这里讲的是收放和管理,不只是"能不能用",而是"怎么管住、怎么不乱"。

Install plugins

这段就是手把手操作,照顺序来最稳。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Manage marketplaces

看到这类标题,就把它当成日常管摊子的规矩。

Automate browser tasks with Chrome

这一段主要是在把"Automate browser tasks with Chrome"讲实,不是只摆个标题给你看。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

VS Code commands and shortcuts

这一段主要是在把"VS Code commands and shortcuts"讲实,不是只摆个标题给你看。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Launch a VS Code tab from other tools

这里主要是在交代"Launch a VS Code tab from other tools"这一块会碰到哪些事。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

终端里敲

Launch a VS Code tab from other tools 1

真到动手的时候了,下面这条直接敲一遍,看它回什么。

open "vscode://anthropic.claude-code/open"
终端里敲

Launch a VS Code tab from other tools 2

真到动手的时候了,下面这条直接敲一遍,看它回什么。

xdg-open "vscode://anthropic.claude-code/open"
终端里敲

Launch a VS Code tab from other tools 3

真到动手的时候了,下面这条直接敲一遍,看它回什么。

Start-Process "vscode://anthropic.claude-code/open"
终端里敲

Launch a VS Code tab from other tools 4

真到动手的时候了,下面这条直接敲一遍,看它回什么。

start "" "vscode://anthropic.claude-code/open"

Configure settings

这里讲怎么把某个开关拧对。重点不是概念,而是你该在哪儿改、改完怎么确认生效。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Extension settings

这里不是让你背"Extension settings"这个词,而是让你看它真干活时怎么使。

VS Code extension vs. Claude Code CLI

这一块主要是在说"VS Code extension vs. Claude Code CLI"真到手上该怎么用,哪里最容易踩坑。

Rewind with checkpoints

这段看着像个标题,其实是在说"Rewind with checkpoints"管到哪儿。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Run CLI in VS Code

这一段主要是在把"Run CLI in VS Code"讲实,不是只摆个标题给你看。

Switch between extension and CLI

这段看着像个标题,其实是在说"Switch between extension and CLI"管到哪儿。

Include terminal output in prompts

这一块主要是在说"Include terminal output in prompts"真到手上该怎么用,哪里最容易踩坑。

Monitor background processes

这一段更像在讲判断条件,什么时候该上,什么时候先别急。把触发条件看清,比背标题更重要。

Connect to external tools with MCP

这一块主要是在说"Connect to external tools with MCP"真到手上该怎么用,哪里最容易踩坑。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

终端里敲

Connect to external tools with MCP

看到这里,别光点头,下面这条命令先跑起来再说。

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

Work with git

看到这里,就把"Work with git"当成一件真要上手的活来看。

Create commits and pull requests

这一段主要是在把"Create commits and pull requests"讲实,不是只摆个标题给你看。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

直接对 Claude 说

Create commits and pull requests

最省事的做法,就是把下面这句原样说给 Claude。

> commit my changes with a descriptive message
> create a pr for this feature
> summarize the changes I've made to the auth module

Use git worktrees for parallel tasks

这一段是在说怎么用 the --worktree (-w) flag 去做 start Claude in an isolated worktree with its own files and branch:。看这种内容,光知道名字没用,还是得落到手上。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

终端里敲

Use git worktrees for parallel tasks

看到这里,别光点头,下面这条命令先跑起来再说。

claude --worktree feature-auth

Use third-party providers

看到这里,就把"Use third-party providers"当成一件真要上手的活来看。

如果你看到环境变量或 settings.json,意思通常都是:这不是会话里临时喊一声就行,而是要把开关真正写进环境或配置。

照着做一遍

这页属于“VS Code”这类活,最稳的办法还是一小步一小步来。

下面这三步不一定华丽,但通常最不容易绕晕。

第 1 步:先起步

如果你平时主力就是 VS Code,这通常是最顺手的入口。

第 2 步:边做边看

先用它做局部修改、解释代码、审查差异,熟了再处理更大的任务。

一眼看懂这一页

这页的作用,就是把原本偏专业的话题,拆成能直接照着走的明白话。

VS Code
   |
   v
VS Code 这一页讲的,就是 VS Code 这件事在 Claude Code 里到底怎么用。
   |
   v
照着步骤去做

文末提醒

这站会按官方 docs 的导航和内容变化继续重生成,原站加页、删页、改页时,这里会跟着更新。

人话解释会尽量顺着原页往下讲,但命令、参数名、配置名这些硬东西还是保留原样,免得你抄过去跑不起来。