Claude Code从零开始：安装、配置与第一个项目

brew install claude-code

curl -fsSL https://claude.ai/install.sh | sh

winget install Anthropic.ClaudeCode

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

claude --version

Claude Code v1.0.x

claude

# 方式 A：通过环境变量（推荐，适合 CI/CD）
export ANTHROPIC_API_KEY="sk-ant-xxxxx"
claude

# 方式 B：通过交互式登录
claude
# 按提示选择 "API Key" 并粘贴密钥

claude
# 选择 "Claude Max / Claude Team" 登录
# 浏览器自动弹出 OAuth 页面
# 授权后终端自动完成认证

claude auth status

claude

claude -p "解释 src/utils.ts 中 formatDate 函数的逻辑"

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

mkdir my-first-claude-project
cd my-first-claude-project
git init

claude
# 在交互模式中输入：
> /init

# 项目：个人任务管理器

## 技术栈
- Node.js + Express 后端
- SQLite 数据库
- 原生 HTML/CSS/JS 前端

## 编码规范
- 使用中文注释
- 函数名使用 camelCase
- 文件名使用 kebab-case
- 错误处理使用 try-catch

## 项目结构
- server.js：入口文件
- routes/：API 路由
- public/：静态前端文件
- db/：数据库相关

## 注意事项
- 不要删除现有数据库文件
- 新增 API 需要写对应的测试
- 提交前确保 npm test 通过

{
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(npm run *)",
      "Read",
      "Glob",
      "Grep"
    ],
    "deny": [
      "Bash(rm -rf *)"
    ]
  }
}

{
  "permissions": {
    "allow": [
      "Bash(python manage.py test)",
      "Bash(python manage.py runserver)"
    ]
  },
  "hooks": {
    "PostToolUse": [
      {
        "command": "echo '工具调用完成'"
      }
    ]
  }
}

cd my-first-claude-project
claude

请用 Node.js 创建一个命令行任务管理器。要求：
1. 支持 add/list/complete/delete 四个命令
2. 任务有标题、优先级（高/中/低）、创建时间、完成状态
3. 数据保存到 tasks.json 文件
4. 使用中文界面
5. 包含完整的错误处理

🤖 Claude Code 规划：
1. 创建 package.json 和项目结构
2. 编写核心 task-manager.js 模块
3. 编写 CLI 入口 index.js
4. 添加错误处理和数据持久化
5. 测试所有命令

Claude Code 正在执行：
📄 创建 package.json
📄 创建 src/task-manager.js
📄 创建 src/cli.js
📄 创建 index.js
🔧 运行 npm init -y
✅ 项目初始化完成

const fs = require('fs');
const path = require('path');

const DATA_FILE = path.join(__dirname, '..', 'tasks.json');

function loadTasks() {
  try {
    if (fs.existsSync(DATA_FILE)) {
      const data = fs.readFileSync(DATA_FILE, 'utf-8');
      return JSON.parse(data);
    }
  } catch (err) {
    console.error('读取任务数据失败:', err.message);
  }
  return [];
}

function saveTasks(tasks) {
  try {
    fs.writeFileSync(DATA_FILE, JSON.stringify(tasks, null, 2), 'utf-8');
  } catch (err) {
    console.error('保存任务数据失败:', err.message);
  }
}

function addTask(title, priority = '中') {
  const tasks = loadTasks();
  const task = {
    id: Date.now(),
    title,
    priority,
    completed: false,
    createdAt: new Date().toLocaleString('zh-CN')
  };
  tasks.push(task);
  saveTasks(tasks);
  console.log(`✅ 任务已添加: ${title} [${priority}]`);
}

function listTasks() {
  const tasks = loadTasks();
  if (tasks.length === 0) {
    console.log('📋 暂无任务');
    return;
  }
  console.log('📋 任务列表:');
  tasks.forEach(t => {
    const status = t.completed ? '✅' : '⬜';
    console.log(`  ${status} [${t.id}] ${t.title} (${t.priority}) - ${t.createdAt}`);
  });
}

function completeTask(id) {
  const tasks = loadTasks();
  const task = tasks.find(t => t.id === Number(id));
  if (!task) {
    console.log('❌ 未找到该任务');
    return;
  }
  task.completed = true;
  saveTasks(tasks);
  console.log(`✅ 任务已完成: ${task.title}`);
}

function deleteTask(id) {
  let tasks = loadTasks();
  const len = tasks.length;
  tasks = tasks.filter(t => t.id !== Number(id));
  if (tasks.length === len) {
    console.log('❌ 未找到该任务');
    return;
  }
  saveTasks(tasks);
  console.log(`🗑️ 任务已删除`);
}

module.exports = { addTask, listTasks, completeTask, deleteTask };

帮我测试一下所有功能

node index.js add "学习 Claude Code" 高
node index.js add "完成项目文档" 中
node index.js add "代码审查" 低
node index.js list
node index.js complete 1
node index.js list
node index.js delete 2
node index.js list

✅ 任务已添加: 学习 Claude Code [高]
✅ 任务已添加: 完成项目文档 [中]
✅ 任务已添加: 代码审查 [低]
📋 任务列表:
  ⬜ [1716...] 学习 Claude Code (高) - 2026/5/18 10:30:00
  ⬜ [1716...] 完成项目文档 (中) - 2026/5/18 10:30:01
  ⬜ [1716...] 代码审查 (低) - 2026/5/18 10:30:02
✅ 任务已完成: 学习 Claude Code
📋 任务列表:
  ✅ [1716...] 学习 Claude Code (高) - 2026/5/18 10:30:00
  ⬜ [1716...] 完成项目文档 (中) - 2026/5/18 10:30:01
  ⬜ [1716...] 代码审查 (低) - 2026/5/18 10:30:02
🗑️ 任务已删除
📋 任务列表:
  ✅ [1716...] 学习 Claude Code (高) - 2026/5/18 10:30:00
  ⬜ [1716...] 代码审查 (低) - 2026/5/18 10:30:02

❌ 不好：修一下那个 bug
✅ 好：修复 src/api/auth.js 中 login 函数的 token 过期判断逻辑，
      当 refreshToken 为 null 时会抛出 TypeError

请帮我完成以下步骤：
1. 在 src/models/ 下创建 Task 模型
2. 在 src/routes/ 下创建 tasks 路由
3. 在 server.js 中注册路由
4. 添加对应的单元测试

## 开发规则
- 新增 API 端点时自动添加 JSDoc 注释
- 所有数据库操作使用事务
- 提交前运行 npm run lint 修复格式问题

# 让 Claude Code 分析改动并生成 commit message
claude -p "分析 git diff，生成合适的 commit message"

# 让 Claude Code 帮你创建分支和 PR
claude
> 请基于当前改动创建一个新分支 feature/task-priority，
> 提交代码，并发起 Pull Request

# 交互模式中
> /review
# 或直接描述需求
> 审查 src/api/ 目录下的所有文件，检查是否有 SQL 注入风险

// .claude/settings.json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-filesystem", "/path/to/project"]
    }
  }
}

# 查看可用 Skills
claude skills list

# 使用内置 Skill
claude -p "/commit"      # 智能 commit
claude -p "/review-pr"   # PR 审查