Appearance
Claude Code完全指南：安装配置、核心命令、高级功能与最佳实践
Claude Code本质上是一个通用的编程Agent框架，并不与特定模型绑定。开发者完全可以通过配置环境变量，使用国产模型如DeepSeek、GLM、Kimi等来驱动Claude Code。
如果你刚开始接触Claude Code，可能会被各种功能搞得眼花缭乱。这份指南将带你系统性地掌握这个工具，从最基础的安装配置讲起，一直到高级的自动化工作流。
一、环境搭建与基础入门
1.1 安装与身份验证
首次使用时，系统会提示进行身份验证。对于国内用户，可以在C:\Users\你的用户名\.claude\settings.json里添加：
json
"includeCoAuthoredBy": false来跳过身份验证过程。
Claude Code不与特定模型绑定，可以通过配置环境变量使用国产模型。推荐使用CC Switch自由切换。
1.2 三种工作模式详解
Claude Code设计了三种工作模式，理解这些模式的差异，是高效使用的关键。
| 模式 | 特点 | 提示标识 | 适用场景 |
|---|---|---|---|
| 默认模式 | 安全第一，每次修改都确认 | 输入框下方灰色"? For shortcuts" | 重要项目、代码质量要求高 |
| 自动模式 | 效率优先，自动处理文件操作 | 输入框下方"Accept edits on" | 快速原型、熟悉工作方式 |
| 规划模式 | 只讨论不写码 | — | 重大重构、复杂功能设计 |
切换技巧：按Shift + Tab在三种模式间循环切换。
1.3 终端命令无缝集成
输入感叹号（!）进入Bash模式，直接运行终端命令：
bash
! npm run dev # 启动开发服务器
! ls # 查看文件列表所有操作都在同一个界面完成，真正的"一体化开发环境"。
二、核心功能与日常使用
2.1 初始设置与个性化配置
中文界面：输入/config，找到language选项改成中文。
输出风格（重要但容易被忽略）：/config → Output Styles
| 风格 | 说明 |
|---|---|
| 详细解释模式（Explanatory） | 每次修改说明为什么这么改，适合学习 |
| 学习引导模式（Learning） | 给TODO列表让你自己动手，适合深入学习 |
自动更新通道：/config → Auto-update channel选stable通道，更稳定。
模型切换：用/model命令在Sonnet（速度快）和Opus（更聪明）间切换。平时用Sonnet快速开发，遇到棘手问题切到Opus深度思考。
自定义Output Style：
/output-style:new I want a style that teaches Next.js best practices.可以创建专属交互风格：技术写作助理、代码评审导师、特定框架专属风格等。
2.2 核心命令速查表
| 命令 | 功能 | 使用场景 |
|---|---|---|
/clear | 清空对话历史 | 完成功能后，节省Token |
/compact | 智能压缩对话 | 长时间聊天后让它重新"清醒" |
/context | 查看Token使用情况 | 可视化使用图表 |
/copy | 复制最后一次回复 | 以Markdown格式复制到剪贴板 |
/export | 导出完整对话 | 备份对话记录 |
/init | 初始化项目记忆 | 接手新项目时快速理解代码库 |
/memory | 编辑记忆文件 | 设置代码风格、开发规范 |
/rename | 重命名对话 | 给对话起有意义的名字 |
/resume | 继续之前的对话 | 无缝衔接上次话题 |
/status | 监控状态 | 查看模型、剩余Token、成本 |
/statusline | 定制状态栏 | 显示模型和剩余上下文比例 |
/usage | 查看使用量 | Pro用户管理配额 |
/doctor | 问题诊断 | 配置不生效、权限问题等 |
/compact比/clear更聪明：不是清空，而是总结压缩，保留核心信息。加Tab可以加参数，比如/compact 保留用户管理功能相关内容。
2.3 项目管理：CLAUDE.md
让Claude Code为你的项目生成"说明书"：
生成一个CLAUDE.md，总结本项目的技术栈、目录结构和约定。这个文件放在项目根目录，Claude Code会按照里面的规则工作。当它理解错了规则时，及时补充："请把这条规则写进CLAUDE.md。"
三、高级功能
3.1 安全与权限
终端命令授权：即使在自动模式下，运行终端命令也需要授权。三个选项：单次授权、目录级授权、拒绝。
完全权限模式（慎用）：
bash
claude --dangerously-skip-permissions名字里的"dangerously"不是开玩笑——它拥有了和你一样的系统权限。
后台任务管理：按Ctrl + B把服务放到后台。/tasks查看所有后台任务，按K终止。
版本回滚：按--rewind或双击ESC进入回滚界面。注意：只能回滚Claude Code自己写入的文件，终端命令创建的无法回滚，Git还是必不可少的。
3.2 分层配置
Claude Code支持通过claude.md文件分层管理规则：
| 层级 | 位置 | 作用 |
|---|---|---|
| 父目录规则 | 项目父目录 | 通用规则，子项目共用 |
| 语言专属规则 | js/python等目录 | 特定技术栈规则 |
| 项目规则 | 项目根目录 | 项目特定规则 |
⚠️ 避免把所有规则放在用户目录——每次对话都传输大量规则，浪费Token还多花钱。
3.3 Hook：自动化重复工作
输入/hooks进入配置界面。典型应用：配置post-tool-use Hook，在编辑文件后自动运行Prettier格式化。
Hook可以保存在三个级别：本机生效、团队共享、个人专属。
3.4 Skill：可复用的任务模板
在~/.claude/skills/目录下创建skill.md文件，定义任务标准流程。使用时Claude Code自动匹配，或用/skill-name显式调用。
3.5 Sub-Agent：重型任务隔离
复杂任务（如分析几万行代码）会塞满主对话的上下文窗口。用Sub-Agent在独立空间完成任务，只把最终结果返回主对话。
3.6 Plugin：一键部署完整方案
Plugin把多个Skill、Agent、Hook打包在一起。输入/plugin浏览、安装、管理插件。
3.7 深度思考模式
按Alt + T切换思考模式：
| 模式 | 适用场景 |
|---|---|
| 关闭思考 | 日常编码、调试、小型工具 |
| 开启思考 | 架构设计、复杂重构、性能优化 |
4级深度思考关键词，加在提示词末尾：
| 关键词 | 深度 |
|---|---|
think | 基础思考 |
think hard | 深度思考 |
think harder | 更深度思考 |
ultra think | 极致深度思考 |
示例："这个文件很复杂，分析一下并提出三种重构方案，ultra think"
四、高效工作流
4.1 规划模式：先想清楚再动手
按Shift + Tab两次进入规划模式，只讨论不写码。
技巧：
- 规划模式下用
Shift + Enter换行，直接按回车会提交 - 大量文字输入时按
Ctrl + G打开VS Code编辑器
4.2 高效换行
| 方法 | 兼容性 |
|---|---|
Ctrl + J | 所有终端都支持 |
Shift + Enter | Cursor、iTerm 2（需先运行terminal setup） |
Warp终端不支持Shift + Enter，推荐统一用Ctrl + J。
4.3 实时插话与快速取消
- 实时插话：任务执行中随时插入新指令，如"算了，用另一个方案"
- 快速取消：按
Escape键立即终止
4.4 上下文管理
长时间开发后，定期用/compact压缩，不相关任务用/clear清空。像电脑内存管理一样，适时清理让系统更流畅。
五、最佳实践
5.1 根据阶段调整模式
| 阶段 | 模式 |
|---|---|
| 快速原型 | 自动模式 |
| 生产开发 | 默认模式 |
| 架构设计 | 先规划模式讨论，再执行 |
5.2 权限管理
| 场景 | 权限策略 |
|---|---|
| 个人学习项目 | 可以放宽权限 |
| 团队协作项目 | 保持严格权限控制 |
| 生产环境 | 绝对不要用--dangerously-skip-permissions |
5.3 构建分层配置体系
基础规范写全局配置→技术栈规则写对应目录配置→项目特定规则写项目配置。既保证规则共享，又避免配置臃肿。
六、给新手的起步建议
刚接触Claude Code，做好两件事就能显著降低学习成本：
- 把Output Style设为详细解释模式——让Claude Code边做边解释
- 为每个项目生成CLAUDE.md——并在开发中持续更新
当工具越来越"懂"你和你的项目时，学习曲线自然就平缓了。
七、不只是代码生成工具
Claude Code代表的是一种新的开发范式：将AI能力深度融入开发工作流。它的价值不仅在于生成代码的速度，更在于提供了一个完整的、可扩展的智能开发环境。
真正的秘诀在于理解其设计理念：灵活的模式切换、精细的权限控制、开放的扩展机制、智能的上下文管理。通过这些特性，Claude Code成为了一个既强大又可控的合作伙伴。
