当前位置： 首页 > news >正文

Claude Code 安装教程（小白版）

news 2026/5/11 20:34:54

Claude Code 安装教程（小白版）

什么是 Claude Code？

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

主要特点：

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

前置准备

1. 安装 Node.js（必需）

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

检查是否已安装 Node.js

打开终端（Terminal），输入：

node--versionnpm--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 生效：
exportNVM_DIR="$HOME/.nvm"[-s"$NVM_DIR/nvm.sh"]&&\."$NVM_DIR/nvm.sh"
  1. 安装最新的 Node.js LTS 版本：
nvminstall--lts nvm use lts
  1. 设置为默认版本：
nvmaliasdefault lts/*

Mac 用户备用方式：使用 Homebrew

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

Windows 用户：

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

同时安装 Git for Windows（Windows 用户必需）：

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

安装 Claude Code

方式一：npm 命令行安装（推荐）

  1. 打开终端（Mac/Linux）或 PowerShell/CMD（Windows）

  2. 执行安装命令：

npminstall-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. 配置环境变量：

exportANTHROPIC_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 安装（不推荐，但最简单）sudonpminstall-g @anthropic-ai/claude-code# 或配置 npm 全局目录（推荐）mkdir~/.npm-globalnpmconfigsetprefix'~/.npm-global'echo'export PATH=~/.npm-global/bin:$PATH'>>~/.bashrcsource~/.bashrcnpminstall-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. 启动项目
cdmy-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即可开始使用！

参考资源

  • Claude Code 官方文档
  • 智谱 AI 开放平台
  • GLM Coding Plan 文档
  • Node.js 官网
  • nvm GitHub

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

http://www.jsqmd.com/news/418678/

相关文章：

  • Bidili SDXL图片生成器保姆教程：参数详解+实操，快速出效果
  • 2026零售企业薪酬服务优化成本推荐榜：薪酬服务外包公司/薪酬服务平台/薪酬服务解决方案/薪酬服务代发/选择指南 - 优质品牌商家
  • JVM--面试题6：如何判断对象可以被垃圾回收？
  • 学长亲荐 8个AI论文网站：研究生毕业论文写作与格式规范全测评
  • 百度网盘资源获取工具：高效检索与权限管理解决方案
  • 初识Markdown
  • UDOP-large优化升级：英文文档摘要生成与版面布局分析实战指南
  • 静态时序分析Static Timing Analysis2——时序路径优化、多周期路径与伪路径约束实战
  • 基于Qwen3-ASR的播客内容分析系统开发
  • 为什么自己写的论文也被检测出AI？揭秘「误检」背后的原因 - 我要发一区
  • 立知多模态重排序模型：解决内容检索排序难题
  • STEP3-VL-10B开箱即用体验：轻量级模型，媲美超大模型的视觉理解力
  • 2026广州农产品商标设计优质机构推荐榜：简约商标设计/餐饮logo设计/餐饮商标设计/高端logo设计/选择指南 - 优质品牌商家
  • Qwen3-0.6B-FP8优化升级：如何提升推理速度与降低资源占用
  • 网络安全渗透测试学习笔记-20260225
  • AI率10%、20%、30%分别是什么水平？一张图看懂AI率等级 - 我要发一区
  • Bidili SDXL Generator 开箱即用：纯本地运行，无需网络依赖的SDXL图片生成方案
  • 困惑度是什么？一文搞懂AIGC检测的核心指标 - 我要发一区
  • GLM-OCR效果深度评测：多场景文档解析准确率对比
  • Quantum Queen MT5 V2.6深度解析：AI驱动的黄金外汇量化交易新标杆
  • CentOS下LibreOffice文档转换PDF卡顿与乱码问题全解析
  • 成都旧房翻新｜8大核心顾虑拆解，实用参考+价值解析 - 推荐官
  • USB-C与Thunderbolt终极指南：如何选择最适合你的接口
  • 成都半包装修避坑指南｜里林设计：破解业主6大核心顾虑，半包也能省心又可控 - 推荐官
  • 快讯｜汽车资本密集入局具身智能：上汽领投自变量、中科第五纪成宇树大脑供应商，产业逻辑正在重构
  • 2026年服务机器人应用技术员报考攻略
  • 基于需求导向的安宁照护服务与管理策略
  • 2026年家政保洁优质服务推荐指南：成都保洁/成都养老服务/成都养老院/成都家政保洁/成都钟点工保洁/成都高端家政/选择指南 - 优质品牌商家
  • 手把手教你看AIGC检测报告：每个指标都代表什么意思 - 我要发一区
  • 彩旗不止是装饰：解锁现代场景中彩旗的功能密码与选择智慧