🔧 Claude Code 安装入门

第 1 篇 — 从零到能用，一步步实操教程

---

📋 前置检查

在装之前，先看看你电脑上有没有这些东西：

# 1. 检查 Node.js（版本 ≥ 18）
node --version
# 期望输出：v18.x.x 或 v20.x.x 或更高

# 2. 检查 npm
npm --version
# 期望输出：9.x.x 或 10.x.x

# 3. 检查 Git
git --version
# 期望输出：git version 2.x.x

如果没有 Node.js？

macOS:

# 方法一：官网下载安装包
# https://nodejs.org → 下载 LTS 版本 → 双击安装

# 方法二：用 Homebrew（推荐）
brew install node

Ubuntu/Debian Linux:

# 用 NodeSource 官方源（推荐 LTS 版本）
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证
node --version

Windows (WSL2):

# 在 WSL2 Ubuntu 中同上操作

---

🚀 安装 Claude Code

一条命令搞定：

# 全局安装（推荐）
npm install -g @anthropic-ai/claude-code

⚠️ 如果报权限错误（EACCES）

Linux 服务器常见问题：

# 用 sudo 安装
sudo npm install -g @anthropic-ai/claude-code

或者改用用户级安装：

# 配置 npm 全局路径到用户目录
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 再装一次
npm install -g @anthropic-ai/claude-code

验证安装：

claude --version
# 期望：2.x.x 版本号

claude doctor
# 检查安装健康状态

---

🔐 认证：让 Claude Code 能调用 AI

Claude Code 本质上是个「壳」，它需要连接到 AI 模型才能工作。有三种方式：

方式一：Anthropic 官方 API（推荐，但需要境外支付）

# 1. 去 https://console.anthropic.com 注册
# 2. 获取 API Key
# 3. 设置环境变量
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxx"

方式二：DeepSeek API（国内用户首选 ✨）

DeepSeek 提供了兼容 Anthropic 的接口，国内可直接注册，价格极低：

# 1. 去 https://platform.deepseek.com 注册
# 2. 获取 API Key（sk- 开头）
# 3. 设置两个环境变量
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_API_KEY="sk-你的DeepSeek密钥"

方式三：OAuth 登录（如果你有 Claude 订阅）

claude auth login
# 会弹出浏览器，登录你的 Anthropic 账号

---

🔧 推荐：把配置写入文件，永久生效

⚠️ 如果之前已经配过，不要直接覆盖，手动把新内容合并进去。

# 创建配置目录（如果还没有）
mkdir -p ~/.claude

# 写入配置文件
cat > ~/.claude/settings.json << 'EOF'
{
  "model": "deepseek-v4-pro[1m]",
  "effort": "max"
}
EOF

# 环境变量写入 shell 配置（选择你的 shell，只执行一次）
# 如果不确定用的是哪个：echo $SHELL
#
# Bash 用户：
echo 'export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-你的密钥"' >> ~/.bashrc
source ~/.bashrc

# Zsh 用户:
echo 'export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-你的密钥"' >> ~/.zshrc
source ~/.zshrc

---

✅ 验证一切正常

# 检查认证状态
claude auth status --text
# 应显示：Anthropic base URL: https://api.deepseek.com/anthropic

# 试一次简单对话
claude -p "你好，请用中文告诉我你是什么模型" --max-turns 1
# 应回复类似 "我是 DeepSeek V4 Pro..."

---

🎮 两种使用模式

模式 1：一句话命令（Print Mode）— 新手友好 ✨

# 格式：claude -p "你的问题"
claude -p "解释一下这段代码" --max-turns 5

# 加文件：用管道输入
cat src/app.py | claude -p "审查这个文件的代码质量"

模式 2：交互对话（REPL Mode）

# 直接输入 claude 回车，进入对话模式
claude

# 常用快捷键：
# Ctrl+D 退出
# Shift+Tab 切换权限模式
# ! 前缀直接执行 bash 命令

---

📁 Claude Code 的文件都放哪了？

~/.claude/                  # 全局配置
├── settings.json           # 你的设置
├── CLAUDE.md               # 全局记忆（告诉 Claude 你的偏好）
├── agents/                 # 自定义子代理
├── commands/               # 自定义斜杠命令
└── projects/               # 各项目的自动记忆

.claude/                    # 项目级配置（在你的代码项目里）
├── settings.json           # 项目专属设置
├── CLAUDE.md               # 项目说明
└── settings.local.json     # 个人设置（不提交 git）

---

🚦 下一步

👉 配置详细说明 → 2026-05-08 Claude Code 配置与认证

👉 遇到问题 → 2026-05-08 常见问题与故障排除

👉 对比 Hermes Agent → 2026-05-08 Claude Code vs Hermes Agent 对比选型

---

💡 小白提示

---

❓ 常见问题 (FAQ)

Q1: npm install -g 报 EACCES 权限错误怎么解决？

两种方法：① sudo npm install -g @anthropic-ai/claude-code（最快）；② 配置用户级 npm 路径（参考正文「权限错误」小节）。

Q2: Node.js 版本太低怎么办？

macOS：brew upgrade node。Linux：重新跑一遍 NodeSource 安装脚本。Windows：去 nodejs.org 下载新版本覆盖安装。

Q3: 装完后 claude 命令提示 command not found？

可能是 npm 全局路径没在 PATH 里。检查：npm list -g --depth=0 | grep claude，找到了就加 PATH：echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc。

Q4: 需要科学上网吗？

用 DeepSeek API 不需要，国内直连。用 Anthropic 官方 API 需要境外网络。

Q5: Windows 原生能用吗？

官方主要支持 macOS 和 Linux。Windows 用户推荐装 WSL2（Ubuntu 子系统），在里面按 Linux 流程操作。

Q6: 能不能装在云服务器上？

✅ 能，而且很适合。服务器 24 小时在线，配合 Hermes 网关可以随时随地通过微信/TG 调用。

Q7: 装完第一步做什么？

跑 claude -p "你好" --max-turns 1 确认能正常对话，然后看 2026-05-08 Claude Code 配置与认证 完成配置。

Q8: 为什么推荐 DeepSeek 而不是直接用 Claude？

便宜 + 国内直连。 DeepSeek V4 Pro 一天正常使用 ¥0.5-2，Claude Sonnet 同样用法得 ¥5-20。对于新手入门和日常编程，DeepSeek 完全够用。

---

⚠️ 安装过程中容易踩的坑

---

标签：#AI #教程 #ClaudeCode #安装