Claude Code 完整教程

# npm 安装（推荐）
npm install -g @anthropic-ai/claude-code

# 中国用户使用淘宝镜像加速
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 添加到 ~/.bashrc 或 ~/.zshrc
export ANTHROPIC_BASE_URL=https://asia.qcode.cc/api
export ANTHROPIC_API_KEY=cr_你的API密钥

source ~/.bashrc  # 或 source ~/.zshrc

# 查看版本
claude --version
# 输出示例：2.1.84 (Claude Code)

# 快速测试
claude -p "你好，请介绍一下自己"

# Bash
claude completion bash >> ~/.bashrc

# Zsh
claude completion zsh >> ~/.zshrc

# Fish
claude completion fish > ~/.config/fish/completions/claude.fish

cd ~/my-project
claude

╭─────────────────────────────────────────╮
│ claude                                   │
│                                          │
│ 项目: my-project                         │
│ 模型: claude-sonnet-4-6                  │
│ 上下文: 12,345 / 200,000 tokens          │
╰─────────────────────────────────────────╯

> _

> 分析这个项目的架构，告诉我主要模块和它们之间的关系

Claude 想要执行：
  工具: Bash
  命令: npm test

  [y] 允许  [n] 拒绝  [a] 本次会话始终允许

# 进入规划模式
> /plan

# 或在提示中触发
> 请先分析需求，制定实施方案，不要直接改代码

> /plan
> 我想给项目添加用户认证功能，使用 JWT

Claude: 我来分析当前项目结构并制定方案...

📋 实施方案：
1. 创建 src/middleware/auth.ts — JWT 验证中间件
2. 创建 src/services/auth-service.ts — 认证业务逻辑
3. 修改 src/routes/index.ts — 添加登录/注册路由
4. 创建 src/models/user.ts — 用户数据模型
5. 添加依赖：jsonwebtoken, bcrypt
6. 创建测试文件

方案是否可以？需要调整吗？

> 这个并发 bug 已经排查了两天了，请帮我分析 src/worker.ts 中的竞态条件

[Claude 内部进行数千 token 的推理，分析执行路径、锁机制、时序问题]

Claude: 我找到了问题。在 worker.ts 第 127 行...

> 帮我 review 这个 PR，同时检查是否有安全漏洞

Claude: 我会启动两个子代理并行处理：

  - 子代理 1：代码质量审查
  - 子代理 2：安全漏洞扫描

# 查看当前上下文使用量
/cost

# 压缩上下文（保留关键信息，释放空间）
/compact

# 开始全新会话
/clear

# Claude 自动分析项目生成
/init

# MyApp

## 技术栈

- React 19 + TypeScript 5.x + Vite
- 样式：Tailwind CSS v4
- 状态管理：Zustand
- 测试：Vitest + Testing Library

## 常用命令

- 开发：`pnpm dev`
- 测试：`pnpm test`
- 构建：`pnpm build`
- Lint：`pnpm lint`

## 编码规范

- 组件使用函数式写法，Props 用 interface 定义
- 禁止使用 any 类型
- CSS 只用 Tailwind utility class
- 提交格式：feat: / fix: / docs:

## 项目结构

- src/components/ — 可复用组件
- src/pages/ — 页面组件
- src/hooks/ — 自定义 Hooks
- src/lib/ — 工具函数
- src/api/ — API 请求封装

## 注意事项

- Node.js 22+，包管理器用 pnpm
- 所有 API 请求经过 src/api/client.ts 统一处理

# 交互模式中切换
/model opus    # 切换到 Opus
/model sonnet  # 切换到 Sonnet
/model haiku   # 切换到 Haiku

# 启动时指定
claude --model claude-opus-4-6

一天的模型使用：
├── Sonnet 4.6（70%）— 日常开发、Bug 修复、写测试
├── Opus 4.6 （15%）— 架构决策、复杂问题
└── Haiku 4.5（15%）— 格式化、简单问答、批量操作

# 先用 Opus 制定方案
/model opus
> 分析这个模块的架构，制定重构方案

# 方案确认后切到 Sonnet 执行
/model sonnet
> 按照方案执行第一步

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write $FILEPATH"
          }
        ]
      }
    ]
  }
}

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_xxx" }
    }
  }
}

# 查看可用 skills
/skills

# 使用特定 skill
> /commit    # 使用 commit skill 生成提交
> /review    # 使用 review skill 审查代码

claude --bare -p "列出所有 TODO 注释" --output-format json

cd ~/unfamiliar-project
claude

> 请分析这个项目：
> 1. 使用了哪些技术栈
> 2. 核心模块及其职责
> 3. 数据流方向
> 4. 画一个简单的架构图（ASCII）

> /plan
> 我要给 API 添加速率限制功能，要求：
> - 每个用户每分钟最多 60 次请求
> - 使用 Redis 存储计数
> - 超限时返回 429 状态码和 Retry-After 头

Claude:
📋 实施方案：
1. 安装依赖：ioredis
2. 创建 src/middleware/rate-limiter.ts
3. 创建 src/config/rate-limit.ts（配置项）
4. 修改 src/app.ts（注册中间件）
5. 创建 tests/rate-limiter.test.ts
6. 更新 docker-compose.yml（添加 Redis 服务）

确认后我开始执行。

> 方案没问题，请执行

/model opus
> 用户报告说"并发下单时偶尔出现库存变为负数"。
> 请分析 src/services/order-service.ts 和 src/services/inventory-service.ts，
> 找出并发 bug 并修复。

[Opus 启用 Extended Thinking，分析执行路径、锁机制、事务隔离级别]

Claude: 我找到了问题。inventory-service.ts 第 45 行的库存检查和扣减不在同一个事务中，
存在 TOCTOU 竞态条件。修复方案是使用 SELECT FOR UPDATE...

> 项目中所有的 class 组件需要重构为函数式组件 + Hooks。
> 请逐个文件处理 src/components/ 下的所有 .tsx 文件。

Claude 会：
1. 扫描所有 class 组件
2. 逐个转换为函数式组件
3. 将 lifecycle 方法转为 useEffect
4. 将 this.state 转为 useState
5. 运行测试确认不 break

> 为 src/services/user-service.ts 编写完整的单元测试：
> - 覆盖所有公开方法
> - 包含正常路径和异常路径
> - Mock 外部依赖（数据库、缓存）
> - 目标覆盖率 90%+

# 在 GitHub Actions 中使用
claude -p "审查这个 PR 的代码变更，重点关注安全和性能" \
  --output-format json \
  --max-turns 3 \
  --allowedTools Read,Glob,Grep

# 1. Claude Code 制定方案
claude
> /plan
> 设计用户权限系统的实施方案

# 2. Codex 按方案执行
codex "按照 PLAN.md 中的方案，实现步骤 1-3"

# 方法 1：使用 sudo
sudo npm install -g @anthropic-ai/claude-code

# 方法 2：使用 nvm 管理 Node.js（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 22
npm install -g @anthropic-ai/claude-code

# 检查配置是否正确
echo $ANTHROPIC_BASE_URL   # 应为 https://asia.qcode.cc/api
echo $ANTHROPIC_API_KEY     # 应以 cr_ 开头

# 测试连通性
curl -I https://asia.qcode.cc/api/health