Claude Code 零基础入门：安装配置与第一个项目

# 检查 Node.js 版本（需要 >= 18）
node -v
# 预期输出类似：v22.22.0

# 检查 npm 版本
npm -v
# 预期输出类似：10.9.4

# 检查 git 是否安装
git --version
# 预期输出类似：git version 2.43.0

# macOS（使用 Homebrew）
brew install node

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Windows（使用 winget）
winget install OpenJS.NodeJS.LTS

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

claude --version
# 预期输出类似：2.1.56 (Claude Code)

mkdir -p ~/my-first-claude-project
cd ~/my-first-claude-project
claude

# 设置 API Key
export ANTHROPIC_API_KEY="sk-ant-xxxxx"

# 或者使用 claude auth 命令
claude auth

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://your-api-endpoint.com/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your-token-here"
  }
}

╭──────────────────────────────────────────────╮
│                                              │
│   Welcome to Claude Code!                    │
│                                              │
╰──────────────────────────────────────────────╯

> 

# 默认模式：关键操作需要确认
claude --permission-mode default

# 仅编辑需确认
claude --permission-mode acceptEdits

# 计划模式：只做规划不执行
claude --permission-mode plan

# 跳过所有确认（仅在可信沙箱环境中使用！）
claude --dangerously-skip-permissions

# 创建项目目录
mkdir -p ~/todo-app
cd ~/todo-app

# 初始化 git 仓库
git init

# 启动 Claude Code
claude

请帮我创建一个 CLAUDE.md 文件，内容如下：
- 这是一个 Node.js 命令行 Todo 应用
- 使用纯 JavaScript，不用框架
- 数据存储在 JSON 文件中
- 代码风格简洁，函数有清晰的注释

帮我创建一个命令行 Todo 应用，需要以下功能：
1. 添加任务：todo add "买菜"
2. 列出所有任务：todo list
3. 完成任务：todo done 1
4. 删除任务：todo delete 1

todo-app/
├── CLAUDE.md          # 项目指令
├── package.json       # 项目配置
├── index.js           # 主程序入口
├── todos.json         # 数据存储（运行后生成）
└── README.md          # 项目说明（可选）

Claude wants to create todo-app/index.js:
────────────────────────────────────────
+ const fs = require('fs');
+ const path = require('path');
+ 
+ const DATA_FILE = path.join(__dirname, 'todos.json');
+ 
+ function loadTodos() {
+   ...
+ }
────────────────────────────────────────
Accept? (y/n)

请运行这个应用，测试所有功能是否正常

# 添加几个任务
node index.js add "学习 Claude Code"
node index.js add "写一篇博客"
node index.js add "部署到生产环境"

# 列出所有任务
node index.js list

# 完成第一个任务
node index.js done 1

# 再次列出
node index.js list

✓ 任务已添加：学习 Claude Code
✓ 任务已添加：写一篇博客
✓ 任务已添加：部署到生产环境

📋 待办事项：
  1. [ ] 学习 Claude Code
  2. [ ] 写一篇博客
  3. [ ] 部署到生产环境

✓ 任务 1 已完成

📋 待办事项：
  1. [x] 学习 Claude Code
  2. [ ] 写一篇博客
  3. [ ] 部署到生产环境

删除任务后再列出，发现序号没有重新排列，请修复这个问题

CLAUDE.md              → 全局指令（用户主目录）
项目根/CLAUDE.md        → 项目级指令（最高优先级）
项目根/.claude/CLAUDE.md → 项目级指令（等同上面）

# 项目规范

## 技术栈
- 前端：React 19 + TypeScript + Tailwind CSS
- 后端：Node.js + Express + PostgreSQL
- 测试：Vitest + Playwright

## 编码规范
- 使用 TypeScript strict 模式
- 函数必须有类型注解
- 变量使用 camelCase，类型使用 PascalCase
- 组件文件使用 PascalCase 命名

## 项目结构
- src/components/ - React 组件
- src/services/ - API 服务层
- src/utils/ - 工具函数
- tests/ - 测试文件

## Git 规范
- commit message 使用中文
- 不要自动 commit，等用户确认
- 分支名格式：feature/xxx, fix/xxx

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-xxxxx",
    "API_TIMEOUT_MS": "300000"
  },
  "theme": "dark",
  "verbose": false,
  "enabledPlugins": {
    "superpowers@claude-plugins-official": true
  }
}

{
  "permissions": {
    "allow": [
      "Bash(node:*)",
      "Bash(npm:*)",
      "Bash(git status:*)",
      "Bash(git diff:*)",
      "Bash(git log:*)",
      "Read",
      "Glob",
      "Grep"
    ],
    "deny": [
      "Bash(rm -rf:*)",
      "Bash(git push --force:*)"
    ]
  }
}

cd ~/my-project
claude

我需要添加一个用户注册功能：
- 邮箱和密码注册
- 密码使用 bcrypt 加密
- 注册成功后发送欢迎邮件
- 包含输入验证

请为新注册功能编写单元测试，并运行所有测试确保没有回归

/commit

# 方案 1：使用 sudo（不推荐）
sudo npm install -g @anthropic-ai/claude-code

# 方案 2：修改 npm 全局路径（推荐）
mkdir ~/.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

# 使用 nvm 管理 Node.js 版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

# 检查 Key 是否正确设置
claude auth status

# 重新设置
claude auth login

# 使用 API Key
export ANTHROPIC_API_KEY="sk-ant-xxxxx"

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://your-proxy-endpoint.com/api/anthropic"
  }
}

## 禁止修改
- 不要修改 config/production.env
- 不要修改 database/migrations/ 下的文件
- 不要修改 CI/CD 配置文件

{
  "permissions": {
    "deny": [
      "Bash(rm -rf:*)",
      "Bash(dropbox:*)",
      "Bash(git push --force:*)",
      "Bash(git reset --hard:*)"
    ]
  }
}

claude --model opus    # 最强模型，复杂任务
claude --model sonnet  # 默认模型，日常开发
claude --model haiku   # 快速模型，简单任务

# 代码审查
git diff main | claude -p "Review this diff for potential bugs"

# 自动生成 commit message
git diff --staged | claude -p "Generate a concise commit message"

# 分析日志
cat error.log | claude -p "分析这些错误日志，找出根本原因"

# 批量重构
find src -name "*.js" | claude -p "列出这些文件中使用了旧API的地方"