用 Claude Code
把最强推理模型装进你的终端

① 你用的是什么系统？

② 装好两样必备工具

检查 / 安装复制node -v        # 显示 v18.x.x 以上就 OK；提示找不到命令说明没装
npm -v         # 随 Node 一起，需要 v8+

# 没有 Node.js？两种装法（任选其一）：
# ① 官网下载：访问 https://nodejs.org 下载 LTS 版，双击安装
# ② 用 nvm：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash 然后 nvm install 20

检查 / 安装复制git --version  # 有版本号就 OK
# 没有？访问 https://git-scm.com/downloads 下载安装

③ 要花钱吗？

④ 它会弄坏我电脑吗？

⑤ 新手避坑 4 条

Claude Code 是 Anthropic 开发的终端原生 AI 编程助手。它直接运行在你的终端里，能理解整个代码库的上下文，通过自然语言指令帮你写代码、修 bug、解释陌生代码、做代码审查、处理 Git 工作流——是一个真正意义上的 Agentic（有自主行动力） 编码代理。

核心特性

系统要求

方式一：npm 全局安装（最通用）

bash（Windows 用 WSL/Git Bash）复制# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

# 升级到最新版
claude update

方式二：原生安装器（推荐，自动更新）

原生安装复制# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

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

方式三：Homebrew / WinGet

包管理器复制# macOS Homebrew
brew install --cask claude-code

# Windows WinGet
winget install Anthropic.ClaudeCode

🥚 实战：让 Claude 写一个脚本并运行

bash复制# 1. 新建一个空目录并进入
mkdir claude-hello && cd claude-hello
git init                          # 一定要初始化 git，方便回滚

# 2. 启动 Claude Code
claude

# 3. 在 REPL 输入框里输入（回车发送）：
#    先 /init 让它了解项目，再说：
#    "用 Python 写一个猜数字小游戏，保存到 game.py，然后运行它让我试玩"

🖥️ 启动后你会看到什么

第一次启动 claude，屏幕大致长这样（不用担心，照着提示走就行）：

REPL 界面示意┌─ claude ──────────────────── model: sonnet ──┐
│                                                │
│  > 帮我写一个猜数字游戏                         │  ← 你在这输入需求
│                                                │
│  🤖 好的，我来创建 game.py ...                  │
│  ⏺ Write(file_path: game.py)                   │  ← 权限提示
│    ❓ Do you want to proceed? [y/n/a]           │
│  ✓ 已创建 game.py                              │
│  ⏺ Bash(python game.py)                        │
│    ❓ Do you want to run this? [y/n]            │
│                                                │
└────────────────────────────────────────────────┘
   [ 输入你的需求... ]                       发送 ↵

🧠 思考强度关键词

处理难题前，在提示里加上思考关键词，让 Claude 加大推理深度（逐级递增）：

VS Code

VS Code 终端复制# 在 VS Code 内置终端运行
claude --ide

# 或先启动再连接
claude
> /ide

JetBrains（IntelliJ / PyCharm / WebStorm 等）

三种权限动作

六种权限模式

切换权限模式

三种切换方式复制# 1. 会话中：按 Shift+Tab 循环切换
#    default → acceptEdits → plan → auto

# 2. 启动时指定
claude --permission-mode plan

# 3. 写入 settings.json 设默认
# { "permissions": { "defaultMode": "acceptEdits" } }

# 会话中查看/修改规则
/permissions

权限规则语法

.claude/settings.json复制{
  "permissions": {
    "allow": ["Bash(npm run build)", "Bash(git status)", "Read"],
    "ask":   ["Bash(git push)"],
    "deny":  ["Bash(rm -rf *)", "Read(./secrets/*)"]
  }
}

文件放置位置与优先级

优先级（高→低）：项目本地 → 项目根 → 子目录 → 全局用户级。多个文件会全部加载并合并。

快速生成

会话内复制# 让 Claude 分析项目自动生成
/init

# 之后随时编辑（会打开编辑器）
/memory

