Claude Code零基础入门：安装到首个项目

┌──────────────────────────────────────────────────────────────┐
│                    Claude Code 架构概览                       │
├──────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌─────────┐    ┌─────────────┐    ┌───────────────────┐    │
│  │ 你的终端  │───▶│ Claude Code │───▶│ Anthropic Claude  │    │
│  │  / IDE   │◀───│   CLI/桌面   │◀───│     模型API       │    │
│  └─────────┘    └──────┬──────┘    └───────────────────┘    │
│                        │                                     │
│              ┌─────────┼─────────┐                          │
│              ▼         ▼         ▼                          │
│         ┌────────┐ ┌────────┐ ┌────────┐                   │
│         │ 文件系统 │ │ Shell   │ │  Git   │                   │
│         │ 读写   │ │ 命令执行 │ │ 操作   │                   │
│         └────────┘ └────────┘ └────────┘                   │
│                                                              │
└──────────────────────────────────────────────────────────────┘

# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc   # 或 source ~/.zshrc
nvm install --lts
node --version     # 确认 v18+

node --version     # 应显示 v18.x.x 或更高
npm --version      # 应显示 9.x.x 或更高
git --version      # Claude Code依赖Git，确保已安装

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

claude --version
# 预期输出：Claude Code v2.1.x 或更高

flowchart TD
    A[开始认证] --> B{你有哪种账号?}
    B -->|Claude Pro/Max/Team订阅| C[OAuth登录]
    B -->|Anthropic API Key| D[环境变量方式]
    C --> E[终端运行 claude]
    E --> F[浏览器自动打开]
    F --> G[登录claude.ai授权]
    G --> H[认证完成]
    D --> I[export ANTHROPIC_API_KEY=sk-ant-xxx]
    I --> J[认证完成]
    H --> K[开始使用]
    J --> K

claude
# 自动打开浏览器，跳转到 claude.ai 登录页面
# 登录后终端显示 "Authentication successful"

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

# 3. 启动Claude Code
claude

# bash用户
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxx"' >> ~/.bashrc
source ~/.bashrc

# zsh用户
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxx"' >> ~/.zshrc
source ~/.zshrc

/status

Account: [email protected]
Plan: Claude Max
Model: claude-sonnet-4-6

# 在项目目录启动交互式会话
cd /path/to/your/project
claude

# 一次性提问（不进入交互模式）
claude "这个项目用了什么技术栈?"

# 指定模型
claude --model claude-sonnet-4-6

# 退出会话
# 在会话中按 Ctrl+C 两次，或输入 /exit

claude                          # 交互式会话
claude "你的问题"                # 一次性问答
claude -p "提示词"              # 非交互管道模式（适合脚本）
claude --model claude-sonnet-4-6  # 指定模型
claude --resume                  # 恢复上次会话
claude --continue                # 继续最近一次对话
claude --verbose                 # 详细日志模式
claude --allowedTools "Read,Write,Bash"  # 限制可用工具

flowchart BT
    subgraph 配置层级
        E["🌐 Enterprise\n企业管理策略"] --> D["🏢 Team\n团队共享配置"]
        D --> C["👤 User\n用户全局配置"]
        C --> B["📁 Project\n项目级配置"]
        B --> A["🔒 Local\n本地个人配置"]
    end

    subgraph 文件位置
        F1["~/.claude/settings.json"]
        F2["项目根/.claude/settings.json"]
        F3["项目根/CLAUDE.md"]
        F4["~/.claude/CLAUDE.md"]
    end

    A --- F1
    B --- F2
    B --- F3
    C --- F4

# 在项目根目录执行
claude
> /init

# Project: my-todo-app

## Tech Stack
- Next.js 15 with App Router
- TypeScript
- Tailwind CSS
- SQLite with Drizzle ORM

## Commands
- `npm run dev` — Start development server
- `npm run build` — Production build
- `npm test` — Run tests with Vitest
- `npm run lint` — ESLint check

## Code Style
- Use TypeScript strict mode
- Prefer named exports
- Components in PascalCase, files in kebab-case
- Use `cn()` utility for conditional classes

## Architecture
- `app/` — Next.js App Router pages
- `components/` — Reusable React components
- `lib/` — Shared utilities and database
- `types/` — TypeScript type definitions

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git status)",
      "Bash(git diff *)",
      "Read",
      "Write"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push --force)"
    ]
  },
  "model": "claude-sonnet-4-6",
  "env": {
    "NODE_ENV": "development"
  }
}

