适用系统：Windows / macOS / Linux
预计耗时：10 分钟

---

目录

• Claude Code 是什么？
• 第一步：安装 Node.js（已有可跳过）
  • Windows
  • macOS
  • Linux（Ubuntu/Debian）
• 第二步：安装 Claude Code
• 第三步：配置 API Key（二选一）
  • 方案 A：官方 Anthropic API（需要付费订阅）
  • 方案 B：第三方兼容 API（推荐国内用户）
    • 1. 创建配置文件
    • 2. 验证配置
• 第四步：基本功——三条必学命令
  • 1. 一问一答模式（最常用）
  • 2. 进入项目干活
  • 3. 代码审查
  • 4. 交互模式（多轮对话）
• 第五步：常用参数速查
• 常见问题排查
  • claude 命令找不到
  • 安装报 EACCES 权限错误
  • 运行时提示未设置 ANTHROPIC_API_KEY
  • npm 安装太慢 / 卡住
  • 用 DeepSeek 等第三方 API 时提示权限错误
  • Windows 终端乱码
• 进阶：CLAUDE.md 项目记忆文件
• 总结

---

---

Claude Code 是什么？

Claude Code 是 Anthropic 推出的命令行 AI 编程助手。你只需要在终端里用自然语言描述你要做什么，它就会自动读文件、写代码、跑命令、修 bug——像一个不知疲倦的程序员副手。

---

第一步：安装 Node.js（已有可跳过）

Claude Code 通过 npm 分发，npm 随 Node.js 一起安装。打开终端，先检查你装过没有：

node --version
npm --version

看到类似 v20.x.x 就说明已经有了，直接跳到第二步。

Windows

1. 浏览器打开 nodejs.org
2. 点击左边绿色的 LTS 按钮下载
3. 双击 .msi 安装包，一路 Next → Install → Finish
4. 按 Win + R，输入 cmd 回车，输入上面两条验证命令

macOS

官网安装：同 Windows，去 nodejs.org 下 LTS 版 .pkg。

Homebrew 安装（推荐）：

# 没装过 Homebrew 的话先装
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 装 Node.js
brew install node

Linux（Ubuntu/Debian）

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

---

第二步：安装 Claude Code

打开终端，一行命令搞定：

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

验证安装：

claude --version

看到版本号（如 v2.x.x）说明装好了 ✅

---

第三步：配置 API Key（二选一）

方案 A：官方 Anthropic API（需要付费订阅）

如果你有 Anthropic 的 Pro / Max / Enterprise 订阅，直接运行：

claude

第一次会弹浏览器让你登录 Anthropic 账号，登录完终端就进交互界面了。

方案 B：第三方兼容 API（推荐国内用户）

如果你用的是 DeepSeek、OpenRouter 等兼容 Anthropic API 的服务，需要创建配置文件。

api-key获取方式：
deepseek api-key: 点击进入deepseek平台，注册账号，进入到看到左边导航栏有api-key，点击创建即可。

1. 创建配置文件

Mac / Linux：

mkdir -p ~/.claude

创建文件 ~/.claude/settings.json，写入：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API密钥",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "DeepSeek-V4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "DeepSeek-V4-pro"
  }
}

Windows：

在文件资源管理器地址栏输入 %USERPROFILE%，进入用户目录，新建文件夹 .claude，在里面新建文件 settings.json，内容同上。

2. 验证配置

claude -p "hello"

如果能正常返回一段问候语，配置成功了。

---

第四步：基本功——三条必学命令

1. 一问一答模式（最常用）

claude -p "你的问题"

-p 是 print 模式：问一个问题，Claude 回答完就退出，干净利落。

试试看：

claude -p "用 Python 写一个计算斐波那契数列的函数"

2. 进入项目干活

cd /你的项目路径
claude -p "帮我看看这个项目在做什么" --max-turns 5

• --max-turns 5 限制最多执行 5 轮操作，防止跑飞烧钱。

3. 代码审查

cd /你的项目路径
git diff | claude -p "帮我审查这些改动，重点看有没有 bug 和安全问题" --max-turns 1

把 git diff 的输出直接通过管道传给 Claude，它就帮你审查。

4. 交互模式（多轮对话）

claude

直接输入 claude 回车，进入一个完整的聊天界面。在里面你可以：

• 连续多轮对话改代码
• 用 /model opus 切换模型
• 用 /compact 压缩上下文省 token
• 用 /review 审查当前改动
• 用 /help 查看所有命令

📺 交互模式是一个 TUI（终端用户界面），有完整的按键操作。按 Ctrl+D 退出。

---

第五步：常用参数速查

参数	作用	示例
-p "内容"	一问一答模式	claude -p "修 bug"
--max-turns N	限制最多 N 轮操作	--max-turns 5
--allowedTools	限制可用工具	--allowedTools "Read,Edit"
--model	指定模型	--model haiku
--output-format json	输出 JSON 格式	自动化脚本用
-c	继续上次对话	claude -c
--dangerously-skip-permissions	跳过所有确认弹窗	CI/自动化用
--bare	极速启动（跳过插件等）	CI 环境用

---

常见问题排查

claude 命令找不到

关掉终端重新打开。如果还不行，检查 npm 全局安装路径是否在 PATH 里：

npm config get prefix

确保输出路径在系统环境变量中。

安装报 EACCES 权限错误

Mac / Linux：

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

或者改 npm 全局目录（一劳永逸）：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

运行时提示未设置 ANTHROPIC_API_KEY

你还没配 API Key，回第三步方案 B 创建 ~/.claude/settings.json。

npm 安装太慢 / 卡住

用国内镜像加速：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

用 DeepSeek 等第三方 API 时提示权限错误

如果以 root 用户运行，权限跳过参数写法不同：

claude -p "hello" --dangerously-skip-permissions=true

（注意是 =true，不是只写 --dangerously-skip-permissions）

Windows 终端乱码

推荐使用 Windows Terminal（Microsoft Store 免费下载），替代系统自带的命令提示符。

---

进阶：CLAUDE.md 项目记忆文件

在项目根目录新建 CLAUDE.md，Claude Code 每次进入这个项目都会自动读取。你可以提前告诉它项目规范：

# 我的项目

## 技术栈
- Python 3.12 + FastAPI + SQLAlchemy
- PostgreSQL 数据库

## 常用命令
- pytest 跑测试
- ruff check . 做代码检查

## 代码规范
- Python 用 4 空格缩进
- 所有公开函数必须有类型标注
- 测试文件命名 test_*.py

以后 Claude 写代码会自动遵守这些规则，不用每次都重复说明。

---

总结

装 Node.js → npm install -g → 配 API Key → claude -p "hello" ✅

整个流程不超过 10 分钟。装好之后多用 claude -p 模式熟悉基本用法，慢慢进阶到交互模式、项目级开发。

---

更多用法：官方 CLI 文档
遇到问题？把报错信息丢给 Claude 自己，它也能帮你排查