Claude Code 安装教程(小白版)

Claude Code终极指南:2025终端智能编程工具免费安装教程 摘要:ClaudeCode是由Anthropic开发的智能编程工具,支持自然语言交互进行代码编辑、错误修复、架构解释、质量检查和版本控制等核心功能。使用前需满足系统要求并获取访问权限,安装简单通过npm即可完成。该工具能显著提升开发效率,未来将进一步提升稳定性和终端体验。开发者可通过智创聚合API以更低成本使用该服务。 阅读详情
AI摘要

本文详细介绍了 Claude Code——一款可在终端中运行的AI编程助手的完整安装与配置流程。涵盖Node.js前置依赖安装、npm全局安装方法、Cursor图形化引导方案;重点说明如何配置国内可用的智谱AI GLM-5系列模型API Key及多模型切换机制;并提供权限错误处理、PATH配置、配置文件生效验证等常见问题解决方案,适用于前端/后端开发者快速启用本地AI编码能力。

Claude Code 安装教程(小白版)

什么是 Claude Code?

Claude Code 是一个智能编码助手,它可以在你的命令行终端中运行。你可以像和真人聊天一样,用自然语言告诉它你想做什么(比如"帮我写一个函数"、“修复这个bug”),它会自动帮你完成代码编写、调试、重构等任务。

主要特点:

  • 在终端中直接对话,无需切换窗口
  • 自动读取和理解你的项目代码
  • 可以直接修改文件、执行命令
  • 支持 GLM Coding Plan(智谱 AI 的模型)

前置准备

1. 安装 Node.js(必需)

Claude Code 需要 Node.js 18 或更高版本。

检查是否已安装 Node.js

打开终端(Terminal),输入:

node --version
npm --version
  • 如果显示版本号(如 v18.x.x 或 v20.x.x),说明已安装,可以跳过这一步
  • 如果提示"命令未找到",需要先安装 Node.js
安装 Node.js

Mac 用户推荐方式:使用 nvm(版本管理器)

nvm 可以让你在同一台电脑上安装和管理多个 Node.js 版本。

  1. 安装 nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
  1. 重新打开终端,或执行以下命令使 nvm 生效:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
  1. 安装最新的 Node.js LTS 版本:
nvm install --lts
nvm use lts
  1. 设置为默认版本:
