手把手安装 Claude Code 教程

一、什么是 Claude Code

Claude Code 是 Anthropic 推出的一款命令行工具，允许开发者通过终端与 Claude 模型进行交互式编程。它基于自然语言理解，能够辅助代码编写、调试、解释和重构，支持多种主流编程语言，并可集成到 VS Code 等编辑器中，极大提升开发效率。

与网页版 Claude 不同，Claude Code 可以直接在您的开发环境中运行，通过 API 调用 Claude 模型，实现代码生成、文件编辑、项目分析等功能，是 AI 辅助开发的高效工具。

适用场景

  • 快速原型开发
  • 代码审查和优化
  • Bug 修复和调试
  • 项目文档生成
  • 学习新技术栈
  • 自动化任务处理

二、Claude Code 环境搭建

1. 安装 Node.js

(1) 为什么需要 Node.js

Claude Code 需要 Node.js 环境的原因如下：

  1. 运行时环境依赖：Claude Code 是基于 Node.js 开发的应用程序，使用 JavaScript/TypeScript 编写。Node.js 提供了执行 JavaScript 代码的运行时环境，是 Claude Code 运行的基础。

  2. npm 包管理器：Node.js 自带 npm（Node Package Manager），这是世界上最大的软件注册表。Claude Code 通过 npm 进行分发和安装，npm 负责下载、安装和管理 Claude Code 及其依赖包。

  3. 跨平台兼容性：Node.js 支持 Windows、macOS 和 Linux 等多个操作系统，使得 Claude Code 能够在不同平台上保持一致的运行体验。

  4. 异步 I/O 处理：Node.js 的事件驱动、非阻塞 I/O 模型非常适合处理 Claude Code 的文件操作、网络请求等异步任务，提供高效的性能表现。

(2) 安装步骤
① 打开 Node.js 官网下载安装包

访问 Node.js 官网：https://nodejs.org/zh-cn

在这里插入图片描述

下载步骤：

  1. 进入官网后，下载按钮
  2. Windows 用户下载的是 .msi 安装包

安装过程：

  1. 双击下载的 .msi 安装包
  2. 点击 “Next” 进入下一步
  3. 勾选 “I accept the terms in the License Agreement”，点击 “Next”
  4. 选择安装路径（建议使用默认路径），点击 “Next”
  5. 在功能选择界面，确保勾选以下选项：
    • Node.js runtime - Node.js 运行时
    • npm package manager - npm 包管理器
    • Add to PATH - 添加到系统环境变量（非常重要！）
  6. 点击 “Install” 开始安装
  7. 等待安装完成后点击 “Finish”
② 验证安装是否成功

安装完成后，需要验证 Node.js 和 npm 是否正确安装。

打开命令提示符：

  • 按 Win + R 打开运行对话框
  • 输入 cmd 并按回车

验证 Node.js：

node --version
npm --version

如果安装成功，将显示 Node.js 的版本号，例如：

在这里插入图片描述

常见问题解决：

  • 如果提示 “node 不是内部或外部命令”，说明环境变量未正确配置
  • 解决方法：重启电脑，或手动将 Node.js 安装路径添加到系统环境变量 PATH 中

2. 安装 Claude Code

(1) 打开 CMD 命令窗口
  • 按 Win + R 打开运行对话框
  • 输入 cmd 并按回车
(2) 执行安装命令

在命令提示符中输入以下命令：
在这里插入图片描述

npm install -g @anthropic-ai/claude-code

命令说明：

  • npm install：npm 包安装命令
  • -g：全局安装标志，使 Claude Code 在任何目录下都可使用
  • @anthropic-ai/claude-code：Claude Code 的官方包名

安装过程：

安装时间取决于网络状况，通常需要几秒到几分钟不等。

(3) 验证是否安装完成

输入以下命令：

claude --version

在这里插入图片描述

输入以下命令：

claude

如果安装成功，将显示 Claude Code 的 ASCII 图标和欢迎界面：

在这里插入图片描述

此时表示 Claude Code 已成功安装！

(4) 为什么需要 API 接入

如果你此时跟cladue code 打招呼，会显示调用api错误
在这里插入图片描述

Claude Code 需要接入 API 的原因：

  1. AI 模型调用：Claude Code 本身只是一个命令行客户端工具，真正的智能能力来自于云端的大语言模型。API 接入使得 Claude Code 能够调用强大的 AI 模型进行代码生成和分析。

  2. Anthropic API 服务：官方的 Claude AI 模型由 Anthropic 公司提供，需要通过 API Key 进行身份验证和计费。使用官方 API 需要注册 Anthropic 账号并获取 API Key。

  3. 第三方 API 支持：Claude Code 支持接入第三方 API 服务，如阿里云千问、Moonshot 等。这些服务提供了与 Claude 兼容的 API 接口，可以使用国产模型获得类似的功能。

  4. 成本控制：通过 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

