Claude Code 入门教程：从安装到完成第一个项目

# 使用 nvm 安装 Node.js（Linux/macOS）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install --lts
node --version   # 应输出 v18.x 或更高

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

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

claude --version
# 预期输出：2.x.x（版本号随更新变化）

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

npm config set registry https://registry.npmmirror.com

claude

✻ Welcome to Claude Code!

...

> Try "create a util logging.py that..."

mkdir todo-app && cd todo-app
npm init -y
git init
claude

> 这个项目当前是什么结构？帮我初始化一个规范的 package.json

> /init

flowchart TD
    A["企业策略<br/>/etc/claude-code/CLAUDE.md<br/>IT 统一下发"] --> B["用户全局<br/>~/.claude/CLAUDE.md<br/>个人所有项目生效"]
    B --> C["项目共享<br/>./CLAUDE.md<br/>提交到 Git 团队共享"]
    C --> D["项目本地<br/>./CLAUDE.local.md<br/>个人笔记不入库"]
    style A fill:#e8eaf6
    style B fill:#c5cae9
    style C fill:#9fa8da
    style D fill:#7986cb

# 项目约定

## 命令
- 运行测试：npm test
- 启动开发：node index.js

## 代码风格
- 使用 ES modules（import/export），不用 CommonJS
- 所有函数必须有 JSDoc 注释

## 工作流
- 完成代码修改后必须运行 npm test 验证
- 不要自动 git commit，先给我看改动

> 创建一个 TODO 命令行应用：
> 1. 用 index.js 实现添加、列出、完成三个命令
> 2. 数据存储在 todos.json
> 3. 附带完整的测试文件，写完后运行测试验证

flowchart LR
    A[理解任务] --> B[探索现有代码]
    B --> C[提出修改方案]
    C --> D{用户确认?}
    D -- 允许 --> E[执行编辑/命令]
    D -- 拒绝 --> C
    E --> F[运行测试验证]
    F -- 失败 --> B
    F -- 通过 --> G[汇报结果]
    G --> H[等待下一个任务]
    style F fill:#c8e6c9

# 管道输入：把日志喂给 Claude 分析
cat error.log | claude -p "找出异常并给出修复建议"

# 指定输出格式，便于程序解析
claude -p "列出所有API端点" --output-format json

#!/usr/bin/env node
import fs from 'fs';
import { Command } from 'commander';

const program = new Command();
const DB_FILE = './todos.json';

function loadTodos() {
  try {
    return JSON.parse(fs.readFileSync(DB_FILE, 'utf-8'));
  } catch {
    return [];
  }
}

function saveTodos(todos) {
  fs.writeFileSync(DB_FILE, JSON.stringify(todos, null, 2));
}

program.command('add <text...>')
  .description('添加一条待办')
  .action((text) => {
    const todos = loadTodos();
    todos.push({ id: Date.now(), text: text.join(' '), done: false });
    saveTodos(todos);
    console.log(`已添加: ${text.join(' ')}`);
  });

program.command('list')
  .description('列出全部待办')
  .action(() => {
    const todos = loadTodos();
    if (!todos.length) return console.log('暂无待办');
    todos.forEach(t =>
      console.log(`${t.done ? '[x]' : '[ ]'} #${t.id} ${t.text}`));
  });

program.command('done <id>')
  .description('标记完成')
  .action((id) => {
    const todos = loadTodos();
    const todo = todos.find(t => t.id === Number(id));
    if (!todo) return console.log('未找到该条目');
    todo.done = true;
    saveTodos(todos);
    console.log(`已完成: ${todo.text}`);
  });

program.parse();

import { test } from 'node:test';
import assert from 'node:assert';
import { execSync } from 'node:child_process';

const run = (args) =>
  execSync(`node index.js ${args}`, { encoding: 'utf-8' });

test('添加并列表显示', () => {
  run('add "写周报"');
  const out = run('list');
  assert.match(out, /\[ \].*写周报/);
});

test('标记完成后状态更新', () => {
  run('add "买菜"');
  const list = run('list');
  const id = list.match(/#(\d+) 买菜/)[1];
  run(`done ${id}`);
  assert.match(run('list'), /\[x\].*买菜/);
});