# Claude Code 中文手册

> 基于 Claude Code v2.1.291 官方文档整理的 Claude Code 中文手册。

- 作者：David（道雾轩）
- 最后更新：2026-09-28
- 原文：https://daiw.org/manual/claude-code
- 转载与引用：请注明出处并附原文链接（https://daiw.org/about/copyright）

[Claude Code](https://claude.com/product/claude-code) 是 [Anthropic](https://www.anthropic.com/) 官方提供的命令行 AI 编程助手，以 `claude` 命令启动，在终端里读写文件、执行命令、调用 MCP 工具，完成从代码理解到提交 PR 的完整开发流程。

本手册已核对至 **Claude Code v2.1.291**（2026-10-06 发布）。内容随官方文档更新，但不追踪每一个补丁版本；具体行为请以你本机 `claude doctor` 与 `claude --version` 的实际结果为准。

```bash
claude --version
```

## 手册结构

- [安装与升级](https://daiw.org/manual/claude-code/installation)——原生安装脚本、Homebrew/WinGet/包管理器、npm、二进制完整性校验、自动更新与卸载。
- [启动命令行选项](https://daiw.org/manual/claude-code/cli-flags)——`claude` 子命令与 `--flag` 全量参考。
- [环境变量](https://daiw.org/manual/claude-code/environment-variables)——按用途分类的环境变量速查。
- [配置文件](https://daiw.org/manual/claude-code/configuration-files)——`settings.json`、`CLAUDE.md`、`.mcp.json` 等配置文件的位置、格式与优先级。
- [上手使用](https://daiw.org/manual/claude-code/scenarios)——从熟悉新代码库到修 bug、重构、写测试、开 PR、并行开发的实操套路。
- 命令参考——按使用场景拆成会话管理、模型与权限、并行协作、代码评审、自定义扩展、其它实用命令六个子页面，涵盖全部内置斜杠命令与随附技能（skill）。
- **进阶**——[Commands](https://daiw.org/manual/claude-code/custom-commands)、[Skills](https://daiw.org/manual/claude-code/skills)、[Agents](https://daiw.org/manual/claude-code/agents)、[Plugins](https://daiw.org/manual/claude-code/plugins)。
- [版本 Changelog](https://daiw.org/manual/claude-code/changelog)——从 1.0 GA 到 2.1.291 的关键里程碑（见「其它」分组）。

## 最快上手路径

```bash
# 1. 安装（macOS / Linux / WSL）
curl -fsSL https://claude.ai/install.sh | bash

# 2. 在项目根目录启动并登录
cd /path/to/project
claude

# 3. 首次进入项目，先生成 CLAUDE.md
/init
```

之后的操作大多是「用自然语言描述任务 + 在需要时用斜杠命令控制会话」的组合，具体可参考[上手使用](https://daiw.org/manual/claude-code/scenarios)。

## 本专栏篇目

- [概览](https://daiw.org/manual/claude-code.md): 基于 Claude Code v2.1.291 官方文档整理的 Claude Code 中文手册。

### 入门

- [安装与升级](https://daiw.org/manual/claude-code/installation.md): 系统要求、各平台安装方式、更新策略与卸载方法
- [启动命令行选项](https://daiw.org/manual/claude-code/cli-flags.md): claude 子命令与全部命令行参数参考
- [环境变量](https://daiw.org/manual/claude-code/environment-variables.md): 按用途分类的环境变量速查（认证、模型、网络、隐私、Bash 行为等）
- [配置文件](https://daiw.org/manual/claude-code/configuration-files.md): settings.json、CLAUDE.md、.mcp.json 等配置文件的位置、格式与优先级
- [上手使用](https://daiw.org/manual/claude-code/scenarios.md): 从熟悉新代码库到修 bug、重构、写测试、开 PR、并行开发的实操步骤

### 命令参考

- [会话与上下文管理](https://daiw.org/manual/claude-code/commands-session.md): 目录访问、上下文压缩、分支与回滚、导出与恢复
- [模型、效率与权限](https://daiw.org/manual/claude-code/commands-model-permissions.md): 模型切换、推理强度、执行速度、权限模式与规则管理
- [并行与后台协作](https://daiw.org/manual/claude-code/commands-collaboration.md): 后台 agent、批量任务分解、worktree 并行开发、远程控制与团队协作
- [代码评审与 Git 工作流](https://daiw.org/manual/claude-code/commands-review.md): 查看变更、代码评审、安全评审与 PR 相关命令
- [自定义与扩展](https://daiw.org/manual/claude-code/commands-customization.md): CLAUDE.md、技能（skills）、插件、MCP、Hooks 与界面自定义
- [账户、诊断与其它命令](https://daiw.org/manual/claude-code/commands-misc.md): 登录账户、用量统计、诊断修复、语音与移动端等零散但常用的命令

### 进阶

- [Commands](https://daiw.org/manual/claude-code/custom-commands.md): Claude Code 中文手册 · 斜杠命令与 .claude/commands 自定义命令，及与 Skills 体系的迁移关系
- [Skills](https://daiw.org/manual/claude-code/skills.md): Claude Code 中文手册 · SKILL.md 格式、自动调用、工具白名单、fork 执行与团队分发
- [Agents](https://daiw.org/manual/claude-code/agents.md): Claude Code 中文手册 · Subagent 定义、后台并行、动态工作流与 claude agents 监控
- [Plugins](https://daiw.org/manual/claude-code/plugins.md): Claude Code 中文手册 · 插件的组成、目录结构、Marketplace 安装分发、作者侧打包与团队 settings

### 其它

- [版本 Changelog](https://daiw.org/manual/claude-code/changelog.md): 从 1.0 GA 到 2.1.291 的关键里程碑（精选，非逐条流水账），着重梳理近期逐版本变化