Claude Code 的基本使用OverviewClaude Code 安装Claude Code CLIVSCode Claude 安装交互模式操作说明/ —— 操作型命令 —— 上下文注入! -- Bash 命令项目目录结构作用域OverviewClaude Code 是 Anthropic 推出的面向开发者的 AI 编程协作工具。它的定位不是聊天而是在本地代码仓库中执行高权限、可上下文感知的工程任务。Claude Code 不是一个代码生成器而是一个能读项目、懂上下文、遵守约束的 AI 编程搭档。Claude Code 是 Agent智能体工具不是 Chat聊天工具。Claude Code 的核心理念是协作而不是替代。人负责目标、约束、判断和审美AI 负责执行、分析、对比和重复劳动。官方文档「中文」 「英文」GitHub 开源claude-codeClaude Code 安装Claude Code 有几种不同的使用方式Web、App、CLI 和编辑器集成VS Code 等。Claude Code CLI安装「Claude Code CLI 安装与使用」第三方 AI API「Claude Code API 配置」VSCode Claude 安装VSCode Claude Code 基本的安装和使用「VS Code 安装 Claude Code」Windows 下使用 VSCode Claude Code① 安装 VS Code 和 Claude Code for VS Code 插件② 安装 Git Bash并设置环境变量Windows 上 Claude Code 报错 “requires git-bash“ 的完整解决方案③ 如果需要第三方 AI API配置流程如下打开 C:\Users${username}\AppData\Roaming\Code\User\setting.json 文件也可以通过 VS Code 打开添加如下内容重启 VS Code交互模式使用 Claude Code 最简单直接的方法就是问他问题然后它回答。但是Claude Code 并不是一个单纯的聊天工具而是一个具备工程上下文、权限控制和执行能力的开发协作系统。因此在处理任务时它有三种核心的思维模式也就是工作模式或交互模式Ask询问、Plan规划和 Edit编辑。在 VS Code 插件中可以手动切换交互模式使用 Claude Code 时其实不需要手动切换交互模式Claude 会根据的指令内容自动判断当前应进入哪一种模式。Ask只看不动Ask 模式是 Claude Code 的默认安全模式。该模式下Claude 可以读取代码可以进行分析、解释、推理绝对不会修改任何文件也不会执行任何 Shell 命令。Plan谋定而后动该模式下Claude 不会直接改代码只会先给出完整的实施方案通常以步骤列表TODO List的形式呈现。用户确认方案后才进入 Edit 阶段执行。可以直接进入 plan 模式让 Claude Code 给出某件事情的一个具体的解决方案。Edit直接执行当你已经明确知道要改哪、改成什么并且改动风险可控此时就可以直接进入 Edit 模式。在该模式下Claude 会定位相关文件生成精确的 Diff差异修改。这个过程中可能会请求执行测试、构建等命令。默认情况下所有的所有写入操作都需要用户确认。Ask 是搞清楚问题Plan 是避免走弯路Edit 是谨慎执行。在 VS Code Claude 中使用shift tab可以在三种工作模式之间进行切换。操作说明Claude Code 的输入框不是纯聊天框而是一个AI 编辑器 命令调度器的融合终端。在 Claude Code 的输入框输入一些特殊字符可以触发不同的功能/ —— 操作型命令/是 Claude Code 中触发内置命令工具的核心符号类似终端命令行的指令前缀用于告诉 Claude 执行特定操作而非单纯生成文本。/后紧跟命令关键词是 Claude Code 区分自然语言对话和代码操作指令的关键。在对话框输入/会自动弹出命令列表:一些常见高频命令的功能如下命令作用/help查看全部能力/clear清空对话/plan进入 Plan Mode/model切换模型/context查看上下文使用情况/export导出对话/status环境状态/tasks管理后台任务/theme主题切换/memory编辑 CLAUDE.md在 VS Code Claude 中使用/context命令可以看到如下图所示的上下文使用情况 —— 上下文注入是引用文件或目录在输入文件名的时候Claude Code 会主动联想。的一些基本使用示例如下引用单个文件main.py 帮我检查 bug npm-debug.log 找出失败原因引用多个文件main.py main2.py 这两个是否有重复逻辑引用目录 路径src/ 分析项目结构并给出优化建议! – Bash 命令通过在输入前加上!可以直接运行 bash 命令无需通过 Claude。例如查看当前目录下的文件项目目录结构使用 Claude Code 的时候整个项目的目录结构应该是这样的your-project/ ├── src 项目代码 │ ├── api/ 项目代码 │ ├── services/ 项目代码 │ └── models/ 项目代码 ├── CLAUDE.md ← 团队共享指令提交到git├── CLAUDE.local.md ← 个人覆盖被git忽略 └── .claude/ ├── settings.json ← 权限 配置提交到git├── settings.local.json ← 个人权限被git忽略 ├── commands/ ← 自定义斜杠命令 │ ├── review.md → /project:review │ ├── fix-issue.md → /project:fix-issue │ └── deploy.md → /project:deploy ├── rules/ ← 模块化指令文件全局生效 │ ├── code-style.md │ ├── testing.md │ └── api-conventions.md ├── skills/ ← 自动调用的工作流 │ ├── security-review/ │ │ └── SKILL.md │ └── deploy/ │ └── SKILL.md └── agents/ ← 子代理角色定义 ├── code-reviewer.md └── security-auditor.mdsrcsrc就是项目目录包含当前项目相关的所有文件。CLAUDE.mdClaude 进入项目时第一个读取的文件相当于项目欢迎手册。CLAUDE.md 通常放在项目根目录所有团队成员共享它告诉 Claude这个项目是什么、如何运行、有什么约定。CLAUDE.md 的用法和 Skill 一样基本就是##后面加一个标题表示描述的内容然后后面直接写内容即可。例如设置一些写代码时的常用规则。## Code Conventions- 使用 snake_case 命名变量 - 所有 API 需要写单元测试 - PR 合并前必须通过 CICLAUDE.local.md个人专属的覆盖层优先级高于 CLAUDE.md 之上用于个性化设置或者临时指令。比如你从 GItHub 上拉一个项目下来准备优化某一部分内容你就可以在 CLAUDE.local.md 中写一些和本次优化相关的命令或规则。.claude/settings.json – 权限与配置中心给 Claude Code 设置权限控制 Claude 允许或禁止执行哪些操作。该文件一般是团队共享的配置文件用做团队安全基线。settings.local.json个人本地权限覆盖临时放开或收紧某些权限不影响团队其他成员。.claude/commands/ – 自定义斜杠命令该目录下每个 .md 文件会自动映射为一条/project:文件名命令。比如你再.claude/commands/目录下放一个my_data.md文件文件中的内容如下输入/my_date之后Claude Code 最终会输出如下内容.claude/rules/ – 模块化行为规则将 CLAUDE.md 中的规则拆分模块化存放Claude 在整个会话中始终遵守。适合存放长期稳定执行的行为约定避免 CLAUDE.md 过于臃肿。.claude/skills/ – 自动调用的工作流Skills 是更高级的复合工作流。当 Claude 判断某个任务适合某个 skill 时会自动读取并执行对应的 SKILL.md无需手动调用。Commands 需要用户主动输入斜杠命令触发是工具箱而 Skills 由 Claude 根据上下文自动判断是否调用是智能本能。.claude/agents/ – 子代理角色定义可被主 Claude 实例派遣的专业子代理。在复杂任务中主代理将子任务委派给对应专家角色实现多代理协作。子代理在隔离上下文中运行拥有独立的权限范围。子代理本质上是带 YAML frontmatter 的 Markdown 文件。示例agents/code-reviewer.md--- name: code-reviewer description: 资深代码审查员专注代码质量与可维护性 ---# 代码审查员## 角色定位你是一名拥有10年经验的资深工程师专注于代码可读性、性能优化和最佳实践。## 审查重点- 命名是否清晰表达意图 - 函数/类的单一职责原则 - 边界条件和错误处理 - 性能瓶颈N1 查询、不必要的循环等## 权限只读访问不直接修改文件。## 输出格式使用 Markdown 表格输出包含问题位置、严重程度、建议方案。作用域settings.json是一个配置文件Claude Code 使用作用域系统来决定配置文件的生效范围。Claude Code 中有如下四个作用域当多个作用域中有相同的配置的时优先级从高到底的排序如下Managed (highest)- can’t be overridden by anythingCommand line arguments- temporary session overridesLocal- overrides project and user settingsProject- overrides user settingsUser (lowest)- applies when nothing else specifies the setting除了setting.json之外Claude Code 的一些其他文件也有类似的作用域
【AI】【Claude Code】 基本使用
发布时间：2026/6/10 4:13:20
Claude Code 的基本使用OverviewClaude Code 安装Claude Code CLIVSCode Claude 安装交互模式操作说明/ —— 操作型命令 —— 上下文注入! -- Bash 命令项目目录结构作用域OverviewClaude Code 是 Anthropic 推出的面向开发者的 AI 编程协作工具。它的定位不是聊天而是在本地代码仓库中执行高权限、可上下文感知的工程任务。Claude Code 不是一个代码生成器而是一个能读项目、懂上下文、遵守约束的 AI 编程搭档。Claude Code 是 Agent智能体工具不是 Chat聊天工具。Claude Code 的核心理念是协作而不是替代。人负责目标、约束、判断和审美AI 负责执行、分析、对比和重复劳动。官方文档「中文」 「英文」GitHub 开源claude-codeClaude Code 安装Claude Code 有几种不同的使用方式Web、App、CLI 和编辑器集成VS Code 等。Claude Code CLI安装「Claude Code CLI 安装与使用」第三方 AI API「Claude Code API 配置」VSCode Claude 安装VSCode Claude Code 基本的安装和使用「VS Code 安装 Claude Code」Windows 下使用 VSCode Claude Code① 安装 VS Code 和 Claude Code for VS Code 插件② 安装 Git Bash并设置环境变量Windows 上 Claude Code 报错 “requires git-bash“ 的完整解决方案③ 如果需要第三方 AI API配置流程如下打开 C:\Users${username}\AppData\Roaming\Code\User\setting.json 文件也可以通过 VS Code 打开添加如下内容重启 VS Code交互模式使用 Claude Code 最简单直接的方法就是问他问题然后它回答。但是Claude Code 并不是一个单纯的聊天工具而是一个具备工程上下文、权限控制和执行能力的开发协作系统。因此在处理任务时它有三种核心的思维模式也就是工作模式或交互模式Ask询问、Plan规划和 Edit编辑。在 VS Code 插件中可以手动切换交互模式使用 Claude Code 时其实不需要手动切换交互模式Claude 会根据的指令内容自动判断当前应进入哪一种模式。Ask只看不动Ask 模式是 Claude Code 的默认安全模式。该模式下Claude 可以读取代码可以进行分析、解释、推理绝对不会修改任何文件也不会执行任何 Shell 命令。Plan谋定而后动该模式下Claude 不会直接改代码只会先给出完整的实施方案通常以步骤列表TODO List的形式呈现。用户确认方案后才进入 Edit 阶段执行。可以直接进入 plan 模式让 Claude Code 给出某件事情的一个具体的解决方案。Edit直接执行当你已经明确知道要改哪、改成什么并且改动风险可控此时就可以直接进入 Edit 模式。在该模式下Claude 会定位相关文件生成精确的 Diff差异修改。这个过程中可能会请求执行测试、构建等命令。默认情况下所有的所有写入操作都需要用户确认。Ask 是搞清楚问题Plan 是避免走弯路Edit 是谨慎执行。在 VS Code Claude 中使用shift tab可以在三种工作模式之间进行切换。操作说明Claude Code 的输入框不是纯聊天框而是一个AI 编辑器 命令调度器的融合终端。在 Claude Code 的输入框输入一些特殊字符可以触发不同的功能/ —— 操作型命令/是 Claude Code 中触发内置命令工具的核心符号类似终端命令行的指令前缀用于告诉 Claude 执行特定操作而非单纯生成文本。/后紧跟命令关键词是 Claude Code 区分自然语言对话和代码操作指令的关键。在对话框输入/会自动弹出命令列表:一些常见高频命令的功能如下命令作用/help查看全部能力/clear清空对话/plan进入 Plan Mode/model切换模型/context查看上下文使用情况/export导出对话/status环境状态/tasks管理后台任务/theme主题切换/memory编辑 CLAUDE.md在 VS Code Claude 中使用/context命令可以看到如下图所示的上下文使用情况 —— 上下文注入是引用文件或目录在输入文件名的时候Claude Code 会主动联想。的一些基本使用示例如下引用单个文件main.py 帮我检查 bug npm-debug.log 找出失败原因引用多个文件main.py main2.py 这两个是否有重复逻辑引用目录 路径src/ 分析项目结构并给出优化建议! – Bash 命令通过在输入前加上!可以直接运行 bash 命令无需通过 Claude。例如查看当前目录下的文件项目目录结构使用 Claude Code 的时候整个项目的目录结构应该是这样的your-project/ ├── src 项目代码 │ ├── api/ 项目代码 │ ├── services/ 项目代码 │ └── models/ 项目代码 ├── CLAUDE.md ← 团队共享指令提交到git├── CLAUDE.local.md ← 个人覆盖被git忽略 └── .claude/ ├── settings.json ← 权限 配置提交到git├── settings.local.json ← 个人权限被git忽略 ├── commands/ ← 自定义斜杠命令 │ ├── review.md → /project:review │ ├── fix-issue.md → /project:fix-issue │ └── deploy.md → /project:deploy ├── rules/ ← 模块化指令文件全局生效 │ ├── code-style.md │ ├── testing.md │ └── api-conventions.md ├── skills/ ← 自动调用的工作流 │ ├── security-review/ │ │ └── SKILL.md │ └── deploy/ │ └── SKILL.md └── agents/ ← 子代理角色定义 ├── code-reviewer.md └── security-auditor.mdsrcsrc就是项目目录包含当前项目相关的所有文件。CLAUDE.mdClaude 进入项目时第一个读取的文件相当于项目欢迎手册。CLAUDE.md 通常放在项目根目录所有团队成员共享它告诉 Claude这个项目是什么、如何运行、有什么约定。CLAUDE.md 的用法和 Skill 一样基本就是##后面加一个标题表示描述的内容然后后面直接写内容即可。例如设置一些写代码时的常用规则。## Code Conventions- 使用 snake_case 命名变量 - 所有 API 需要写单元测试 - PR 合并前必须通过 CICLAUDE.local.md个人专属的覆盖层优先级高于 CLAUDE.md 之上用于个性化设置或者临时指令。比如你从 GItHub 上拉一个项目下来准备优化某一部分内容你就可以在 CLAUDE.local.md 中写一些和本次优化相关的命令或规则。.claude/settings.json – 权限与配置中心给 Claude Code 设置权限控制 Claude 允许或禁止执行哪些操作。该文件一般是团队共享的配置文件用做团队安全基线。settings.local.json个人本地权限覆盖临时放开或收紧某些权限不影响团队其他成员。.claude/commands/ – 自定义斜杠命令该目录下每个 .md 文件会自动映射为一条/project:文件名命令。比如你再.claude/commands/目录下放一个my_data.md文件文件中的内容如下输入/my_date之后Claude Code 最终会输出如下内容.claude/rules/ – 模块化行为规则将 CLAUDE.md 中的规则拆分模块化存放Claude 在整个会话中始终遵守。适合存放长期稳定执行的行为约定避免 CLAUDE.md 过于臃肿。.claude/skills/ – 自动调用的工作流Skills 是更高级的复合工作流。当 Claude 判断某个任务适合某个 skill 时会自动读取并执行对应的 SKILL.md无需手动调用。Commands 需要用户主动输入斜杠命令触发是工具箱而 Skills 由 Claude 根据上下文自动判断是否调用是智能本能。.claude/agents/ – 子代理角色定义可被主 Claude 实例派遣的专业子代理。在复杂任务中主代理将子任务委派给对应专家角色实现多代理协作。子代理在隔离上下文中运行拥有独立的权限范围。子代理本质上是带 YAML frontmatter 的 Markdown 文件。示例agents/code-reviewer.md--- name: code-reviewer description: 资深代码审查员专注代码质量与可维护性 ---# 代码审查员## 角色定位你是一名拥有10年经验的资深工程师专注于代码可读性、性能优化和最佳实践。## 审查重点- 命名是否清晰表达意图 - 函数/类的单一职责原则 - 边界条件和错误处理 - 性能瓶颈N1 查询、不必要的循环等## 权限只读访问不直接修改文件。## 输出格式使用 Markdown 表格输出包含问题位置、严重程度、建议方案。作用域settings.json是一个配置文件Claude Code 使用作用域系统来决定配置文件的生效范围。Claude Code 中有如下四个作用域当多个作用域中有相同的配置的时优先级从高到底的排序如下Managed (highest)- can’t be overridden by anythingCommand line arguments- temporary session overridesLocal- overrides project and user settingsProject- overrides user settingsUser (lowest)- applies when nothing else specifies the setting除了setting.json之外Claude Code 的一些其他文件也有类似的作用域
