【AI开发工具】Claude Code：安装配置与使用指南（Windows/macOS）

文章目录

[🚀 Claude Code 安装与使用完整教程（Windows / macOS 新手指南）](#🚀 Claude Code 安装与使用完整教程（Windows / macOS 新手指南）)
- [📖 一、什么是 Claude Code？](#📖 一、什么是 Claude Code？)
- [🧰 二、安装前准备](#🧰 二、安装前准备)
- - [1️⃣ Node.js（必须）](#1️⃣ Node.js（必须）)
  - [2️⃣ 拥有 Claude 账号](#2️⃣ 拥有 Claude 账号)
  - [3️⃣ 获取 API Key](#3️⃣ 获取 API Key)
- [⚙️ 三、安装 Claude Code](#⚙️ 三、安装 Claude Code)
- [🔑 四、配置 API Key](#🔑 四、配置 API Key)
- - Windows（PowerShell）
  - [macOS / Linux](#macOS / Linux)
- [🚀 五、第一次运行 Claude Code](#🚀 五、第一次运行 Claude Code)
- [💻 六、基本使用方式](#💻 六、基本使用方式)
- - [1️⃣ 让 Claude 分析项目](#1️⃣ 让 Claude 分析项目)
  - [2️⃣ 修改代码](#2️⃣ 修改代码)
  - [3️⃣ 生成测试代码](#3️⃣ 生成测试代码)
  - [4️⃣ 修复 Bug](#4️⃣ 修复 Bug)
- [🧠 七、推荐开发工作流（强烈建议）](#🧠 七、推荐开发工作流（强烈建议）)

🚀 Claude Code 安装与使用完整教程（Windows / macOS 新手指南）

本文将从 零开始，一步步教你安装 Claude Code。

📖 一、什么是 Claude Code？

Claude Code 是 Anthropic 官方提供的命令行 AI 编程工具，可以让你：

在终端直接使用 Claude 写代码
分析项目结构
自动修改文件
生成测试代码
调试程序

简单理解：

Claude Code = Claude + 本地项目 + AI 编程助手

类似：

Cursor（AI IDE）
Copilot CLI
ChatGPT CLI

但它更偏 终端开发流。

🧰 二、安装前准备

安装前需要准备以下环境：

1️⃣ Node.js（必须）

Claude Code 通过 npm 安装。

下载地址

👉 https://nodejs.org

推荐版本：

复制代码

Node.js 18+

安装完成后验证：

bash 复制代码

node -v
npm -v

如果显示版本号说明成功。

2️⃣ 拥有 Claude 账号

需要先注册 Claude 账号。

复制代码

https://console.anthropic.com

3️⃣ 获取 API Key

进入：

复制代码

Dashboard → API Keys

创建 Key：

复制代码

Create Key

你会得到：

复制代码

sk-ant-xxxxxxxxxxxxx

⚙️ 三、安装 Claude Code

打开：

Windows → PowerShell
macOS → Terminal

执行：

bash 复制代码

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

等待安装完成。

验证安装

bash 复制代码

claude --version

如果显示版本号：

复制代码

claude x.x.x

说明安装成功 ✅

🔑 四、配置 API Key

需要把 API Key 写入环境变量。

Windows（PowerShell）

powershell 复制代码

setx ANTHROPIC_API_KEY "你的APIKEY"

关闭终端重新打开。

macOS / Linux

bash 复制代码

export ANTHROPIC_API_KEY="你的APIKEY"

建议写入：

bash 复制代码

~/.bashrc

或

bash 复制代码

~/.zshrc

🚀 五、第一次运行 Claude Code

进入你的项目目录：

bash 复制代码

cd your-project

启动：

bash 复制代码

claude

你会看到类似界面：

复制代码

Claude Code Assistant
>

说明成功 🎉

💻 六、基本使用方式

1️⃣ 让 Claude 分析项目

bash 复制代码

claude explain

示例：

复制代码

Explain this project structure

2️⃣ 修改代码

bash 复制代码

claude edit

例如：

复制代码

Add login validation

Claude 会：

分析代码
修改文件
给出变更说明

3️⃣ 生成测试代码

bash 复制代码

claude generate tests

可以自动生成：

单元测试
接口测试
Mock 数据

4️⃣ 修复 Bug

bash 复制代码

claude fix

例如：

复制代码

Fix null pointer exception

🧠 七、推荐开发工作流（强烈建议）

一个高效流程：

复制代码

IDE 写代码
        ↓
Claude 分析
        ↓
Claude 修改
        ↓
Claude 生成测试
        ↓
提交 Git

建议搭配：

VS Code
Git
Terminal