# .claudeignore
.env
.env.local
**/secrets/**
**/credentials/**
node_modules/
*.pem
*.key

# 1. 创建项目目录
mkdir ~/claude-todo && cd ~/claude-todo

# 2. 初始化Git仓库
git init

# 3. 启动Claude Code
claude

> /init

帮我用Python构建一个命令行待办事项应用，要求：
1. 数据存储在JSON文件中（todos.json）
2. 支持添加、列出、完成、删除任务
3. 使用argparse处理命令行参数
4. 代码放在todo.py中
5. 添加颜色输出，让界面更好看

我来规划一下这个待办事项应用：

1. 创建 todo.py 主程序
   - argparse 定义子命令: add, list, done, delete
   - TodoManager 类管理数据读写
   - JSON文件持久化

2. 功能实现
   - add: 添加新任务
   - list: 显示所有任务（带状态标记）
   - done: 标记任务完成
   - delete: 删除任务

3. 添加颜色输出
   - 使用 colorama 库

确认这个方案，我开始编码？[Y/n]

#!/usr/bin/env python3
"""命令行待办事项应用"""
import argparse
import json
import os
from datetime import datetime

try:
    from colorama import init, Fore, Style
    init(autoreset=True)
    HAS_COLOR = True
except ImportError:
    HAS_COLOR = False

DATA_FILE = "todos.json"

def _color(text, color):
    if HAS_COLOR:
        return f"{color}{text}{Style.RESET_ALL}"
    return text

class TodoManager:
    def __init__(self, filepath=DATA_FILE):
        self.filepath = filepath
        self.todos = self._load()

    def _load(self):
        if os.path.exists(self.filepath):
            with open(self.filepath, "r") as f:
                return json.load(f)
        return []

    def _save(self):
        with open(self.filepath, "w") as f:
            json.dump(self.todos, f, indent=2, ensure_ascii=False)

    def add(self, title):
        todo = {
            "id": len(self.todos) + 1,
            "title": title,
            "done": False,
            "created": datetime.now().isoformat()
        }
        self.todos.append(todo)
        self._save()
        print(_color(f"  ✓ 已添加: {title}", Fore.GREEN))

    def list_all(self):
        if not self.todos:
            print(_color("  暂无任务", Fore.YELLOW))
            return
        for t in self.todos:
            status = _color("✓", Fore.GREEN) if t["done"] else _color("○", Fore.RED)
            title = _color(t["title"], Fore.WHITE) if not t["done"] else _color(t["title"], Fore.GREEN)
            print(f"  {status} [{t['id']}] {title}")

    def done(self, todo_id):
        for t in self.todos:
            if t["id"] == todo_id:
                t["done"] = True
                self._save()
                print(_color(f"  ✓ 已完成: {t['title']}", Fore.GREEN))
                return
        print(_color(f"  ✗ 未找到ID={todo_id}的任务", Fore.RED))

    def delete(self, todo_id):
        before = len(self.todos)
        self.todos = [t for t in self.todos if t["id"] != todo_id]
        if len(self.todos) < before:
            self._save()
            print(_color(f"  ✓ 已删除ID={todo_id}", Fore.GREEN))
        else:
            print(_color(f"  ✗ 未找到ID={todo_id}的任务", Fore.RED))

def main():
    parser = argparse.ArgumentParser(description="命令行待办事项")
    sub = parser.add_subparsers(dest="command")

    sub.add_parser("list", help="列出所有任务")

    add_p = sub.add_parser("add", help="添加任务")
    add_p.add_argument("title", help="任务标题")

    done_p = sub.add_parser("done", help="完成任务")
    done_p.add_argument("id", type=int, help="任务ID")

    del_p = sub.add_parser("delete", help="删除任务")
    del_p.add_argument("id", type=int, help="任务ID")

    args = parser.parse_args()
    mgr = TodoManager()

    if args.command == "add":
        mgr.add(args.title)
    elif args.command == "list":
        mgr.list_all()
    elif args.command == "done":
        mgr.done(args.id)
    elif args.command == "delete":
        mgr.delete(args.id)
    else:
        parser.print_help()

if __name__ == "__main__":
    main()

运行 python todo.py add "学习Claude Code" 然后运行 python todo.py list 确认功能正常

$ python todo.py add "学习Claude Code"
  ✓ 已添加: 学习Claude Code

$ python todo.py add "写第一个项目"
  ✓ 已添加: 写第一个项目

$ python todo.py list
  ○ [1] 学习Claude Code
  ○ [2] 写第一个项目

$ python todo.py done 1
  ✓ 已完成: 学习Claude Code

$ python todo.py list
  ✓ [1] 学习Claude Code
  ○ [2] 写第一个项目

用pytest为todo.py添加单元测试，覆盖添加、完成、删除、空列表场景。
测试应使用临时文件而非真实的todos.json。

# 运行测试
pip install pytest
pytest test_todo.py -v

flowchart LR
    A["📁 创建项目目录"] --> B["🔧 git init"]
    B --> C["🤖 启动 claude"]
    C --> D["📝 /init 生成配置"]
    D --> E["💬 描述需求"]
    E --> F["📋 确认开发计划"]
    F --> G["⚡ 自动编码"]
    G --> H["🧪 运行测试"]
    H --> I{测试通过?}
    I -->|是| J["✅ 完成"]
    I -->|否| K["🐛 描述错误"]
    K --> G

┌────────────────────────────────────────────┐
│            Token消耗分布                    │
├────────────────────────────────────────────┤
│ ████████████████░░░░  系统提示词    ~35%    │
│ ██████████░░░░░░░░░░  你的输入      ~15%    │
│ ██████████████░░░░░░  Claude回复    ~30%    │
│ ████████░░░░░░░░░░░░  工具调用结果  ~20%    │
└────────────────────────────────────────────┘

# 在会话中随时查看
/cost

# API Key用户的典型输出：
Session: 45,230 input + 12,450 output tokens
Estimated cost: $0.34

# 订阅用户看到的是用量配额：
Session: 45,230 input + 12,450 output tokens
Usage: 2.3% of daily limit

flowchart TD
    A["Day 1 目标：能用会基本操作"] --> B["Hour 1: 安装与认证"]
    B --> C["Hour 2: 空目录中探索命令<br/>/help, /status, /model"]
    C --> D["Hour 3: 用现有项目练习<br/>cd 到已有项目 → /init → 提问"]
    D --> E["Hour 4: 完成待办事项实战项目"]
    E --> F["Hour 5: 理解配置层级<br/>CLAUDE.md + settings.json"]
    F --> G["Hour 6: 尝试VS Code集成"]
    G --> H["✅ Day 1 完成！"]

    style A fill:#4A90D9,color:#fff
    style H fill:#2ECC71,color:#fff