nvm alias default lts/*

Mac 用户备用方式:使用 Homebrew

# 如果没有安装 Homebrew,先安装它
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node

Windows 用户:

  1. 访问 Node.js 官网
  2. 下载 LTS 版本(长期支持版)
  3. 运行安装程序,一路"下一步"即可

同时安装 Git for Windows(Windows 用户必需):

  1. 访问 Git 官网
  2. 下载并安装,使用默认设置即可

安装 Claude Code

方式一:npm 命令行安装(推荐)

  1. 打开终端(Mac/Linux)或 PowerShell/CMD(Windows)

  2. 执行安装命令:

npm install -g @anthropic-ai/claude-code
  1. 验证安装是否成功:
claude --version

如果显示版本号(如 2.0.14),说明安装成功!

方式二:使用 Cursor 编辑器引导安装

如果你有 Cursor 编辑器但不熟悉命令行:

  1. 打开 Cursor
  2. 按 Cmd + L(Mac)或 Ctrl + L(Windows)打开聊天面板
  3. 输入:Help me install Claude Code
  4. Cursor 会引导你完成安装过程

配置国内模型

Claude Code需要接入大模型才能发挥作用,对于国内环境各个模型大厂都推出了Coding Plan套餐,以下以智谱AI的为例,安装完成后,需要配置智谱 AI 的 API Key 才能使用GLM-5模型。

获取 API Key

  1. 访问 智谱 AI 开放平台
  2. 注册/登录账号
  3. 进入"API Key"管理页面
  4. 创建新的 API Key 并复制保存

配置方式

  1. 启动 Claude Code:
claude
  1. 首次启动会提示配置 API,选择"Manual setup"或手动配置

  2. 配置环境变量:

export ANTHROPIC_API_KEY="你的API_Key"

Windows PowerShell 用户:

$env:ANTHROPIC_API_KEY="你的API_Key"
  1. 永久保存配置(推荐):

创建或编辑配置文件 ~/.claude/settings.json(Mac/Linux)或 %USERPROFILE%\.claude\settings.json(Windows):

{
  "env": {
    "ANTHROPIC_API_KEY": "你的API_Key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/paas/v4/"
  }
}

开始使用

1. 启动 Claude Code

进入你的项目目录,然后运行:

cd /path/to/your/project
claude

2. 首次启动

  • Claude Code 会询问是否信任该目录,选择 “Trust” 或 “Yes”
  • 这样 Claude Code 才能读取和修改你的项目文件

3. 基本使用

启动后,你可以直接输入自然语言命令:

示例:

> 帮我写一个 Python 函数,计算斐波那契数列
> 解释这个函数的作用
> 找出代码中所有的 console.log 并删除
> 运行测试用例

常用命令:

  • /help - 查看帮助信息
  • /status - 查看当前配置和状态
  • /exit - 退出 Claude Code

切换模型(可选)

Claude Code 支持多种智谱 AI 模型,你可以手动切换。

修改配置文件

编辑 ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_API_KEY": "你的API_Key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/paas/v4/",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5"
  }
}

模型说明:

  • glm-4.5-air:轻量级模型,响应快速,适合简单任务
  • glm-4.7:主力模型,平衡性能和质量
  • glm-5:最新模型,能力最强,适合复杂任务

验证配置

重新启动 Claude Code,输入 /status 查看当前使用的模型。


常见问题

Q1: npm install 提示权限错误(Mac/Linux)

解决方案:

# 使用 sudo 安装(不推荐,但最简单)
sudo npm install -g @anthropic-ai/claude-code

# 或配置 npm 全局目录(推荐)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code

Q2: 配置文件修改后不生效

解决步骤:

  1. 关闭所有 Claude Code 窗口
  2. 重新打开终端
  3. 再次运行 claude 启动
  4. 如果问题仍存在,删除 ~/.claude/settings.json,重新配置

Q3: 如何升级到最新版本?

# 检查当前版本
claude --version

# 升级到最新版本
claude update

推荐使用最新版本以获得最佳体验。

Q4: Windows 下提示找不到 claude 命令

解决方案:

  1. 确保 npm 全局安装路径在系统 PATH 中
  2. 查找 npm 全局路径:npm config get prefix
  3. 将该路径下的 bin 目录添加到系统环境变量 PATH 中
  4. 或使用 PowerShell 重新安装:npm install -g @anthropic-ai/claude-code

Q5: 如何在项目中使用?

进入任何项目目录后启动:

cd /path/to/your/project
claude

Claude Code 会自动扫描并理解项目结构,可以帮你完成:

  • 代码生成和补全
  • Bug 修复和调试
  • 代码重构和优化
  • 添加注释和文档

推荐工作流

日常开发流程

  1. 启动项目
cd my-project
claude
  1. 描述需求
> 帮我创建一个用户登录页面,使用 HTML + CSS + JavaScript
  1. 迭代优化
> 给登录按钮添加 hover 效果
> 添加表单验证功能
  1. 调试问题
> 为什么点击登录后没有反应?帮我检查代码

团队协作

  • Claude Code 可以读取整个项目代码库
  • 可以帮你理解别人的代码
  • 可以协助 Code Review
  • 可以生成文档和注释

进阶配置

配置视觉 MCP 服务器(图片识别)

如果你需要让 Claude Code 识别和分析图片,可以配置视觉 MCP 服务器。

参考文档:视觉MCP服务器

配置搜索 MCP 服务器(联网搜索)

如果你需要让 Claude Code 搜索最新信息,可以配置搜索 MCP 服务器。

参考文档:搜索MCP服务器

配置网页读取 MCP 服务器

如果你需要让 Claude Code 读取网页内容,可以配置网页读取 MCP 服务器。

参考文档:网页读取MCP服务器


总结

安装 Claude Code 只需要三步:

  1. ✅ 安装 Node.js 18+
  2. ✅ 运行 npm install -g @anthropic-ai/claude-code
  3. ✅ 配置智谱 AI API Key

安装后,在任何项目目录运行 claude 即可开始使用!


参考资源


作者博客:http://xiejava.ishareread.com/

Claude Code 2026 安装教程:原生安装器已发布,告别 Node.js 依赖 2026 年起,Anthropic 推出了 Claude Code 原生安装器,不再依赖 Node.js 和 npm。这篇教程覆盖 Windows / macOS / Linux 三种平台的安装、首次配置和常见问题。 阅读详情

相关推荐

Claude Code 国内直接用, 原生支持 Windows 免WSL安装教程

Claude Code 最新版本重磅更新,正式支持 Windows 原生运行,彻底告别了繁琐的 WSL 配置。Windows 用户终于可以像 Mac 和 Linux 用户一样,直接享受 Claude Code 带来的 AI 编程体验。

科技与狠活的博客 3622

Claude Code 完整指南(一):安装、CLI 实战、IDE 集成一次讲透

Claude Code 是 Anthropic 推出的工程级 AI 编程助手,能够理解代码仓库、跨文件修改代码、执行命令并运行测试,直接参与项目开发。本文作为《Claude Code 完整指南》系列第一篇,从 安装部署 入手,通过 CLI 实战 演示真实工程场景,并介绍 JetBrains 与 VS Code 的集成使用方式,帮助开发者快速上手并在实际项目中使用 Claude Code。

阿甘兄 5万+

Claude Code 新手安装指南,手把手教你怎么安装使用

如果你是企业内网用户,或者需要自定义 API 端点,那可以用手动配置 API Key 的方式。

篮球界最会写bug的人;程序猿中打球最菜的人。 507

Claude Code 安装与配置完整指南(0827更新)

Claude COde

全栈川川 7万+

在claude code desktop中安装pdf处理skill的实战教程

本文介绍了在Claude Code Desktop中安装PDF处理Skill的详细教程。针对国内用户使用第三方API时无法直接调用官方插件的问题,提供了完整的解决方案。教程从下载Anthropic官方Skills源码开始,逐步演示了如何将PDF处理模块打包、上传至Claude Code Desktop,并最终成功加载使用。整个过程采用全流程拆解方式,确保新手也能快速上手。通过本文,读者可以掌握在非官方环境下扩展Claude Code功能的方法,从而提升工作效率

weixin_43178406的博客 9万+

vue3接入大华摄像头

┃ ┃ ┣ 📜PlaybackModal.vue 回放列表模态框。┃ ┃ ┗ 📜VideoGrid.vue 视频播放区域。┃ ┃ ┣ 📜ControlPanel.vue 控制面板。┃ ┃ ┣ 📜DeviceList.vue 设备列表。┃ ┣ 📂module //大华摄像头文件。

💻 专注 Vue 前端与 Java 后端技术 🌱 目前正在深入 Spring Boot、微服务与性能优化 📝 定期分享实战踩坑经验与学习笔记 🤝 欢迎交流,共同进步 916

Claude Code安装教程---Windows系统

Claude Code安装教程---Windows系统

weixin_62944327的博客 1581

转录因子详细介绍(motif)

转录因子详细介绍(motif) TF: transcription factor转录因子TFBS: transcription factor binding site转录因子结合位点TFBS是序列内的location,TF特异结合在这里,这个site有这种特点 1 和一些参考相关的一个位置(开始,结束,strand),这些reference可以是染色体开始,geneTSS。也可以是一段sequence 2 A SITE可以是实验证实的(已知的),也可以是一些算法(预测的) 3 例子,下面这个图是酵母

wangprince2017 3万+

Claude code接入vscode教程【新手友好向快速安装指南】

还在为编程苦恼吗?快来试试claude code吧!本文将会以简单明了的步骤教你如何claude code接入vscode中,大幅提升你的编程效率!

2401_83999275的博客 3489

Python 格点数据插值到站点 最邻近插值 双线性插值

python 气象数据格点数据插值到站点,最邻近插值法,双线性插值法

好记性不如烂笔头 8461

【Qt】Window环境下搭建Qt6、MSVC2022开发环境(无需提前安装Visual Studio)

本文介绍 Windows 环境下无需安装 Visual Studio,搭建 Qt6 与 MSVC2022 开发环境的方法,以节省磁盘空间。核心步骤包括:用中科大镜像提速 Qt6 在线安装,需勾选 Qt Creator 17.0.1、MSVC 2022 x64 等组件;配置环境变量,添加 mingw_64、msvc2022_64 及 Qt Creator 的二进制目录;安装 MSVC 2022 编译器与 Windows 10 SDK 并记录版本;配置 Qt Creator 构建套件,可选设置 vcvarsal

油炸自行车的博客 2940

windows安装Claude Code完整教程

windows安装Claude Code、OpenAI Codex完整教程

weixin_46528266的博客 2878

④ Django创建用户中心应用users,扩展用户信息

本章配套视频教程 Django创建用户中心应用users,扩展用户数据 在settings.py文件中配置项目 1、语言配置:LANGUAGE_CODE = 'zh-hans’ 2、时区配置:TIME_ZONE = 'Asia\Shanghai’ 3、模板路径配置:‘DIRS’: [os.path.join(BASE_DIR, ‘templates’)], 并创建templates文件

轻编程的博客 675

Claude Code小白快速安装教程(保姆级教程)

AI编程的强大有目共睹,我先后试用过多款AI编辑器,尤其对比了TRAE和Claude Code后,更能感受到两者的差距,推荐使用Claude Code开发体验试试

新林的博客 2244

Unity实战篇 | 教你怎样将Unity的启动Logo 设置成 自己制作的 帧动画

上一篇文章我们讲了怎样在不购买专业版的情况下自定义Unity的启动Logo。 那本篇文章就来介绍一下,怎样在去除默认Logo的前提下制作自己的启动动画!

努力前行,总会成为自己心中的那道光 6万+

全志F1C200S嵌入式驱动开发(lcd屏幕驱动)

【 声明:版权所有,欢迎转载,请勿用于商业用途。 联系信箱:feixiaoxing @163.com】 lcd RGB屏幕作为比较经济、实用的显示工具,在实际场景中使用较多。它的信号来说,一般也比较简单,除了常规的数据信号,剩下来就是行同步、场同步、数据使能和时钟信号了。数据信号方面,常见的格式有RGB888、RGB666、RGB565。为什么有什么多选择,主要还是取决于soc pin脚的多少来定。当然,pin脚越多,显示的颜色就越精准,还原度就越高。 举例来说,假设

嵌入式-老费,一个分享专业嵌入式知识的blog 2798

Claude Code 从零上手:国内用户保姆级安装教程

摘要:本文提供Windows平台安装ClaudeCode框架的完整教程,无需海外账号和支付方式。ClaudeCode作为顶级AI编程框架,支持接入国产模型如DeepSeekV4Flash/Pr。教程包含四个关键步骤:1)通过npm安装ClaudeCode;2)下载配置CC-SWITCH工具;3)设置国产模型API;4)编写CLAUDE.md行为准则文件。特别说明CLAUDE.md文件的行数限制和分层管理机制,并提供了可直接复用的模板。最后推荐结合VSCode插件使用,实现更直观的交互体验。整个过程完全规避了

2301_80163384的博客 1663

Autosar CAN 网络管理标准文档

Autosar CAN 网络管理标准文档

蚂蚁小兵 926

Windows 系统安装 Claude Code 完整教程

✅先装 Git- 这是前提条件✅用 PowerShell 安装- 以管理员身份运行✅配置 PATH- 让系统能找到claude命令✅重启终端- 让 PATH 配置生效✅记住命令名是claude- 不是按照本教程,整个安装过程大约需要10-15 分钟。

ycoder的博客 947

计算机控制技术及应用

《计算机控制技术及应用》通过总结作者的科研成果和吸收国内外的先进理论、方法和技术,以计算机控制系统的网络化、开放化、智能化和集成化发展趋势为主线索,主要介绍计算机控制系统的基本概念和计算机控制系统的典型形式,计算机控制系统的数学描述与基本分析方法,以及数字PID控制器、最少拍控制系统、达林算法、状态变量设计法等设计方法及其各种改进算法。重点突出计算机控制系统输入输出通道接口的设计方法和典型控制系统的设计案例与实现方法等。

lwip-2.0.3

lwip是瑞典计算机科学院(SICS)的Adam Dunkels 开发的一个小型开源的TCP/IP协议栈。实现的重点是在保持TCP协议主要功能的基础上减少对RAM 的占用。

Claude Code安装入门教程指南(Windows版)

Claude Code 是Anthropic 推出的一款Agent编码工具,支持在终端运行,理解代码库,并通过自然语言命令帮助用户更快的编写代码,功能和Cursor类似,但claude code是一个命令行工具,它没有UI界面。

Tizzy的博客 1742

win10 跳过U8环境检测的IE WebControls.rar

win10 安装u8的时候 提示IE WebControls 不通过,这个工具可以欺骗u8的检查。 跳过U8环境检测的IE WebControls。提示导入失败后,重新检测通过。

Claude Code 安装使用教程(可使用第三方API)

Claude Code 是一个强大的 AI 编程助手,让您可以直接在终端中与 AI 协作编程。本教程将指导您完成安装和配置过程。

LY_API的博客 8695

VB摄像头监控

该VB模块可对摄像头捕获的画面进行录像等,可在创建的窗口进行控制

保姆级安装Claude code 并接入各类中外大模型教程

最近不少程序员朋友的耳朵估计都快被磨出了茧子了。很多人都说,这东西写代码能力稳居,强得离谱。今天就给大家带来一份 安装Claude code保姆级教程:从,一步一步教你搞定。

weixin_49003975的博客 7864

Claude Code 最新详细安装教程

Windows用户现可直接安装使用Claude Code编程工具,无需通过WSL虚拟机。安装步骤包括:1)通过命令行安装nvm工具管理node版本(推荐18+);2)全局安装Claude Code;3)配置系统环境变量(需提前注册账号获取Token);4)在项目目录启动Claude Code并选择主题模式。注意事项:需使用魔法工具访问,安装过程需信任文件授权。相比被限制国内IP的Cursor,Claude Code提供了更便捷的本地开发体验,但使用时需审查代码安全性。

Jack_num1的博客 7350

Claude Code 安装及接入 DeepSeek 教程

详细介绍 Claude Code CLI 的安装、通过 CC Switch 中转接入 DeepSeek 模型的完整流程,以及在终端、VS Code、JetBrains 中的使用配置。

欢迎访问我的个人博客:https://www.lxpavilion.top/ 823

Claude Code安装教程

下载适合你操作系统的最新稳定版本(LTS)进行安装😊如果已经下载了旧的版本,建议卸载后重新安装:node -v。

· 6240
上一篇: 网络安全资产画像实战
下一篇: OpenClaw 小白安装部署完全指南
xiejava1018
xiejava1018 优质创作者: 人工智能技术领域 优质创作者: 人工智能技术领域
博客等级 码龄24年 4万+粉丝 292原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

xiejava1018

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值