Claude Code 完整入门教程

摘要本文是一篇面向零基础小白的 Claude Code 完整入门教程。文章从模型、Chatbot、Agent、API Key、Token、上下文窗口、Skill 到 MCP 等核心概念扫盲入手然后以 Windows 为例逐步讲解 Git Bash、Node.js 和 Claude Code 的安装配置最后详细演示了如何借助 cc-switch 接入 DeepSeek 等国产模型用更低的门槛和成本开启 AI 编程之旅。前言欢迎来到 Claude Code 的入门世界如果你刚听说 “AI 写代码” “用自然语言让 AI 帮你调试程序”但对 Claude Code 还一知半解那这篇文章就是为你准备的。Claude Code 是 Anthropic 推出的一款 AI 编程助手它可以直接在你的终端或 IDE 中工作理解你的自然语言指令然后帮你写代码、改代码、查 bug、解释项目结构甚至帮你自动完成复杂的重构任务。本教程会从最基础的概念讲起让你先弄清楚 “到底是什么” 然后再一步步带你上手实践。全文采用 “说人话” 的方式让零基础的小白也能看懂、跟上、用得起来。第一章 核心概念扫盲在正式动手之前我们先厘清几个关键概念。理解了这些词你后面看教程、读文档都会轻松很多。1.1 模型ModelClaude 与 Claude Code 的关系模型Model是 AI 的 大脑它通过学习海量数据获得了理解语言、生成文本、编写代码等能力。你可以把模型想象成一个超级聪明的毕业生它脑子里装满了知识但需要合适的工具和界面才能帮你干活。Claude是 Anthropic 公司开发的 AI 模型名称类似 OpenAI 的 GPT。Claude Code则是基于这些模型打造的一个编程专用产品可以理解为 会操作你电脑里代码的 AI 助手。简单记模型是大脑Claude Code 是给大脑配上的双手和工具。1.2 聊天机器人Chatbot与 AI Agent这两个词经常被混用但含义差别很大聊天机器人Chatbot你问一句它答一句。很多网页上的 AI 对话窗口就是典型的 Chatbot例如平常用的豆包app以及Deepseek等都是的。AI Agent智能体不仅能聊天还能自主完成多步骤的复杂任务。它会自己规划步骤、调用工具比如读取文件、搜索网页、执行命令、根据中间结果调整策略直到达成目标。像一个有执行力的助手你只需要说 帮我搭建一个博客项目它就能自己分析需求、创建文件、安装依赖、写出代码。三个最核心的概念model(模型) 大脑只会用来思考问题Chatbot(聊天机器人) 大脑嘴只会说不会做AI Agent智能体大脑工具嘴会说会做1.3 API Key、Token、上下文窗口Context Window、Harness这几个词是使用 AI 开发工具时最常碰到的基础术语逐一拆解API Key密钥是一串加密字符串用于验证你的身份和调用 AI 服务的权限。使用 Claude Code 需要你有一个 Anthropic 的 API Key它会根据每次对话消耗的 token 数量进行计费类似按量付费的云服务。注册 Anthropic 账号后可以在控制台生成 Key。不用担心官方有免费额度可以让你先体验花费也非常透明。Token令牌AI 模型不是按字理解文本的而是把文本拆成一个个叫 Token 的小片段。一句英文可能几个 Token一个复杂的中文字可能 1~2 个 Token。输入的文字越长、越复杂消耗的 Token 就越多相应的计费也越高。上下文窗口Context Window指模型一次能记住和处理的最大 Token 数量。它就像一个临时记忆区窗口越大AI 一次能装进脑子的内容就越多。如果在一轮对话中输入和输出的内容加起来超过了上下文窗口上限模型就会忘记最早的内容。Harness工具集成/编排框架原意指马具用来驾驭马匹的装备在技术领域引申为把各种能力整合起来的框架或平台。在 AI 编程工具中Harness 可以理解为把模型、工具、数据源、权限管理串联在一起的基础设施层让 AI 能顺畅地调用各种能力而不是孤立地回答问题。1.4 Skill、MCP模型上下文协议Skill技能可以理解为给 AI 安装的 能力插件。每个 Skill 本质上是一组预定义的指令、工具调用规则和领域知识让 AI 在特定场景下表现得更专业。比如安装一个 代码审查 SkillAI 就会自动按代码规范逐行审查给出改进建议安装一个 数据库查询 SkillAI 就知道怎么安全地连接数据库、写 SQL、解读查询结果。Skill 的好处是 开箱即用不需要每次手动告诉 AI 该怎么做也降低了重复配置的成本。MCPModel Context Protocol模型上下文协议是 Anthropic 推出的一个开放协议用于标准化 AI 模型与外部工具、数据源之间的连接方式。通俗地说以前每个 AI 工具要对接一个新的数据源比如数据库、文件系统、第三方 API都需要单独写一套 连接代码费时费力还不通用。MCP 就像给 AI 世界定了一个 USB 接口标准只要工具和数据源都遵循 MCP 协议AI 就能像插 U 盘一样随时接入安全地读取数据、调用能力。Claude Code 全面支持 MCP这意味着你可以通过 MCP 让 Claude Code 连接你的私有数据库、内部文档系统、项目管理工具等极大扩展了它的实际工作能力,同时调用相关的模型。1.5 总结一下整套关系你人 ⇅ 用自然语言交流 Claude CodeAgent — 装上 MCP 后能连外部工具 ⇅ 调用 模型Claude / GLM / MiniMax / Kimi... ⇅ 消耗 Token电费第二章 环境安装与配置Windows在开始使用 Claude Code 之前我们需要先在电脑上装好几样东西。别担心整个过程就像安装三个普通软件一样跟着步骤走就行。2.1 安装 Git BashClaude Code 需要在终端命令行里运行而 Windows 自带的命令提示符CMD功能比较弱。Git Bash 会给你一个类 Linux 的命令行环境用起来顺手很多而且它还自带 Git 版本管理工具。下载地址https://git-scm.com/downlods/win安装步骤打开上面的网址点击64-bit Git for Windows Setup下载安装包现在大部分电脑都是 64 位不用担心选错。双击下载好的.exe文件一路点Next默认选项就够用了不用改任何设置。安装完成后在桌面空白处右键如果菜单里出现Git Bash Here或Open Git Bash here就说明装成功了。点击打开 Git Bash你会看到一个黑底白字的命令行窗口——这就是你以后和 Claude Code 对话的地方。2.2 安装 Node.jsClaude Code 是基于 Node.js 开发的它就像一个运行环境没有它 Claude Code 就跑不起来。装 Node.js 就像你玩游戏之前要先装 Steam 一样。下载地址Node.js — Run JavaScript Everywhere安装步骤打开上面的网址你会看到两个版本LTS长期支持版和 Current最新尝鲜版。新手请一定选 LTS 版本它最稳定、兼容性最好页面左边的绿色大按钮就是 LTS。下载后双击.msi安装文件一路Next全部用默认设置即可。关键一步安装过程中有一个页面叫 Tools for Native Modules记得勾选那个复选框它会自动帮你装一些编译工具后面用得着。验证安装装完后打开 Git Bash输入下面这条命令如果能正确显示版本号比如 v20.x.x就说明 Node.js 装好了node -v顺便也检查一下 npmNode.js 自带的包管理器输入npm -v两条都能显示版本号这一步就通过了。如果npm -v报错先跑一条命令再试Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser2.3 安装 Claude Code有了 Git Bash 和 Node.js装 Claude Code 就只需要一条命令。打开 Git Bash输入npm install -g anthropic-ai/claude-code这条命令的意思是用 npmNode.js 的包管理器全局安装-gClaude Code。安装过程可能需要一两分钟中间会看到很多进度条在跑耐心等它跑完就行。或者以管理员身份打开PowerShellcmdx)输入命令Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned然后选Y回车然后安装Cloude Code:npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com验证安装安装完成后输入在powershell中 claude -v如果出现下边的图恭喜你——Claude Code 已经成功装到你电脑上了2.4 验证整体环境最后做一次全面检查确保三样东西都妥妥的。在 Git Bash 里依次运行git --version node -v npm -v claude --version四条命令都能返回版本号你的 Claude Code 开发环境就全部就绪了。下一章我们将学习怎么开始第一次对话、配置 API Key正式开启 AI 编程之旅。第三章 装上cc-switch给Claude Code配国产模型前面我们已经装好了 Claude Code但它默认只能调用 Anthropic 官方的 Claude 模型需要海外信用卡和 API Key对国内用户来说门槛不低。这时候就需要cc-switch出场了——它是一个模型切换工具能让 Claude Code 无缝对接国产大模型用更低的价格、更快的速度、更方便的支付方式享受 AI 编程体验。3.1 下载安装 cc-switchcc-switch 的官方仓库在 GitHub 上但国内直接访问 GitHub 下载速度很慢甚至无法连接。推荐使用国内镜像加速下载。https://gitee.com/iamzhihuix/cc-switch-mirrorWindows 用户打开国内镜像下载页面在 Releases 列表中找到最新版本。在下载列表中找到以.msi结尾的安装包例如cc-switch-Setup-1.0.0.msi点击下载。下载完成后双击.msi文件开始安装一路点击 Next使用默认设置即可。安装完成后建议以管理员身份运行cc-switch在开始菜单找到 cc-switch右键选择「以管理员身份运行」这样可以确保它有足够的权限去修改 Claude Code 的配置文件。Mac 用户同样访问国内镜像下载页面在 Releases 中找到最新版本。找到以.dmg结尾的安装包例如cc-switch-1.0.0.dmg点击下载。下载完成后双击.dmg文件在弹出的窗口中将 cc-switch 图标拖入 Applications 文件夹即可完成安装。首次打开时如果提示无法验证开发者进入「系统偏好设置 → 安全性与隐私」点击「仍要打开」即可。3.2 获取 API Key这里以deep seek为例cc-switch 支持多种国产模型这里以DeepSeek为例因为它性价比高、代码能力出色非常适合编程场景。DeepSeek 目前推荐使用V4-Pro或V4-Flash模型前者推理能力更强后者响应速度更快、价格更低。获取步骤打开 DeepSeek 官网DeepSeek注册并登录账号支持手机号注册国内用户友好。进入控制台后点击左侧菜单的「API Keys」或「密钥管理」。点击「创建 API Key」给 Key 起个名字比如 claude-code然后复制生成的密钥字符串。妥善保存这个 Key它只显示一次关闭后就看不到了。新用户通常有免费额度可以先体验再决定是否充值。模型选择建议V4-Pro适合复杂代码重构、大型项目理解、多文件协同修改等重度场景推理深度更高。V4-Flash适合日常编码、快速问答、简单调试等轻量场景响应快、成本低日常使用完全够用。3.3 在 cc-switch 中配置 DeepSeek拿到 API Key 之后接下来在 cc-switch 中进行配置。配置顺序很重要请按以下步骤操作第一步打开 cc-switch以管理员身份启动 cc-switchWindows 右键选择「以管理员身份运行」Mac 直接打开即可。第二步选择模型提供商在 cc-switch 主界面中点击「添加提供商」或「Provider」下拉菜单选择DeepSeek。如果列表中没有 DeepSeek可以选择「自定义 Provider」或「OpenAI Compatible」因为 DeepSeek 的 API 接口兼容 OpenAI 格式。第三步填写连接信息按照以下顺序依次填写API Base URL填入https://api.deepseek.com这是 DeepSeek 官方的 API 地址。API Key粘贴你在上一步复制的 DeepSeek API Key。Model 名称填入deepseek-v4-pro或deepseek-v4-flash根据你的需求选择。第四步保存并激活填写完成后点击「保存」或「Save」然后在主界面将刚配置的 DeepSeek 设为当前激活的模型通常会有一个开关或勾选按钮。第五步设置全局默认可选如果你希望 Claude Code 始终使用 DeepSeek可以在 cc-switch 的设置中勾选「设为默认」或「Set as Default」这样每次启动 Claude Code 都会自动走 DeepSeek 通道。3.4 验证配置是否成功配置完成后打开 Git Bash 或 PowerShell输入以下命令启动 Claude Codeclaude进入 Claude Code 的交互界面后随便问一个问题比如你现在用的是什么模型如果它回答的是 DeepSeek 相关模型名称那就确认无误可以正式开始用国产模型写代码了。常见问题排查如果 Claude Code 提示连接失败先检查 API Base URL 是否填对Key 是否完整粘贴注意前后没有多余空格。如果提示模型不存在检查 Model 名称是否拼写正确推荐使用deepseek-v4-pro或deepseek-v4-flash。如果 cc-switch 无法启动尝试以管理员身份重新运行。至此你已经成功用 cc-switch 把 Claude Code 接上了国产 DeepSeek 模型。相比官方 Claude 模型DeepSeek 在国内访问更快、费用更低而且 V4-Pro 和 V4-Flash 的代码能力也经过了大量实战验证完全可以胜任日常开发工作。