Claude Code 安装教程小白版什么是 Claude CodeClaude 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.jsMac 用户推荐方式使用 nvm版本管理器nvm 可以让你在同一台电脑上安装和管理多个 Node.js 版本。安装 nvmcurl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh|bash重新打开终端或执行以下命令使 nvm 生效exportNVM_DIR$HOME/.nvm[-s$NVM_DIR/nvm.sh]\.$NVM_DIR/nvm.sh安装最新的 Node.js LTS 版本nvminstall--lts nvm use lts设置为默认版本nvmaliasdefault lts/*Mac 用户备用方式使用 Homebrew# 如果没有安装 Homebrew先安装它/bin/bash -c$(curl-fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)# 安装 Node.jsbrewinstallnodeWindows 用户访问 Node.js 官网下载 LTS 版本长期支持版运行安装程序一路下一步即可同时安装 Git for WindowsWindows 用户必需访问 Git 官网下载并安装使用默认设置即可安装 Claude Code方式一npm 命令行安装推荐打开终端Mac/Linux或 PowerShell/CMDWindows执行安装命令npminstall-g anthropic-ai/claude-code验证安装是否成功claude --version如果显示版本号如2.0.14说明安装成功方式二使用 Cursor 编辑器引导安装如果你有 Cursor 编辑器但不熟悉命令行打开 Cursor按Cmd LMac或Ctrl LWindows打开聊天面板输入Help me install Claude CodeCursor 会引导你完成安装过程配置国内模型Claude Code需要接入大模型才能发挥作用对于国内环境各个模型大厂都推出了Coding Plan套餐以下以智谱AI的为例安装完成后需要配置智谱 AI 的 API Key 才能使用GLM-5模型。获取 API Key访问 智谱 AI 开放平台注册/登录账号进入API Key管理页面创建新的 API Key 并复制保存配置方式启动 Claude Codeclaude首次启动会提示配置 API选择Manual setup或手动配置配置环境变量exportANTHROPIC_API_KEY你的API_KeyWindows PowerShell 用户$env:ANTHROPIC_API_KEY你的API_Key永久保存配置推荐创建或编辑配置文件~/.claude/settings.jsonMac/Linux或%USERPROFILE%\.claude\settings.jsonWindows{env:{ANTHROPIC_API_KEY:你的API_Key,ANTHROPIC_BASE_URL:https://open.bigmodel.cn/api/paas/v4/}}开始使用1. 启动 Claude Code进入你的项目目录然后运行cd/path/to/your/project claude2. 首次启动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-globalechoexport PATH~/.npm-global/bin:$PATH~/.bashrcsource~/.bashrcnpminstall-g anthropic-ai/claude-codeQ2: 配置文件修改后不生效解决步骤关闭所有 Claude Code 窗口重新打开终端再次运行claude启动如果问题仍存在删除~/.claude/settings.json重新配置Q3: 如何升级到最新版本# 检查当前版本claude --version# 升级到最新版本claude update推荐使用最新版本以获得最佳体验。Q4: Windows 下提示找不到 claude 命令解决方案确保 npm 全局安装路径在系统 PATH 中查找 npm 全局路径npm config get prefix将该路径下的bin目录添加到系统环境变量 PATH 中或使用 PowerShell 重新安装npm install -g anthropic-ai/claude-codeQ5: 如何在项目中使用进入任何项目目录后启动cd/path/to/your/project claudeClaude Code 会自动扫描并理解项目结构可以帮你完成代码生成和补全Bug 修复和调试代码重构和优化添加注释和文档推荐工作流日常开发流程启动项目cdmy-project claude描述需求 帮我创建一个用户登录页面使用 HTML CSS JavaScript迭代优化 给登录按钮添加 hover 效果 添加表单验证功能调试问题 为什么点击登录后没有反应帮我检查代码团队协作Claude Code 可以读取整个项目代码库可以帮你理解别人的代码可以协助 Code Review可以生成文档和注释进阶配置配置视觉 MCP 服务器图片识别如果你需要让 Claude Code 识别和分析图片可以配置视觉 MCP 服务器。参考文档视觉MCP服务器配置搜索 MCP 服务器联网搜索如果你需要让 Claude Code 搜索最新信息可以配置搜索 MCP 服务器。参考文档搜索MCP服务器配置网页读取 MCP 服务器如果你需要让 Claude Code 读取网页内容可以配置网页读取 MCP 服务器。参考文档网页读取MCP服务器总结安装 Claude Code 只需要三步✅ 安装 Node.js 18✅ 运行npm install -g anthropic-ai/claude-code✅ 配置智谱 AI API Key安装后在任何项目目录运行claude即可开始使用参考资源Claude Code 官方文档智谱 AI 开放平台GLM Coding Plan 文档Node.js 官网nvm GitHub作者博客http://xiejava.ishareread.com/