Claude Code 安装配置与使用指南（Windows/macOS）

Claude Code 安装与使用教程

一、什么是 Claude Code？

Claude Code 是 Anthropic 官方提供的命令行 AI 编程工具，支持在终端直接使用 Claude 写代码、分析项目结构、自动修改文件、生成测试代码及调试程序。

类似工具包括 Cursor、Copilot CLI 等，但 Claude Code 更偏向终端开发流。

二、安装前准备

1. Node.js（必须）
   • 下载地址：https://nodejs.org
   • 推荐版本：Node.js 18+
   • 验证命令：

     node -v
     npm -v
     

2. 拥有 Claude 账号
   • 登录地址：https://console.anthropic.com
3. 获取 API Key
   • 路径：Dashboard → API Keys
   • 创建 Key 后获得格式如：sk-ant-xxxxxxxxxxxxx

三、安装 Claude Code

打开终端（Windows 使用 PowerShell，macOS 使用 Terminal）执行：

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

等待安装完成后验证：

claude --version

若显示版本号则安装成功。

四、配置 API Key

将 API Key 写入环境变量。

Windows（PowerShell）

setx ANTHROPIC_API_KEY "你的APIKEY"

关闭终端重新打开生效。

macOS / Linux

export ANTHROPIC_API_KEY="你的APIKEY"

建议写入 ~/.bashrc 或 ~/.zshrc 实现永久配置。

五、第一次运行 Claude Code

进入项目目录并启动：

cd your-project
claude

看到 Claude Code Assistant > 提示符即表示成功。

六、基本使用方式

1. 让 Claude 分析项目

   claude explain
   # 输入：Explain this project structure
   

2. 修改代码

   claude edit
   # 输入：Add login validation
   

   Claude 会分析代码、修改文件并给出变更说明。
3. 生成测试代码

   claude generate tests
   

   可自动生成单元测试、接口测试及 Mock 数据。
4. 修复 Bug

   claude fix
   # 输入：Fix null pointer exception
   

七、推荐开发工作流

高效流程示例：

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

建议搭配 VS Code、Git 及 Terminal 使用。