Claude Code 使用指南

核心概念

Claude Code 是 Anthropic 官方 CLI 工具，直接在终端中运行，能够读写文件、执行命令、搜索代码库、调用 Git 等。

---

快速上手

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

# 启动交互会话
claude

# 单次执行任务
claude "帮我找出所有未处理的 TODO"

# 在项目目录中启动
cd my-project && claude

---

Skills（技能）系统

Skills 是 Claude Code 中预定义的专项能力，通过 /skill名称 触发，相当于执行一段精心设计的提示词流程。

触发方式

/skill名称 [可选参数]

内置 Skills 一览

/commit — 智能提交

自动分析暂存的变更，生成规范的 commit message 并提交。

# 用法示例（在对话中输入）
/commit

做了什么： 读取 git diff、git log，分析变更意图，生成聚焦"为什么"而非"做了什么"的提交信息。

---

/update-config — 配置 Claude Code 行为

修改 settings.json，配置自动化行为（hooks）、权限、环境变量等。

/update-config 每次 Claude 停止时显示耗时
/update-config 允许执行 npm 命令
/update-config 设置 DEBUG=true

重要： 凡是"每次X时自动做Y"的需求，必须用这个 skill 配置 hooks，Claude 的记忆/偏好设置无法实现自动化行为。

---

/simplify — 代码质量审查

审查你改动过的代码，找出重复、低效、可复用的部分并修复。

/simplify

---

/save-conversation — 保存对话

将当前对话导出为文件，支持 Markdown、JSON、HTML、纯文本。

/save-conversation
/save-conversation 保存为 HTML 格式

---

/claude-api — 调用 Claude API

专门用于构建基于 Claude API / Anthropic SDK 的应用。

触发条件： 代码中有 import anthropic 或用户明确要求使用 Claude API。

/claude-api 帮我写一个流式输出的聊天机器人

---

/loop — 定时循环执行

在指定间隔内重复运行某个命令，适合轮询、监控场景。

/loop 5m /commit          # 每 5 分钟自动提交
/loop 10m 检查部署状态    # 每 10 分钟检查一次（默认 10m）

仅用于周期性任务，一次性任务不要用这个。

---

/keybindings-help — 自定义快捷键

修改 ~/.claude/keybindings.json，重新绑定按键。

/keybindings-help 把提交键改为 Ctrl+Enter
/keybindings-help 添加一个和弦快捷键

---

常用工作流示例

场景 1：功能开发后提交

你：实现了用户登录功能，帮我提交
Claude：[读取改动、生成 message]
你：/commit

场景 2：配置自动化钩子

你：/update-config 每次工具调用前先检查 git status

场景 3：定期检查 CI

你：/loop 5m 查看最新的 GitHub Actions 状态

场景 4：构建 AI 应用

你：/claude-api 帮我写一个支持多轮对话的 CLI 聊天工具

---

权限与安全

• 本地可逆操作（读写文件、运行测试）：Claude 会直接执行
• 高风险操作（force push、删除分支、外部发布）：Claude 会先询问确认
• 通过 /update-config 可以预先授权特定命令，避免每次确认

---

记忆系统

Claude Code 有持久化记忆，存储在 ~/.claude/projects/ 下：

类型	用途
user	你的角色、偏好、技术背景
feedback	你给过的指导（避免重复纠正）
project	项目背景、目标、决策
reference	外部资源指针（Linear、Grafana 等）

你：记住我是后端工程师，不熟悉 React
你：忘掉关于部署流程的记录

---

快捷键

操作	快捷键
中断当前操作	Ctrl+C
退出	Ctrl+D 或 /exit
清空上下文	/clear
切换快速模式	/fast
查看帮助	/help

---

最佳实践

1. 自动化需求用 /update-config — 不要指望"记住每次帮我做X"，要配 hooks
2. 提交用 /commit — 比手写 message 更规范，聚焦变更意图
3. 代码写完跑 /simplify — 防止过度工程化
4. 长对话用 /save-conversation — 重要决策存档备查
5. 遇到问题先说背景 — Claude 会结合项目记忆给出更准确的建议