手把手安装 Claude Code 教程一、什么是 Claude CodeClaude Code 是 Anthropic 推出的一款命令行工具允许开发者通过终端与 Claude 模型进行交互式编程。它基于自然语言理解能够辅助代码编写、调试、解释和重构支持多种主流编程语言并可集成到 VS Code 等编辑器中极大提升开发效率。与网页版 Claude 不同Claude Code 可以直接在您的开发环境中运行通过 API 调用 Claude 模型实现代码生成、文件编辑、项目分析等功能是 AI 辅助开发的高效工具。适用场景快速原型开发代码审查和优化Bug 修复和调试项目文档生成学习新技术栈自动化任务处理二、Claude Code 环境搭建1. 安装 Node.js(1) 为什么需要 Node.jsClaude Code 需要 Node.js 环境的原因如下运行时环境依赖Claude Code 是基于 Node.js 开发的应用程序使用 JavaScript/TypeScript 编写。Node.js 提供了执行 JavaScript 代码的运行时环境是 Claude Code 运行的基础。npm 包管理器Node.js 自带 npmNode Package Manager这是世界上最大的软件注册表。Claude Code 通过 npm 进行分发和安装npm 负责下载、安装和管理 Claude Code 及其依赖包。跨平台兼容性Node.js 支持 Windows、macOS 和 Linux 等多个操作系统使得 Claude Code 能够在不同平台上保持一致的运行体验。异步 I/O 处理Node.js 的事件驱动、非阻塞 I/O 模型非常适合处理 Claude Code 的文件操作、网络请求等异步任务提供高效的性能表现。(2) 安装步骤① 打开 Node.js 官网下载安装包访问 Node.js 官网https://nodejs.org/zh-cn下载步骤进入官网后下载按钮Windows 用户下载的是.msi安装包安装过程双击下载的.msi安装包点击 “Next” 进入下一步勾选 “I accept the terms in the License Agreement”点击 “Next”选择安装路径建议使用默认路径点击 “Next”在功能选择界面确保勾选以下选项Node.js runtime- Node.js 运行时npm package manager- npm 包管理器Add to PATH- 添加到系统环境变量非常重要点击 “Install” 开始安装等待安装完成后点击 “Finish”② 验证安装是否成功安装完成后需要验证 Node.js 和 npm 是否正确安装。打开命令提示符按Win R打开运行对话框输入cmd并按回车验证 Node.jsnode--versionnpm--version如果安装成功将显示 Node.js 的版本号例如常见问题解决如果提示 “node 不是内部或外部命令”说明环境变量未正确配置解决方法重启电脑或手动将 Node.js 安装路径添加到系统环境变量 PATH 中2. 安装 Claude Code(1) 打开 CMD 命令窗口按Win R打开运行对话框输入cmd并按回车(2) 执行安装命令在命令提示符中输入以下命令npminstall-ganthropic-ai/claude-code命令说明npm installnpm 包安装命令-g全局安装标志使 Claude Code 在任何目录下都可使用anthropic-ai/claude-codeClaude Code 的官方包名安装过程安装时间取决于网络状况通常需要几秒到几分钟不等。(3) 验证是否安装完成输入以下命令claude--version输入以下命令claude如果安装成功将显示 Claude Code 的 ASCII 图标和欢迎界面此时表示 Claude Code 已成功安装(4) 为什么需要 API 接入如果你此时跟cladue code 打招呼会显示调用api错误Claude Code 需要接入 API 的原因AI 模型调用Claude Code 本身只是一个命令行客户端工具真正的智能能力来自于云端的大语言模型。API 接入使得 Claude Code 能够调用强大的 AI 模型进行代码生成和分析。Anthropic API 服务官方的 Claude AI 模型由 Anthropic 公司提供需要通过 API Key 进行身份验证和计费。使用官方 API 需要注册 Anthropic 账号并获取 API Key。第三方 API 支持Claude Code 支持接入第三方 API 服务如阿里云千问、Moonshot 等。这些服务提供了与 Claude 兼容的 API 接口可以使用国产模型获得类似的功能。成本控制通过 API 接入用户可以根据使用量付费灵活控制成本。不同的 API 提供商有不同的定价策略用户可以选择最适合自己的方案。Claude Code 本身只是一个客户端工具它需要调用 Anthropic 的 Claude 模型来回答问题或生成代码。而模型调用需要通过 API 进行因此您必须拥有一个有效的 API Key 并配置正确的请求地址Claude Code 才能正常工作。API 接入相当于为 Claude Code 提供了“大脑”。因Claude 模型接入在国内被限制了为了方便所以后面会有接入阿里的千问模型的教学4. 安装 CC Switch(1) CC Switch 的作用CC Switch 是一个专为 Claude Code 设计的 API 管理工具主要作用包括它允许您灵活地在多个 API 提供商如 Anthropic 官方、阿里云百炼等之间切换从而使用不同的 Claude 兼容模型。通过 cc-switch您可以轻松配置非官方的 API 端点例如使用国内云服务商的 Claude 兼容接口无需修改 Claude Code 本身的配置方便在不同网络环境下使用。(2) 安装步骤(1) 打开 CC Switch 下载页面访问 GitHub 发布页面https://github.com/farion1231/cc-switch/releases下载步骤找到最新版本的发布Releases根据您的操作系统选择对应的安装包WindowsCC-Switch-Setup-x.x.x.msimacOSCC-Switch-x.x.x.dmgLinuxCC-Switch-x.x.x.AppImage点击下载对应的安装包安装过程Windows双击下载的.exe安装包如果出现 Windows 安全提示点击 “更多信息” → “仍要运行”选择安装路径点击 “安装”等待安装完成启动 CC Switch(3) 创建千问的 API阿里云千问 API 申请步骤访问阿里云百炼平台https://dashscope.aliyuncs.com/登录阿里云账号如无账号需先注册进入控制台点击左侧菜单 “API-KEY 管理”点击 “创建新的 API-KEY”输入 API-KEY 名称点击确定重要复制生成的 API Key 并妥善保存页面关闭后无法再次查看免费额度说明新用户通常享有免费调用额度不同模型有不同的免费额度限制建议查看官方文档了解具体的免费政策(4) 接入 API(1) 添加 Claude 供应商打开 CC Switch 应用程序在主界面找到 “供应商管理” 或 “Providers” 选项点击 “添加供应商” 或 “Add Provider”选择 “Claude” 或 “Anthropic Compatible” 类型(2) 配置 API 信息依次填写以下信息API:就填你创建的哪个模型随便选一个免费的配置项值API Keysk-9baaa9bdabf849718bb24437d1561bb4请求地址https://dashscope.aliyuncs.com/apps/anthropic模型kimi-k2-thinking填写完成后点击 “添加” 或 “Save” 保存配置。配置说明API Key用于身份验证的密钥从阿里云千问平台获取请求地址API 服务的端点地址阿里云千问提供 Anthropic 兼容接口模型指定使用的 AI 模型不同模型有不同的能力特点(3) 测试模型能否正常使用在 CC Switch 中选择刚添加的供应商点击 “测试连接” 或 “Test Connection” 按钮如果显示连接成功说明配置正确可以发送一条测试消息验证模型响应命令行验证claude然后在 Claude Code 中输入简单问题测试如果收到正常回复说明 API 配置成功如果不使用cc switch 也能配置api创建或编辑 Claude Code 的全局配置文件 ~/.claude/settings.jsonWindows 路径为 %USERPROFILE%.claude\settings.jsonjson{env:{ANTHROPIC_AUTH_TOKEN:sk-9baaa9bdabf849718bb24437d1561bb4,ANTHROPIC_BASE_URL:https://dashscope.aliyuncs.com/apps/anthropic,ANTHROPIC_DEFAULT_HAIKU_MODEL:kimi-k2-thinking,ANTHROPIC_DEFAULT_OPUS_MODEL:kimi-k2-thinking,ANTHROPIC_DEFAULT_SONNET_MODEL:kimi-k2-thinking,ANTHROPIC_MODEL:kimi-k2-thinking,ANTHROPIC_REASONING_MODEL:kimi-k2-thinking},includeCoAuthoredBy:false}三、VS Code 中使用 Claude Code1. 安装 VS CodeVisual Studio Code简称 VS Code是由微软开发的免费、开源、跨平台的代码编辑器是使用 Claude Code 的最佳环境。下载 VS Code访问官网https://code.visualstudio.com/下载步骤点击首页的 “Download for Windows” 按钮下载.exe安装程序安装过程双击下载的安装程序阅读并同意许可协议点击 “下一步”选择安装位置点击 “下一步”选择附加任务建议全选创建桌面快捷方式添加到右键菜单 “通过 Code 打开”将 Code 注册为支持的文件类型的编辑器添加到 PATH点击 “安装”等待安装完成勾选 “启动 Visual Studio Code”点击 “完成”首次启动配置选择主题深色/浅色可以选择导入之前的设置如有进入主界面后可以安装中文语言包按Ctrl Shift X打开扩展面板搜索 “Chinese”安装 “Chinese (Simplified) Language Pack”2. 安装 Claude Code 插件在扩展商店搜索安装打开 VS Code按Ctrl Shift X打开扩展Extensions面板在搜索框中输入Claude Code找到官方插件发布者为 Anthropic点击 “安装”Install按钮等待安装完成使用 Claude Code 插件安装完成后可以通过以下方式使用侧边栏方式点击左侧边栏的 Claude Code 图标在聊天界面中输入问题或指令四、Claude Code 的应用1. 利用 Claude Code 做一款日志 App下面演示如何使用 Claude Code 从零开始创建一个日志应用。项目需求创建一个具有以下功能的日志应用添加日志条目标题、内容、日期、标签查看所有日志列表编辑和删除日志搜索日志功能数据持久化存储使用 Claude Code 开发步骤步骤 1创建项目目录在命令行中执行mkdirjournal-appcdjournal-app claude步骤 2描述项目需求在 Claude Code 中输入请帮我创建一个日志应用要求如下 1. 使用 HTML CSS JavaScript 实现 2. 支持添加、编辑、删除日志 3. 每条日志包含标题、内容、日期、标签 4. 支持搜索功能 5. 使用 localStorage 存储数据 6. 界面美观响应式设计步骤 3Claude Code 自动生成代码Claude Code 将自动创建项目文件结构生成 HTML 页面框架编写 CSS 样式实现 JavaScript 功能逻辑添加必要的交互功能步骤 4测试和优化在开发过程中可以持续与 Claude Code 交互请优化搜索功能支持按日期范围筛选请添加深色模式支持请添加导出日志为 Markdown 格式的功能示例交互流程用户: 请创建一个日志应用的主页面 Claude Code: 我将为您创建日志应用的主页面。 [创建 index.html] [创建 styles.css] [创建 app.js] ... 用户: 请添加标签筛选功能 Claude Code: 我将添加标签筛选功能... [修改 app.js 添加筛选逻辑] [修改 index.html 添加筛选 UI] ...最终项目结构journal-app/ ├── index.html # 主页面 ├── styles.css # 样式文件 ├── app.js # 应用逻辑 └── README.md # 项目说明总结通过本教程您已经学会了✅ Claude Code 的基本概念和功能✅ 安装 Node.js 运行环境✅ 安装 Claude Code 命令行工具✅ 配置 CC Switch 和 API 接入✅ 在 VS Code 中使用 Claude Code✅ 实际应用开发示例现在您可以开始使用 Claude Code 提升您的开发效率了下一期具体介绍claude code 的具体应用包括skillsmcp等安装过程中碰到任何问题欢迎在评论区提问。常见问题解答Q1: Claude Code 安装失败怎么办可能原因及解决方案网络问题配置 npm 镜像源权限问题以管理员身份运行命令提示符Node.js 版本过低升级到 LTS 版本Q2: API 调用失败怎么办检查清单确认 API Key 是否正确确认请求地址是否正确检查网络连接是否正常确认账户余额是否充足Q3: 如何更新 Claude Codenpmupdate-ganthropic-ai/claude-codeQ4: 如何卸载 Claude Codenpmuninstall-ganthropic-ai/claude-code文档版本v1.0更新日期2026年3月适用平台Windows 10/11