Claude Code零基础教程：安装配置到实战全流程

Claude Code 是 Anthropic 推出的命令行 AI 编程工具，正在成为越来越多开发者的效率利器。但对于零基础用户来说，终端操作、权限系统、插件生态等概念可能让人望而却步。本文基于B站UP主木子的系统教程，从安装配置到核心功能，再到实战项目，带你全面掌握 Claude Code 的使用方法。

安装与环境配置

三件套安装：Git、VS Code、Claude Code

使用 Claude Code 之前，需要先安装三个基础工具：

• Git：代码版本管理工具，相当于 AI 编程的"后悔药"。当 AI 修改代码出错时，可以随时回退到之前的版本。Git 不需要你学会使用，它是给 AI 用的，你只需要安装好就行。Git 是由 Linux 之父 Linus Torvalds 于2005年创建的分布式版本控制系统，如今已成为全球软件开发的事实标准。它的核心理念是为项目的每一次变更创建快照（commit），形成一条完整的历史时间线。在 AI 编程场景中，Git 的价值被进一步放大——由于 AI 可能一次性修改大量文件，且修改结果不可预测，Git 的回退能力（git revert/reset）就像一张安全网，让用户可以大胆尝试而不必担心项目被破坏。
• VS Code：代码编辑器，提供可视化的工作界面。没有它，你只能在纯终端里与 Claude Code 对话，看不到文件树，也看不到代码。装上之后，左边看文件、上面看代码、下面跟 AI 对话，效率大幅提升。
• Claude Code：核心工具本体，通过官网提供的一行命令即可在终端中完成安装。

三者的安装都非常简单，搜索官网下载安装包或执行命令行即可完成。

接入第三方模型：绕过使用限制

Claude Code 并不限于使用 Anthropic 自家模型。对于无法直接使用 Claude 模型的用户，可以通过开源项目接入其他厂商的模型。教程推荐了两个工具：CC Switch 和 Claude Code Router，选其一即可。

以 CC Switch 为例，安装后打开应用，点击右上角加号，选择大模型提供商（如 MiniMax、DeepSeek 等），填入 API Key，点击启用。之后再打开 Claude Code，默认模型就会切换为你添加的第三方模型。这个功能对于受限用户来说非常关键。

这里涉及的 API Key（应用程序接口密钥）是用户访问云端 AI 模型服务的身份凭证和计费依据。当你通过 CC Switch 填入某个厂商的 API Key 时，实际上是让 Claude Code 将每次对话请求转发到该厂商的服务器，由其模型完成推理后返回结果。不同厂商的计费方式各异，但通常按输入和输出的 Token 数量分别计价，输出 Token 的单价通常是输入的2-4倍。这种按量付费的模式相比订阅制更加灵活，但也需要用户自行监控用量以控制成本。

界面与权限系统详解

终端界面信息解读

在终端中启动 Claude Code 后，界面会显示以下关键信息：

• 版本号和模型信息：当前使用的模型及推理强度
• 工作目录：当前在哪个文件夹下工作
• Token 消耗：当前对话累积消耗的 Token 数量（注意是累积值，不是单次）
• 上下文使用率：如 CTX 9% 表示已用 9% 的上下文窗口
• 额度使用情况：5小时和7天的订阅额度使用百分比

理解 Token 和上下文窗口对于高效使用 Claude Code 至关重要。Token 是大语言模型处理文本的基本单位，一个中文字通常对应1-2个 Token，一个英文单词约对应1-4个 Token。上下文窗口（Context Window）则是模型在单次对话中能"看到"的最大 Token 数量，Claude 3.5 Sonnet 的上下文窗口为200K Token，约相当于一本中等篇幅的小说。当上下文使用率接近100%时，模型会开始"遗忘"早期对话内容，这就是为什么监控 CTX 百分比如此重要——它直接影响 AI 对项目全局的理解能力。

图形化界面：VS Code 插件

如果你不习惯终端操作，Claude Code 还提供了图形化界面。在 VS Code 的插件市场搜索"Claude Code"，安装 Anthropic 官方插件后，左边栏和右边栏都会出现 Claude Code 图标。

