【有啥问啥】Claude Code 安装与使用教程

Claude Code 安装与使用教程

什么是 Claude Code？

Claude Code 是 Anthropic 官方推出的 AI 编程助手，运行在你的终端（命令行）里。它可以：

读取和修改你的代码文件
执行终端命令
帮你调试、重构、编写代码
理解整个项目结构，给出上下文相关的建议

简单说：它是一个住在终端里的 AI 程序员，可以直接动手帮你写代码。

前置要求

在安装 Claude Code 之前，你需要准备：

Node.js（版本 18 或以上）
Anthropic API Key （从 https://console.anthropic.com 获取）
一个终端（Windows 用 PowerShell 或 CMD，macOS/Linux 用 Terminal）

检查 Node.js 是否已安装

打开终端，输入：

bash 复制代码

node --version

如果显示 v18.x.x 或更高版本，说明已安装。

如果没有安装，前往 https://nodejs.org 下载 LTS 版本安装。

第一步：安装 Claude Code

打开终端，运行以下命令：

bash 复制代码

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

安装完成后，验证是否成功：

bash 复制代码

claude --version

看到版本号说明安装成功。

第二步：配置 API Key

方式一：交互式配置（推荐新手）

直接运行：

bash 复制代码

claude

首次运行会提示你输入 API Key，按提示粘贴即可。

方式二：环境变量配置

macOS / Linux：

bash 复制代码

export ANTHROPIC_API_KEY="你的API Key"

永久生效，添加到 ~/.bashrc 或 ~/.zshrc：

bash 复制代码

echo 'export ANTHROPIC_API_KEY="你的API Key"' >> ~/.zshrc
source ~/.zshrc

Windows（PowerShell）：

powershell 复制代码

$env:ANTHROPIC_API_KEY = "你的API Key"

永久生效：

powershell 复制代码

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的API Key", "User")

第三步：基本使用

启动 Claude Code

进入你的项目目录，然后启动：

bash 复制代码

cd /path/to/your/project
claude

你会看到一个交互式对话界面，可以直接用自然语言描述你想做的事。

常用操作示例

让 Claude 解释代码：

复制代码

解释一下 src/main.py 这个文件是做什么的

让 Claude 修复 Bug：

复制代码

运行 npm test，帮我修复所有报错

让 Claude 新增功能：

复制代码

在 utils.js 里添加一个格式化日期的函数

让 Claude 重构代码：

复制代码

把 index.js 里的回调函数改成 async/await 写法

第四步：常用命令

除了对话模式，Claude Code 也支持命令行参数：

单次执行（不进入交互模式）

bash 复制代码

claude -p "帮我写一个 Hello World 的 Python 脚本"

指定工作目录

bash 复制代码

claude --cwd /path/to/project

查看帮助

bash 复制代码

claude --help

权限说明

Claude Code 在执行操作前会告诉你它要做什么，并询问是否允许：

读取文件：通常自动允许
修改文件：会提示确认
执行命令 ：会提示确认，你可以选择：
- Yes：允许一次
- Yes, always：本次会话始终允许
- No：拒绝

⚠️ 建议新手在熟悉之前，每次都手动确认，避免意外修改重要文件。

实战示例：从零创建一个小项目

bash 复制代码

# 1. 创建新目录
mkdir my-app && cd my-app

# 2. 启动 Claude Code
claude

# 3. 在对话中输入：
# "帮我创建一个简单的 Node.js Express 服务器，
#  有一个 /hello 接口，返回 Hello World"

Claude 会自动创建文件、安装依赖、写好代码，你只需要确认每一步操作。

常见问题

Q：提示 command not found: claude？

A：确认 npm 全局安装路径在 PATH 里。运行 npm bin -g 查看路径，添加到环境变量。

Q：API Key 报错 401？

A：Key 填写有误或已过期，重新从 Anthropic 控制台生成。

Q：操作被拒绝，提示权限不足？

A：macOS/Linux 可能需要 sudo npm install -g，或使用 nvm 管理 Node 版本避免权限问题。

Q：Claude Code 会不会乱改我的代码？

A：每次修改前都会提示确认，你有完全控制权。建议在有 Git 的项目里使用，方便回滚。

进阶技巧

配合 Git 使用

在有版本控制的项目里使用 Claude Code 更安全：

bash 复制代码

git init
git add .
git commit -m "初始提交"
# 然后再让 Claude 修改代码，出问题可以 git checkout 回滚

使用 CLAUDE.md 定制行为

在项目根目录创建 CLAUDE.md 文件，写入项目说明和规范，Claude Code 每次启动都会读取：

markdown 复制代码

# 项目说明
这是一个 React + TypeScript 项目。

## 代码规范
- 使用 ESLint + Prettier
- 组件用函数式写法
- 变量命名用驼峰

小结

步骤	内容
1	安装 Node.js
2	`npm install -g @anthropic-ai/claude-code`
3	配置 API Key
4	进入项目目录，运行 `claude`
5	用自然语言描述你想做的事

官方文档：https://docs.anthropic.com/claude-code