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

node --version
# 预期输出类似：v20.11.0 或更高

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 重新加载 shell 配置
source ~/.bashrc  # 或 source ~/.zshrc

# 安装 Node.js LTS 版本
nvm install --lts
nvm use --lts

# 验证
node --version
npm --version

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

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

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

# 稳定版（约滞后一周）
brew install --cask claude-code

# 最新版
brew install --cask claude-code@latest

winget install Anthropic.ClaudeCode

claude --version
# 预期输出：2.1.56 (Claude Code) 或更高版本号

claude --help

claude

export ANTHROPIC_API_KEY="sk-ant-xxxxx"
claude

echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxx"' >> ~/.bashrc
source ~/.bashrc

> /login
# 按提示选择新的认证方式

claude auth status 2>/dev/null || claude --version

graph TB
    subgraph 全局级 "~/.claude/"
        A["CLAUDE.md<br/>全局指令（所有项目生效）"]
        B["settings.json<br/>全局设置"]
        C["skills/<br/>全局 Skills"]
    end

    subgraph 项目级 "项目根/.claude/"
        D["CLAUDE.md<br/>项目指令（仅本项目）"]
        E["settings.json<br/>项目设置"]
        F["commands/<br/>项目自定义命令"]
    end

    subgraph 本地级 "项目根/.claude/local/"
        G["settings.local.json<br/>本地覆盖（不提交Git）"]
    end

    subgraph 根目录 "项目根/"
        H["CLAUDE.md<br/>根目录指令（最简配置）"]
    end

    A -.->|优先级从高到低| H
    G -->|覆盖| E
    E -->|覆盖| B

    style A fill:#f96,stroke:#333
    style D fill:#9cf,stroke:#333
    style H fill:#9f9,stroke:#333

# 项目：任务管理 API

## 技术栈
- Python 3.12 + FastAPI
- PostgreSQL 15
- SQLAlchemy ORM
- pytest 测试框架

## 代码规范
- 使用 type hints，所有函数必须有类型注解
- 遵循 PEP 8 命名规范
- API 路由统一使用 kebab-case：/user-profile
- 错误处理使用 FastAPI HTTPException

## 项目结构
- app/api/ - API 路由定义
- app/models/ - SQLAlchemy 模型
- app/schemas/ - Pydantic 数据模型
- app/services/ - 业务逻辑层
- tests/ - 测试文件

## 测试要求
- 运行测试命令：pytest tests/ -v
- 新增 API 端点必须附带测试
- 测试覆盖率目标：> 80%

## Git 规范
- 不要自动 commit
- commit message 使用中文
- 分支命名：feature/xxx, fix/xxx

cat ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-xxxxx"
  },
  "permissions": {
    "allow": [
      "Bash(git log:*)",
      "Bash(npm test:*)",
      "Read",
      "Glob",
      "Grep"
    ],
    "deny": [
      "Bash(rm -rf:*)"
    ]
  }
}

工具名(命令模式)

# 进入项目目录
cd ~/my-project

# 启动交互式会话
claude

# 继续上一次对话
claude -c

# 恢复指定会话（提供会话 ID）
claude -r <session-id>

# 使用指定模型
claude --model sonnet
claude --model opus

# 单次提问并输出结果
claude -p "解释这个项目的目录结构"

# 管道输入
echo "什么是 REST API?" | claude -p

# 指定输出格式为 JSON
claude -p "列出所有 TODO 注释" --output-format json

# 设置预算上限
claude -p "重构这个函数" --max-budget-usd 0.5

# 流式 JSON 输出（适合程序集成）
claude -p "分析代码质量" --output-format stream-json

# 创建项目目录
mkdir ~/todo-api && cd ~/todo-api

# 初始化 Git 仓库
git init

# 初始化 Python 项目
python3 -m venv venv
source venv/bin/activate
pip install fastapi uvicorn sqlalchemy pytest httpx

# 保存依赖
pip freeze > requirements.txt

cat > CLAUDE.md << 'EOF'
# Todo API 项目

