ZTDD School

Appearance

Claude Code 入门：Anthropic 官方 CLI 完全指南 ​

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，它让开发者能在终端中直接与 Claude 对话，完成代码编写、调试、重构和项目探索。本文将全面介绍 Claude Code 的安装配置、核心功能和实战技巧。

更新日期：2026-09-28 | 适用版本：Claude Code 最新稳定版

什么是 Claude Code？ ​

Claude Code 是一个运行在终端中的 AI 编程工具，它直接嵌入你的开发工作流，而不需要切换 IDE 或打开网页。它的核心能力包括：

  • 代码编辑 — 读取项目文件，理解上下文，生成和修改代码
  • 终端集成 — 直接运行命令，查看输出，诊断问题
  • Git 感知 — 理解仓库状态，生成提交信息，管理分支
  • 多文件操作 — 一次性理解整个项目结构，跨文件重构
  • Agent 模式 — 自动拆解复杂任务，逐步执行

与其他工具的区别 ​

工具形式适合场景
Claude CodeCLI 终端后端开发、全栈项目、复杂重构
GitHub CopilotIDE 插件日常编码自动补全
CursorAI-first IDE前端开发、需要可视化调试
Claude.aiWeb 聊天快速问答、文档生成

安装与配置 ​

安装 ​

bash
# npm 全局安装
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

首次启动 ​

bash
# 在项目目录中启动
cd your-project
claude

首次启动时，Claude Code 会：

  1. 请求终端权限（命令执行、文件读写）
  2. 请求 Google 登录授权（关联 Anthropic 账号）
  3. 分析项目结构并生成 CLAUDE.md（项目上下文文件）

配置选项 ​

配置文件位于 ~/.claude/settings.json：

json
{
  "permissions": {
    "allow": ["Bash", "Read", "Write", "Edit", "Glob"]
  },
  "model": "claude-sonnet-5",
  "theme": "dark"
}

常用设置项：

  • model — 选择模型（sonnet/opus/haiku）
  • permissions — 控制 Claude 可执行的命令类型
  • theme — 主题（dark/light）

核心工作流 ​

日常对话模式 ​

bash
claude
# 进入交互式 REPL，直接输入问题

常用指令：

指令作用
/help查看帮助
/clear清空会话
/review代码审查
/plan进入规划模式
/diff查看变更差异

文件编辑模式 ​

Claude Code 会自动识别你提到的文件：

bash
# 直接启动并带提示
claude "帮我重构 src/api/user.ts 中的用户认证逻辑"

# 或先启动，然后输入
# "读取 src/api/user.ts，分析其中的安全问题"

Agent 模式（自动执行） ​

Claude Code 会自主规划并执行多步任务：

bash
claude "为这个项目添加 Redis 缓存层"

它自动会：

  1. 阅读现有数据库访问代码
  2. 设计缓存方案
  3. 安装 redis 依赖
  4. 编写缓存中间件
  5. 修改现有查询
  6. 运行测试验证

Git 工作流集成 ​

bash
# 在对话中
# "查看当前分支状态"
# "帮我写提交信息"
# "创建 PR 描述"

高级技巧 ​

自定义系统提示 ​

通过 ~/.claude/CLAUDE.md（全局）或项目 .claude/CLAUDE.md（项目级）自定义 Claude 的行为规则：

markdown
# CLAUDE.md

## 项目
这是一个 Node.js 后端项目，使用 Express + Prisma + PostgreSQL

## 编码规范
- 使用 TypeScript
- 遵循 ESLint 规则
- 测试覆盖率不低于 80%
- 先写测试再写实现

上下文管理 ​

  • 大型项目中先让 Claude 读 CLAUDE.md
  • 复杂修改前先用 /plan 确认方案
  • 上下文超过 70% 时用 /clear 重置
  • 善用 Agent 并行处理独立任务

多代理协作 ​

Claude Code 支持在对话中生成子代理，并行处理独立任务：

bash
# "派一个 agent 分析性能瓶颈，另一个 agent 审查安全漏洞"

实战案例：用 Claude Code 添加新 API ​

需求 ​

为一个电商项目添加「商品搜索」API，支持关键词、分类、价格范围过滤。

步骤 ​

第一步：分析现有代码

bash
claude "分析项目的 API 结构，特别是商品模块的路由、控制器和服务层"

第二步：规划实现

Claude 会阅读现有代码，发现模式，然后提出计划：

Plan:
1. 创建 SearchService（搜索服务）
2. 创建 SearchController（搜索控制器）
3. 添加路由 /api/products/search
4. 添加请求验证器
5. 编写测试

第三步：TDD 执行

Claude Code 按 TDD 模式执行：先写测试 → 运行（RED）→ 写实现 → 运行（GREEN）→ 重构。

第四步：代码审查

bash
# 对话中输入
/review

Claude Code 会自动审查变更，检查：

  • 安全漏洞（SQL 注入、XSS 等）
  • 性能问题（N+1 查询等）
  • 代码质量（命名、错误处理等）

结果 ​

  • 新 API 在 15 分钟内完成
  • 测试覆盖率达到 90%+
  • 零人工代码审查问题

最佳实践 ​

✅ 这样做 ​

  • 明确指定文件路径 — "读取 src/services/user.ts" 比 "看看用户服务" 更高效
  • 提供足够的上下文 — 涉及多处代码时，让 Claude 先全量阅读
  • 使用 /plan 处理复杂任务 — 先确认计划再执行，减少返工
  • 善用 Agent 并行 — 独立任务同时执行，节省等待时间

❌ 避免这样做 ​

  • 模糊的问题 — "优化这个项目" 太宽泛，应该具体到模块
  • 跳过 TDD — 直接写实现后再补测试，容易遗漏边界条件
  • 频繁切换模型 — 让一个模型做完任务再换，减少上下文丢失

限制与边界 ​

Claude Code 虽然强大，但也有一些局限：

限制说明应对
上下文窗口单次对话上下文有限适时 /clear，分阶段执行
权限模式自动模式下会跳过部分确认复杂操作前先 /plan
网络依赖需要 API 连接本地开发保持网络通畅
大型项目全量分析耗时先让 Claude 阅读关键文件

下一步 ​

本文是 ZTDD School AI 知识库的第一篇文章。我们致力于提供最新、最全面的 AI 技术知识。