推荐将 Chat 窗口拖到左边栏，右边栏只保留 Claude Code，这样可以同时查看文件树和与 AI 对话。图形化界面提供了对话历史、新建对话、文件上传、上下文管理等功能，操作体验与网页端 AI 聊天类似。

四种权限模式

Claude Code 提供了从保守到激进的四种权限模式：

1. Plan Mode（计划模式）：只做计划，完全不修改任何文件
2. Ask Before Edit（默认模式）：每次修改前征得用户同意
3. Edit Automatically（自动编辑）：常见编辑命令自动执行，但网络请求等高风险操作仍需确认
4. Bypass Permissions（全权模式）：所有操作自动执行，效率最高但风险也最大

实际使用中，建议从 Plan Mode 开始，审核计划后逐步放开权限。在开发过程中，权限模式可以根据需要随时切换，非常灵活。

核心功能深度解析

Tools（工具）：赋予AI动手能力

大模型本身只能思考和输出文字，无法改变环境。Tools 就是赋予它行动能力的关键——如果大模型是大脑，工具就是它的手。

Claude Code 内置了多种工具：Write（写入文件）、Read（读取文件）、Batch（批量执行命令）、Web Search（网络搜索）、Web Fetch（网页抓取）等。当你下达"把主题颜色改成绿色"这样的指令时，AI 会依次调用 Batch 查看文件列表、Read 读取文件内容、Edit 修改代码，整个工具调用过程在界面中清晰可见。

工具调用的底层技术是 Function Calling，这是 OpenAI 于2023年率先推广、随后被各大模型厂商广泛采用的能力。其原理是：开发者预先定义一组函数的名称、参数和描述，模型在推理过程中判断何时需要调用哪个函数，并生成结构化的调用参数。模型本身并不执行函数，而是由外部程序接收调用请求后实际执行。Claude Code 正是基于这一机制，将文件读写、命令执行、网络请求等操作封装为工具，让模型的"思考"能转化为对开发环境的实际操作。

Hooks（钩子）：让AI守规矩的监督机制

Hooks 是在程序运行到关键节点时插入自定义逻辑的机制。常见的关键节点包括：

• Stop：主智能体结束任务前
• SubAgentStop：子智能体结束任务前
• PreToolUse / PostToolUse：调用工具前后
• PostToolUseFailed：工具调用失败后

Hooks 并非 Claude Code 的发明，而是软件工程中历史悠久的设计模式。Git 本身就有 pre-commit、post-merge 等钩子，React 框架的 useState/useEffect 也是钩子的变体，WordPress 的整个插件体系都建立在 action/filter 钩子之上。其核心思想是在程序执行流程的关键节点预留"插槽"，允许用户注入自定义逻辑而无需修改主程序代码。Claude Code 将这一经典模式引入 AI Agent 领域，使用户能在不改变核心推理流程的前提下，对 AI 的行为施加精确控制。

最实用的场景是解决"AI 说做完了但其实没做完"的痛点。例如，创建一个 Stop 钩子，让 AI 在结束任务前自动检查：代码是否通过测试、待办清单是否全部完成。如果没有，就继续工作。创建方式非常简单，用自然语言告诉 Claude Code 你的需求即可。

Skills（技能）：可复用的能力包

Skills 是将反复使用的提示词和工作流程打包成的能力模块。其核心是一个 skills.md 文件，定义了什么时候用、怎么用、按什么步骤做、输出什么格式。

以 Anthropic 官方的 PPTX 技能为例，其文件夹结构包含：

• skills.md：总指挥文件，定义整体流程
• editing.md：编辑现有 PPT 的操作指南
• pptxjs.md：从零创建 PPT 的指南
• scripts/：执行具体操作的代码脚本

你也可以创建自己的 Skills。比如用一句话让 Claude Code 创建一个"Research to Slide"技能——用户给主题后，先搜索信息，再调用 PPTX 技能生成 PPT，实现从调研到演示文稿的自动化流程。