下载步骤：

  1. 找到最新版本的发布（Releases）
  2. 根据您的操作系统选择对应的安装包：
    • Windows：CC-Switch-Setup-x.x.x.msi
    • macOS：CC-Switch-x.x.x.dmg
    • Linux：CC-Switch-x.x.x.AppImage
  3. 点击下载对应的安装包

安装过程（Windows）：
在这里插入图片描述

  1. 双击下载的 .exe 安装包
  2. 如果出现 Windows 安全提示，点击 “更多信息” → “仍要运行”
  3. 选择安装路径，点击 “安装”
  4. 等待安装完成
  5. 启动 CC Switch
(3) 创建千问的 API

阿里云千问 API 申请步骤：

  1. 访问阿里云百炼平台：https://dashscope.aliyuncs.com/
  2. 登录阿里云账号（如无账号需先注册）
  3. 进入控制台，点击左侧菜单 “API-KEY 管理”
  4. 点击 “创建新的 API-KEY”
  5. 输入 API-KEY 名称，点击确定
  6. 重要：复制生成的 API Key 并妥善保存，页面关闭后无法再次查看
    在这里插入图片描述
    在这里插入图片描述
    在这里插入图片描述

免费额度说明：

  • 新用户通常享有免费调用额度
  • 不同模型有不同的免费额度限制
  • 建议查看官方文档了解具体的免费政策
    在这里插入图片描述
(4) 接入 API
(1) 添加 Claude 供应商
  1. 打开 CC Switch 应用程序
  2. 在主界面找到 “供应商管理” 或 “Providers” 选项
  3. 点击 “添加供应商” 或 “Add Provider”
  4. 选择 “Claude” 或 “Anthropic Compatible” 类型
    在这里插入图片描述
(2) 配置 API 信息

依次填写以下信息：
API:就填你创建的哪个
模型：随便选一个免费的

配置项 值
API Key sk-9baaa9bdabf849718bb24437d1561bb4
请求地址 https://dashscope.aliyuncs.com/apps/anthropic
模型 kimi-k2-thinking

填写完成后，点击 “添加” 或 “Save” 保存配置。
在这里插入图片描述
在这里插入图片描述

配置说明：

  • API Key：用于身份验证的密钥，从阿里云千问平台获取
  • 请求地址：API 服务的端点地址，阿里云千问提供 Anthropic 兼容接口
  • 模型：指定使用的 AI 模型，不同模型有不同的能力特点
(3) 测试模型能否正常使用
  1. 在 CC Switch 中选择刚添加的供应商
  2. 点击 “测试连接” 或 “Test Connection” 按钮
  3. 如果显示连接成功，说明配置正确
  4. 可以发送一条测试消息验证模型响应
    在这里插入图片描述
    在这里插入图片描述

命令行验证：

claude

然后在 Claude Code 中输入简单问题测试：

在这里插入图片描述
在这里插入图片描述

如果收到正常回复，说明 API 配置成功！

如果不使用cc switch 也能配置api

创建或编辑 Claude Code 的全局配置文件 ~/.claude/settings.json（Windows 路径为 %USERPROFILE%.claude\settings.json）：

