Claude Code 零基础入门到实战全攻略

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

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

brew install claude-code

winget install Anthropic.ClaudeCode

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

# Debian/Ubuntu
curl -fsSL https://claude.ai/install.sh | sh
# 或通过 apt（如已添加源）
sudo apt install claude-code

# Fedora/RHEL
sudo dnf install claude-code

# Alpine
sudo apk add claude-code

claude --version

2.1.56 (Claude Code)

claude

export ANTHROPIC_API_KEY="sk-ant-xxxxx"
claude

# 添加到 ~/.bashrc 或 ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxx"' >> ~/.zshrc
source ~/.zshrc

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的令牌",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "GLM-5.1"
  }
}

claude setup-token

╭─────────────────────────────────────╮
│  Welcome to Claude Code!            │
│  Model: claude-sonnet-4-6           │
│  Account: [email protected]            │
╰─────────────────────────────────────╯
>

~/.claude/CLAUDE.md              ← 全局配置（所有项目共享）
├── 项目根目录/CLAUDE.md          ← 项目级配置（推荐 git 管理）
├── 项目根目录/.claude/CLAUDE.md  ← 项目级隐藏配置
└── 子目录/CLAUDE.md              ← 目录级配置（特定模块）

claude   # 启动后输入 /init 命令自动生成

# 项目说明

这是一个 Node.js Express REST API 项目。

## 技术栈
- Node.js 20 + TypeScript
- Express.js
- PostgreSQL + Prisma ORM
- Jest 测试框架

## 代码规范
- 使用 ESLint + Prettier
- 变量名用 camelCase，文件名用 kebab-case
- 每个 API 端点都有对应的集成测试

## 重要规则
- 不要修改 prisma/migrations 目录下的迁移文件
- 所有 API 响应遵循 { success: boolean, data: any, error?: string } 格式
- 修改代码后运行 `npm test` 验证

graph TD
    A[CLAUDE.md 编写原则] --> B[具体而非抽象<br/>不要说"写好代码"<br/>要说"使用 camelCase 命名"]
    A --> C[包含项目上下文<br/>技术栈、目录结构、关键文件]
    A --> D[明确禁止事项<br/>不要修改哪些文件<br/>不要引入哪些依赖]
    A --> E[指定验证方式<br/>如何测试、如何构建]

    style A fill:#D97706,color:#fff
    style B fill:#3B82F6,color:#fff
    style C fill:#3B82F6,color:#fff
    style D fill:#10B981,color:#fff
    style E fill:#10B981,color:#fff

## 测试命令
- 单元测试: `npm run test:unit`
- E2E 测试: `npm run test:e2e`
- 修改任何文件后必须运行 `npm run test:unit` 确认通过

## 测试
- 记得写测试

# 交互模式（最常用）
cd your-project
claude

# 指定模型
claude --model opus

# 继续上次对话
claude --continue

# 恢复指定会话
claude --resume

# 单次问答
claude -p "解释这个项目的主要功能"

# 结合管道使用
cat error.log | claude -p "分析这个错误日志，找出根因"

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

# 限制预算
claude -p "重构这个函数" --max-budget-usd 1.0

~/.claude/settings.json        ← 用户级全局设置
.claude/settings.json          ← 项目级设置（共享）
.claude/settings.local.json    ← 项目级本地设置（不提交到 git）

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-xxxxx",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
  },
  "permissions": {
    "allow": [
      "Bash(npm test:*)",
      "Bash(npm run lint:*)",
      "Read",
      "Edit"
    ],
    "deny": [
      "Bash(rm -rf:*)"
    ]
  },
  "enabledPlugins": {
    "superpowers@claude-plugins-official": true,
    "context7@claude-plugins-official": true
  },
  "theme": "dark"
}

