安装配置

前提条件

• Node.js 18+（推荐用 nvm 管理版本）
• 一个 Anthropic API Key 或 Claude Pro/Max 订阅
• macOS、Linux 或 Windows（WSL）

安装

通过 npm 全局安装：

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

安装完成后，直接在终端运行：

claude

首次启动会引导你登录 Anthropic 账号或输入 API Key。

登录方式

方式一：Claude 订阅（推荐）

如果你有 Claude Pro 或 Max 订阅，直接浏览器登录即可，无需 API Key。

claude
# 首次运行会弹出浏览器让你授权

方式二：API Key

export ANTHROPIC_API_KEY="sk-ant-xxxxx"
claude

你也可以把它写进 ~/.zshrc 或 ~/.bashrc 里。

验证安装

claude --version

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

更新

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

CLAUDE.md 配置文件

在项目根目录创建 CLAUDE.md 文件，可以告诉 Claude 关于你项目的重要信息：

# 项目说明
- 这是一个 Next.js 项目
- 使用 pnpm 作为包管理器
- 测试用 vitest 运行

# 规范
- 使用中文注释
- 组件放在 src/components/ 目录下

Claude 每次启动时都会自动读取这个文件。