/init 会分析项目结构、代码风格、已有配置（package.json、pyproject.toml、.eslintrc 等），自动生成一份符合实际的 CLAUDE.md。

推荐内容结构

CLAUDE.md复制# 项目名称
一句话说明项目是什么。

## 技术栈
- 语言：Python 3.11 / TypeScript 5.x
- 框架：FastAPI / Next.js
- 数据库：PostgreSQL + SQLAlchemy

## 常用命令
### 开发
uv run uvicorn main:app --reload   # 启动开发服务器
npm run dev                        # 前端开发
### 测试
npm test                           # 跑所有测试
npm run test:coverage              # 覆盖率
### 代码质量
npm run lint                       # ESLint

## 项目结构
- src/api/    — API 路由
- src/models/ — 数据模型
- tests/      — 测试，与 src 镜像

## 编码规范
- 文件名 kebab-case，组件名 PascalCase
- 优先具名导出，避免默认导出
- 所有函数必须有类型注解

## 注意事项
- ❌ 不要修改 migrations/ 下已有文件，只能新增
- ❌ config/secrets.py 禁止输出到日志
- 数据库操作必须走 Service 层

核心命令

compact vs clear

会话管理

上下文与记忆

项目与配置

模型与输出

代码与工具

集成 / 扩展 / 账户

命令前缀三剑客

创建一个 Skill

.claude/skills/optimize/SKILL.md复制---
name: optimize
description: 分析代码性能瓶颈，给出优化建议。用户提到性能问题时自动触发。
allowed-tools: Read, Grep, Glob
argument-hint: [目标文件或目录]
model: claude-sonnet-4-6
---
分析以下代码的性能瓶颈，优先考虑时间复杂度和内存占用，给出具体优化建议：

$ARGUMENTS

使用：/optimize src/utils/data-processor.ts

内置 Skills（开箱即用）

它能帮你做的 Git 事务

实战：让 Claude 提交并生成 PR

会话内复制# 1. 改完代码，让它按规范提交
把刚才的改动按 Conventional Commits 规范提交，
commit 信息用中文，body 说明动机

# 2. 推送并生成 PR
推送到远程，并创建一个 PR，描述里包含：
- 改了什么、为什么改
- 如何测试
- 是否有破坏性变更

GitHub Actions 自动 review（CI 集成）

配置后，每个新 PR 都会自动触发 Claude 做代码审查并留评论：

会话内复制# 一键配置 GitHub App + workflow
/install-github-app

# 会自动生成：
# .github/workflows/claude-code-review.yml
# 之后每个新 PR 自动 review

为什么要用

• 保留主上下文：探索 / 日志分析等重活放子代理，主对话只收摘要。
• 强制约束：工具白/黑名单限制能力（如只读分析、禁危险命令）。
• 专业化：为代码审查、调试、数据分析设计专用 AI。
• 控成本：简单活交 Haiku，复杂分析交 Sonnet（环境变量 CLAUDE_CODE_SUBAGENT_MODEL）。

内置子代理

创建你的子代理

会话内复制# 1. 打开管理界面
/agents

# 2. 选 Create new agent → Project (.claude/agents/) 或 User (~/.claude/agents/)
# 3. 用自然语言描述职责，Claude 自动生成配置
# 4. 配工具权限（只读就只勾 Read/Grep/Glob）+ 选模型（推荐 Sonnet）

# 使用：
使用 code-reviewer 子代理审查 src/auth.ts 的代码质量

.claude/agents/code-reviewer.md复制---
name: code-reviewer
description: Reviews code for quality, best practices, and security.
             Invoke when the user asks to review or audit code.
tools: Read, Grep, Glob
model: sonnet
---
你是一位严格的代码审查专家。重点检查：
1. 潜在 bug 与边界情况
2. 安全漏洞（注入、敏感信息泄露）
3. 性能与可维护性
给出按优先级排序的改进建议和示例。

支持的钩子事件

配置示例：编辑文件后自动 lint

.claude/settings.json复制{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "npm run lint:fix", "timeout": 30 }
        ]
      }
    ]
  }
}

MCP 命令

bash复制# 交互式配置
claude mcp