{
  "permissions": {
    "allow": [
      "Read",                        // 允许所有文件读取
      "Edit",                        // 允许所有文件编辑
      "Bash(git:*)",                 // 允许所有 git 命令
      "Bash(npm test:*)",            // 允许 npm test 及其子命令
      "Bash(npm run lint:*)",        // 允许 lint 相关命令
      "WebSearch",                   // 允许网络搜索
      "WebFetch"                     // 允许网页抓取
    ],
    "deny": [
      "Bash(rm -rf:*)",              // 禁止 rm -rf
      "Bash(curl|wget *:*)",         // 禁止外部下载
      "Edit(.env:*)",                // 禁止编辑 .env 文件
      "Read(*.pem)",                 // 禁止读取证书文件
      "Edit(*.pem)"                  // 禁止编辑证书文件
    ]
  }
}

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

# 初始化 Git
git init

# 启动 Claude Code
claude

/init

这是一个 Node.js + TypeScript + Express 的 REST API 项目，
使用 SQLite 作为数据库，Jest 作为测试框架。
请更新 CLAUDE.md 包含这些信息，并添加以下规则：
- API 路由定义在 src/routes/ 目录
- 数据库模型在 src/models/ 目录
- 每个路由都要有对应的测试文件
- 修改代码后运行 npm test 验证

帮我创建这个待办事项 API 项目的完整骨架，包括：
1. package.json（含所有依赖）
2. TypeScript 配置
3. Express 主入口 src/index.ts
4. Todo 模型 src/models/todo.ts
5. CRUD 路由 src/routes/todos.ts
6. 测试文件 tests/todos.test.ts
7. ESLint + Prettier 配置

安装依赖并运行测试

npm install
npm test

 PASS  tests/todos.test.ts
  Todo API
    ✓ GET /todos - 返回所有待办事项 (45 ms)
    ✓ POST /todos - 创建新待办事项 (23 ms)
    ✓ PUT /todos/:id - 更新待办事项 (18 ms)
    ✓ DELETE /todos/:id - 删除待办事项 (12 ms)

给 Todo 添加一个 priority 字段（low/medium/high），
更新模型、路由和测试

/review

flowchart TB
    S[cd your-project && claude] --> I[/init 初始化 CLAUDE.md]
    I --> D[描述需求给 Claude]
    D --> C{Claude 自主执行}
    C --> C1[创建/编辑文件]
    C --> C2[运行命令]
    C --> C3[执行测试]
    C1 --> V{验证结果}
    C2 --> V
    C3 --> V
    V -->|测试通过| G[git commit]
    V -->|有问题| F[描述问题给 Claude]
    F --> C
    G --> D

    style S fill:#D97706,color:#fff
    style C fill:#3B82F6,color:#fff
    style V fill:#10B981,color:#fff
    style G fill:#8B5CF6,color:#fff

# 压缩上下文（保留关键信息，丢弃冗余细节）
/compact

# 清空对话，完全重新开始
/clear

# 查看当前会话消耗
/cost

把 src/utils/format.ts 中的 formatDate 函数迁移到 src/utils/date.ts，
并更新所有引用它的文件

# 让 Claude 查看最近的改动
分析最近的 git diff，找出可能的 bug

# 让 Claude 帮你写 commit
帮我提交当前的改动，commit message 用中文

# 处理合并冲突
解决当前的 git merge conflict

# Claude 不断询问同一个操作？
# 在 settings.json 的 permissions.allow 中添加规则
{
  "permissions": {
    "allow": ["Bash(npm test:*)", "Bash(git:*)"]
  }
}

# 想临时提升自主度？
# 按 Shift+Tab 切换到 acceptEdits 模式

# 使用代理服务器
export HTTPS_PROXY=http://your-proxy:port
claude

# 使用自定义 API 端点
# 在 ~/.claude/settings.json 中配置 ANTHROPIC_BASE_URL

# 使用更快但成本更低的模型处理简单任务
claude --model haiku

# 复杂任务使用最强模型
claude --model opus

# 限制 API 花费
claude -p "快速检查" --model haiku --max-budget-usd 0.5