json
{
  "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 Code

1. 安装 VS Code

Visual Studio Code（简称 VS Code）是由微软开发的免费、开源、跨平台的代码编辑器，是使用 Claude Code 的最佳环境。

下载 VS Code

访问官网：https://code.visualstudio.com/

下载步骤：

  1. 点击首页的 “Download for Windows” 按钮
  2. 下载 .exe 安装程序
安装过程
  1. 双击下载的安装程序
  2. 阅读并同意许可协议，点击 “下一步”
  3. 选择安装位置，点击 “下一步”
  4. 选择附加任务（建议全选）：
    • 创建桌面快捷方式
    • 添加到右键菜单 “通过 Code 打开”
    • 将 Code 注册为支持的文件类型的编辑器
    • 添加到 PATH
  5. 点击 “安装”
  6. 等待安装完成
  7. 勾选 “启动 Visual Studio Code”，点击 “完成”
首次启动配置
  1. 选择主题（深色/浅色）
  2. 可以选择导入之前的设置（如有）
  3. 进入主界面后，可以安装中文语言包：
    • 按 Ctrl + Shift + X 打开扩展面板
    • 搜索 “Chinese”
    • 安装 “Chinese (Simplified) Language Pack”

2. 安装 Claude Code 插件

在扩展商店搜索安装
  1. 打开 VS Code
  2. 按 Ctrl + Shift + X 打开扩展（Extensions）面板
  3. 在搜索框中输入 Claude Code
  4. 找到官方插件（发布者为 Anthropic）
  5. 点击 “安装”（Install）按钮
  6. 等待安装完成

在这里插入图片描述

使用 Claude Code 插件

安装完成后，可以通过以下方式使用：
在这里插入图片描述

  1. 侧边栏方式：
    • 点击左侧边栏的 Claude Code 图标
    • 在聊天界面中输入问题或指令

四、Claude Code 的应用

1. 利用 Claude Code 做一款日志 App

下面演示如何使用 Claude Code 从零开始创建一个日志应用。

项目需求

创建一个具有以下功能的日志应用：

  • 添加日志条目（标题、内容、日期、标签）
  • 查看所有日志列表
  • 编辑和删除日志
  • 搜索日志功能
  • 数据持久化存储
使用 Claude Code 开发步骤

步骤 1：创建项目目录

在命令行中执行：

mkdir journal-app
cd journal-app
claude

步骤 2：描述项目需求

在 Claude Code 中输入：

请帮我创建一个日志应用，要求如下：
1. 使用 HTML + CSS + JavaScript 实现
2. 支持添加、编辑、删除日志
3. 每条日志包含标题、内容、日期、标签
4. 支持搜索功能
5. 使用 localStorage 存储数据
6. 界面美观，响应式设计

步骤 3：Claude Code 自动生成代码

Claude Code 将自动：

  1. 创建项目文件结构
  2. 生成 HTML 页面框架
  3. 编写 CSS 样式
  4. 实现 JavaScript 功能逻辑
  5. 添加必要的交互功能

步骤 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       # 项目说明

总结

通过本教程，您已经学会了：

  1. ✅ Claude Code 的基本概念和功能
  2. ✅ 安装 Node.js 运行环境
  3. ✅ 安装 Claude Code 命令行工具
  4. ✅ 配置 CC Switch 和 API 接入
  5. ✅ 在 VS Code 中使用 Claude Code
  6. ✅ 实际应用开发示例

现在您可以开始使用 Claude Code 提升您的开发效率了！

下一期具体介绍claude code 的具体应用包括skills，mcp等，安装过程中碰到任何问题欢迎在评论区提问。

常见问题解答

Q1: Claude Code 安装失败怎么办？

可能原因及解决方案：

  • 网络问题：配置 npm 镜像源
  • 权限问题：以管理员身份运行命令提示符
  • Node.js 版本过低：升级到 LTS 版本

Q2: API 调用失败怎么办？

检查清单：

  • 确认 API Key 是否正确
  • 确认请求地址是否正确
  • 检查网络连接是否正常
  • 确认账户余额是否充足

Q3: 如何更新 Claude Code？

npm update -g @anthropic-ai/claude-code

Q4: 如何卸载 Claude Code？

npm uninstall -g @anthropic-ai/claude-code

文档版本：v1.0
更新日期：2026年3月
适用平台：Windows 10/11

# vscode # python
Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

C 语言也能玩转事件循环与信号槽？深入异步通信机制的实现

本文介绍了如何在纯C语言中实现高效、线程安全的事件循环(EventLoop)和信号槽(Signal-Slot)系统。通过XThread、XThreadData、XSignalSlot、XEvent和XEventLoop等核心模块，构建了一套仿Qt风格的异步编程基础设施。系统包含线程管理、信号槽机制、事件分发等关键功能，支持跨线程通信和异步事件处理。文章详细阐述了各模块的设计原理和协作机制，并展示了

avatar AtomGit开源社区

Redis

Redis是一个开源的基于内存的键值对数据库基于内存，读写速度极快，可以处理大量读写请求。支持多种数据结构，如字符串、哈希、列表、集合、有序集合等，具有丰富的数据表示能力。支持主从复制，提供数据冗余和故障恢复能力。支持持久化，可以将内存数据保存到磁盘中。支持事务，可以一次执行多个命令。丰富的功能，可用于缓存、消息队列等场景。主要应用场景包括：1、缓存常见的使用场景，比如缓存查询结果、热点数据等，大

avatar AtomGit开源社区
cover

用Gemma 4构建自托管OCR

avatar AtomGit开源社区