SubAgent（子智能体）：并行工作的专业助手

子智能体是主智能体派出的专门助手，最重要的特性是拥有独立的上下文和工作权限。它在独立空间中完成子任务，只将结果汇报给主智能体，不会污染主对话的上下文。这意味着多个子智能体可以并行工作，大幅提升复杂任务的处理效率。

SubAgent 的设计思想源自多智能体系统（Multi-Agent System, MAS），这是当前 AI 应用架构的重要趋势。斯坦福大学2023年发表的"生成式智能体"论文展示了25个 AI Agent 在虚拟小镇中自主协作的场景，而 AutoGPT、CrewAI、LangGraph 等开源框架也在推动多 Agent 协作的工程化落地。独立上下文是多 Agent 架构的关键设计——如果所有子任务共享同一个上下文，不仅会快速耗尽上下文窗口，还会导致不同任务的信息相互干扰，降低每个子任务的完成质量。

创建子智能体可以通过终端中的 _agents 命令，选择作用范围（项目级或全局），然后用自然语言描述需求。例如创建一个"信息搜索与交叉验证"子智能体，可以指定它使用的工具权限、模型选择，甚至记忆存储方式。

自动化任务：定时执行不停歇

通过 _schedule 命令，可以创建定时任务。例如设置每天早上8点自动调用子智能体搜索前一天的 AI 新闻并交叉验证。

需要注意的是，Claude Code 的自动化任务在云端运行。如果使用的是第三方模型而非 Claude 订阅，云端任务将无法执行，这是目前的一个限制。

实战项目：AI文案生成网页APP

教程最后综合运用所有功能，从零构建了一个"AI HookLab"网页应用——用户输入主题、选择平台和内容类型，AI 一次性生成10个不同风格的爆款开头文案。

开发流程

第一步：需求确认

安装 Superpowers 插件，利用其 Brainstorming 技能进行头脑风暴。插件会主动提问：文案语言？模型提供商？返回方式？风格预设方式？——这些问题精准地覆盖了初始需求的盲点。

第二步：计划制定

Superpowers 的 Writing Plans 技能生成详细的开发计划，并推荐使用子智能体驱动的并行开发模式。

第三步：自动执行

开启 Bypass Permissions 模式，Claude Code 自动完成所有开发任务，包括前端界面、后端 API 对接、功能实现等。

第四步：配置与验收

在 .env.local 文件中填入 DeepSeek API Key，启动本地服务后验收——主题输入、文案生成、复制、收藏、历史记录等功能全部一次性通过。

.env.local 文件是前端开发中管理环境变量的标准做法，由 dotenv 库在2013年推广开来。环境变量用于存储 API 密钥、数据库连接字符串等敏感配置信息，将其与代码分离有两个核心好处：一是安全性，.env 文件通常被加入 .gitignore 以避免密钥泄露到代码仓库；二是灵活性，同一套代码可以通过切换不同的 .env 文件在开发、测试、生产环境间无缝切换。

项目文件结构解析

完成后的 .claude 文件夹清晰地展示了 Claude Code 的扩展能力体系：

• agents/：自定义子智能体
• agent_memory/：子智能体的持久记忆
• skills/：技能包
• plugins/：插件（项目级别）
• claude.md：项目说明书，告诉 Claude Code 技术栈、运行方式、注意事项等

其中 claude.md 可通过 _init 命令自动生成，它会在每次工作时进入上下文，但属于软性规定，建议保持简短。

总结

Claude Code 的核心功能可以用一句话概括：Tools 让 AI 能动手，Hooks 让 AI 守规矩，Skills 让 AI 有经验，SubAgent 让 AI 会分工，自动化让 AI 不停歇。

这些功能组合在一起，构成了一个完整的 AI 编程工作流。对于零基础用户，建议从安装配置开始，逐步尝试各个功能模块，最终通过实战项目将所有知识串联起来。掌握了这套工具链，即使没有编程基础，也能借助 AI 完成从简单脚本到完整应用的开发任务。