Claude Code 快速上手指南

是什么

Claude Code 是 Anthropic 官方的命令行 AI 编程助手。直接在终端里和它对话，让它帮你写代码、改 bug、重构、查代码库。

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

基本用法

直接输入自然语言就行，比如：

> 帮我看看这个项目的目录结构
> 修复 utils.py 里的那个 bug
> 给 login 接口加参数校验

它有权限控制，执行危险操作（删文件、推送代码）前会问你确认。

常用斜杠命令

命令以 / 开头，随时可输入：

命令	作用
`/help`	查看所有可用命令
`/status`	查看版本、模型、登录状态
`/clear`	清空对话，重新开始
`/compact`	压缩对话上下文，释放空间（对话太长时用）
`/cost`	查看本次会话花了多少钱
`/model`	切换模型（Opus / Sonnet / Haiku）
`/init`	在当前项目生成 CLAUDE.md 配置文件
`/memory`	编辑 CLAUDE.md，给项目添加持久记忆
`/config`	设置主题、输出格式等偏好
`/permissions`	管理工具权限规则
`/diff`	查看当前未提交的改动
`/review`	审查 PR
`/doctor`	诊断安装是否正常
`/resume`	恢复之前的对话

快捷键

快捷键	作用
`Esc`	中断当前生成
`Ctrl+C`	取消当前输入
`Ctrl+D`	退出 Claude Code
`Tab`	自动补全
`↑ / ↓`	浏览历史输入
`Shift+Tab`	切换权限模式
`Ctrl+G`	用外部编辑器写 prompt（写长需求时好用）

Skills（技能）

Skills 是可扩展的自定义命令，本质上是放在特定目录下的 SKILL.md 文件。Claude Code 自带了一些内置 skill（如 /review、/simplify），你也可以安装社区或自己写。

查看 & 使用

/skills — 列出当前所有可用 skills
直接输入 /<skill名称> 即可调用，比如 /review
某些 skill 会根据对话上下文自动触发，无需手动输入

安装 Skills 的三种方式

方式一：GitHub 下载，手动粘贴

从 GitHub 上把 skill 文件夹下载下来，直接复制到 skills 目录即可：

# 全局安装（所有项目可用）
cp -r 下载的skill文件夹 ~/.claude/skills/

# 项目级安装（仅当前项目，可 Git 提交共享给团队）
cp -r 下载的skill文件夹 .claude/skills/

方式二：npx skills 命令行安装（社区生态）

社区维护的命令行工具，一条命令搞定安装和管理：

# 安装社区 skill
npx skills add vercel/frontend-design

# 从 GitHub 仓库中安装特定 skill
npx skills add anthropics/skills --skill document-skills

# 静默安装（跳过交互确认）
npx skills add <仓库> --skill <名称> -g -y

# 管理已安装的 skills
npx skills list       # 查看已安装
npx skills update     # 更新
npx skills remove <名> # 删除

-g 表示安装到全局（所有项目可用），不加则仅当前项目。安装时会提示选择 AI 工具（选中 Claude Code 即可）。

技能市场：skills.sh — 5 万+ 可复用技能

方式三：自己手写

每个 skill 就是一个文件夹，核心是里面的 SKILL.md 文件：

~/.claude/skills/my-skill/
├── SKILL.md          # 必需：技能定义
├── scripts/          # 可选：辅助脚本
└── resources/        # 可选：资源文件

SKILL.md 格式示例：

---
name: my-skill
description: 一句话描述，用于 Claude 自动匹配触发
---

## 使用步骤
1. 第一步做什么
2. 第二步做什么

写好放到 ~/.claude/skills/（全局）或 .claude/skills/（仅当前项目），重启 Claude Code 即可使用。

注意事项

项目级 > 全局级：同名 skill，项目级优先
Skills 是"教模型怎么做事"（行为规范），MCP 是"给模型工具"（能力供给），两者不同但互补
从非可信来源安装前，建议看一眼 SKILL.md 内容，确认没有恶意指令

几个核心概念（一句话版）

CLAUDE.md — 项目级配置文件，告诉 Claude 这个项目的约定和规则，类似 .cursorrules
Memory — 自动记忆你的偏好和项目上下文，下次对话也能用
Hooks — 在特定事件（工具调用前后）自动执行的脚本
MCP Servers — 连接外部工具（数据库、API 等）的协议，扩展 Claude 的能力
settings.json — 权限、环境变量等底层配置

新手建议

不知道问什么就 /help，上面列了所有命令
对话太长时 /compact，不然会变慢变贵
项目根目录跑一下 /init，生成 CLAUDE.md 后 Claude 会更懂你的项目
写长需求用 Ctrl+G，打开编辑器慢慢写比在终端里敲舒服
大胆用自然语言描述，不需要写得很精确，它理解能力很强
@文件名 可以在 prompt 里直接引用文件，比如 @src/main.py 帮我重构这个文件