## 技术栈
- Python 3.12 + FastAPI
- SQLAlchemy (SQLite，开发环境)
- pytest + httpx 测试

## 代码规范
- 所有函数使用 type hints
- 遵循 PEP 8
- API 路由前缀：/api/v1

## 项目结构
- app/main.py - 应用入口
- app/models.py - 数据模型
- app/schemas.py - Pydantic 模型
- app/database.py - 数据库配置
- tests/ - 测试目录

## 测试
- 命令：pytest tests/ -v
- 每个 API 端点必须有对应测试

## 规则
- 不要自动 commit
- 不要修改 .env 文件
- 修改代码后主动运行测试验证
EOF

claude

请帮我创建一个 Todo API 项目的基础结构，包括：
1. app/main.py - FastAPI 应用入口
2. app/models.py - Todo 数据模型（字段：id, title, description, completed, created_at）
3. app/schemas.py - Pydantic 请求/响应模型
4. app/database.py - SQLite 数据库配置

要求：使用 SQLAlchemy 2.0 风格，支持异步操作

在 app/api/ 目录下创建 todo 路由，包含以下端点：
- GET /api/v1/todos - 获取所有 todo（支持分页和过滤）
- GET /api/v1/todos/{id} - 获取单个 todo
- POST /api/v1/todos - 创建 todo
- PUT /api/v1/todos/{id} - 更新 todo
- DELETE /api/v1/todos/{id} - 删除 todo

同时更新 main.py 注册路由

为所有 todo API 端点编写测试，放在 tests/test_todo.py 中。
使用 httpx 的 AsyncClient，测试数据库用独立的 SQLite 文件。
覆盖：创建、读取、更新、删除、分页、错误处理

运行所有测试，确保通过

我在创建 todo 时返回了 500 错误，错误信息是 "column 'created_at' does not exist"。
请帮我找出问题并修复。

请帮我查看当前的代码变更，准备提交。

# 压缩对话历史（保留关键信息）
> /compact

# 手动指定压缩重点
> /compact 保留数据库模型和API路由相关的讨论

# 清空对话重新开始
> /clear

请将所有 API 路由中的错误处理统一改为使用 app/exceptions.py 中定义的自定义异常类

审查 app/api/todos.py 的代码质量，关注：
1. 安全漏洞（SQL注入、XSS等）
2. 性能问题（N+1查询等）
3. 代码风格一致性

请同时完成以下任务：
1. 搜索整个项目中所有使用 print() 调试语句的地方，替换为 logging
2. 检查所有 API 端点是否有认证保护
3. 为缺少 docstring 的公共函数添加文档

# 通过插件安装
claude plugin install <plugin-name>

# 手动创建 skill
mkdir -p ~/.claude/skills/my-skill
cat > ~/.claude/skills/my-skill/skill.md << 'EOF'
---
name: my-skill
description: 我的自定义技能
---

# My Skill

执行自定义工作流的详细步骤...
EOF

# 添加 MCP 服务器
claude mcp add my-server -- npx -y @some/mcp-server

# 查看已配置的 MCP 服务器
claude mcp list

# 测试 MCP 连接
claude mcp test my-server

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "command": "npx eslint --fix $CLAUDE_FILE_PATH"
      }
    ]
  }
}

# 检查安装路径
which claude

# 如果为空，检查 npm 全局路径
npm config get prefix
# 确保 <prefix>/bin 在 PATH 中
export PATH="$(npm config get prefix)/bin:$PATH"

# 允许运行
xattr -d com.apple.quarantine $(which claude)

# 重新登录
claude auth logout
claude auth login

echo $ANTHROPIC_API_KEY

## 不要修改的文件
- .env / .env.local
- docker-compose.yml
- migrations/ 目录下的文件

{
  "permissions": {
    "allow": [
      "Bash(pytest:*)",
      "Bash(python:*)",
      "Bash(git status:*)",
      "Bash(git diff:*)",
      "Bash(git log:*)",
      "Read",
      "Glob",
      "Grep"
    ]
  }
}