# 添加 / 列出 / 查看 / 删除
claude mcp add <名> -- <command> [args]
claude mcp list
claude mcp get <名>
claude mcp remove <名>

# 会话内查看连接状态
/mcp

接入后，MCP 服务器会自动暴露命令，格式 /mcp__服务器__命令，例如接入 GitHub 后可用 /mcp__github__list_prs。

插件系统

会话内复制/plugin                       # 打开插件管理
/plugin marketplace           # 浏览官方市场（36+ 精选）
/plugin install typescript-lsp # 安装
/plugin list                  # 列出已装
/plugin update                # 全部更新
/reload-plugins               # 热重载，无需重启

IDE 集成

三种并行姿势

子代理并行：3 倍提速

把探索、日志分析等重活交给子代理并行跑，主对话只收结论。实测并行 3 个子代理分析 5 万行项目约 45 秒，串行需 3 分钟。

会话内复制# 让多个子代理并行工作
请并行使用以下 agents：
1. code-reviewer 审查代码质量
2. security-agent 做安全扫描
3. test-writer 补充单元测试
最后把三份结果汇总给我

多会话编排：完整流水线

用编排器把多个 Claude Code 会话串成一条流水线，每个会话上下文完全独立：

CLI 常用标志

常用环境变量

定制化构建顺序

模型选择策略

任务执行习惯

• 复杂任务先用 /plan：让它先出方案，确认后再执行，避免走偏。
• 难题加思考关键词：think hard / ultrathink 加大推理深度。
• 定期 /compact：每 20 轮左右压缩，新任务 /clear。
• 不满意就 /rewind：比让 AI"撤销"可靠得多。
• 常看 /cost：监控 token 花费，及时优化。

费用控制实战

• 简单任务用 Haiku：/model haiku 或子代理设 Haiku，快又便宜。
• 限思考预算：设 MAX_THINKING_TOKENS 上限，避免 ultrathink 烧 token。
• 定期 /compact：压缩历史，减少每次输入 token。
• 用 ! 和 @ 省推理：!命令 不让 AI 推理，@文件 精准注入。
• 常看 /cost 与 /usage：监控本次花费与套餐配额。

场景

你要在一个 Express + TypeScript 项目里加一个用户认证模块，要求安全、有测试、改完自动 lint。

第 1 步：用 CLAUDE.md 立规矩

CLAUDE.md复制# 认证模块开发指南
## 技术栈
- Express 5 + TypeScript 5（严格模式）
- JWT 认证，bcrypt 哈希
## 规范
- 所有密码必须 bcrypt 哈希，禁止明文存储/日志
- 密钥从环境变量读，禁止硬编码
- 每个 API 必须有集成测试
## 常用命令
- npm test          # 跑测试
- npm run lint      # ESLint
- npm run typecheck # 类型检查
## 禁止
- ❌ 修改现有 migrations
- ❌ 把 secrets 写进代码

第 2 步：用权限规则上保险

.claude/settings.json复制{
  "permissions": {
    "allow": ["Bash(npm test)", "Bash(npm run lint)", "Bash(npm run typecheck)"],
    "ask":   ["Bash(git push)"],
    "deny":  ["Bash(git push --force*)", "Read(./.env*)"]
  }
}

第 3 步：配 Hook 自动 lint

.claude/settings.json（续）复制{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Edit|Write",
      "hooks": [{ "type": "command", "command": "npm run lint:fix", "timeout": 30 }]
    }]
  }
}

第 4 步：先规划再动手

会话内复制# 进入计划模式，让它先出方案
/plan 实现用户认证模块：注册、登录（JWT）、登出，
密码 bcrypt，加集成测试。think hard 一下安全风险。
# 看完计划确认 OK，再让它执行

第 5 步：用子代理并行收尾

会话内复制# 实现完后，并行让专项代理把关
请并行：
1. security-agent 做安全审查（注入、越权、密钥泄露）
2. code-reviewer 审查代码质量
3. test-writer 补齐边界用例
最后用 /security-review 再过一遍，全绿再提交。