如何更好的使用 Claude Code
一、安装
macOS / Linux / WSL:
bash
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
powershell
irm https://claude.ai/install.ps1 | iex
Windows CMD:
cmd
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
提示:如果你在 PowerShell 中看到
The token '&&' is not a valid statement separator,说明你在 PowerShell 而不是 CMD 中。如果看到'irm' is not recognized,说明你在 CMD 中。PowerShell 提示符显示PS C:\,CMD 显示C:\。
其他安装方式:
- Homebrew:
brew install --cask claude-code(不自动更新,需手动brew upgrade claude-code) - WinGet:
winget install Anthropic.ClaudeCode(不自动更新) - Linux 包管理器: 支持 apt、dnf、apk(Debian、Fedora、RHEL、Alpine)
安装完成后,进入项目目录启动:
bash
cd your-project
claude
二、键盘快捷键
| 快捷键 | 功能 |
|---|---|
Ctrl+J |
换行(不提交) |
Ctrl+G |
打开文本编辑器编辑多行输入 |
Shift+Tab |
切换 Plan Mode / Permission Mode |
Escape |
取消当前生成或清空输入 |
Ctrl+C |
取消/中断 |
↑ / ↓ |
浏览输入历史 |
Ctrl+A |
选中所有内容(粘贴网页内容到 CC 时很有用) |
Tab / Shift+Tab |
切换选项 |
运行 /terminal-setup 可配置终端集成(如 Shift+Enter 换行)。 运行 /vim 可切换 Vim 键绑定模式。
三、核心 Slash 命令速查
会话管理
| 命令 | 功能 |
|---|---|
/exit 或 /quit |
退出 Claude Code |
/resume |
查看并恢复历史会话 |
/clear |
清空当前对话,重新开始 |
/rewind |
回滚到上一个工具调用或对话节点 |
/cost |
查看当前会话的 token 用量和费用 |
/status |
查看当前会话状态(模型、权限等) |
配置与模型
| 命令 | 功能 |
|---|---|
/model |
切换模型(Opus / Sonnet / Haiku) |
/config |
修改设置(主题、模型、权限等) |
/permissions |
查看和管理工具权限 |
/effort |
调整思考强度(low / medium / high / max) |
/compact |
手动压缩对话上下文(节省 token) |
开发工作流
| 命令 | 功能 |
|---|---|
/init |
初始化 CLAUDE.md 文件(分析代码库生成) |
/memory |
编辑 CLAUDE.md 文件 |
/review |
代码审查 PR |
/verify |
验证代码变更是否正确工作 |
/loop |
定时循环执行命令(如 /loop 5m /foo) |
/copy |
将 Claude 最后一次回复复制到剪贴板 |
诊断与调试
| 命令 | 功能 |
|---|---|
/doctor |
诊断 Claude Code 安装状态 |
/debug |
启用调试日志 |
/usage |
查看速率限制使用情况 |
/stats |
查看使用统计(GitHub 风格活跃图) |
高级功能
| 命令 | 功能 |
|---|---|
/mcp |
管理 MCP 服务器连接 |
/agents |
查看和管理后台 Agent |
/skills |
查看可用 Skills |
/plugins |
管理插件 |
/hooks |
查看/配置 Hooks |
/tasks |
查看后台任务 |
/chrome |
切换 Chrome 浏览器集成 |
认证与更新
| 命令 | 功能 |
|---|---|
/login |
登录 Anthropic 账号 |
/logout |
登出 |
/upgrade |
检查并安装更新 |
四、CLI 命令行参数
bash
# 启动交互会话
claude
# 带初始提示启动
claude "explain this project"
# 非交互模式(打印结果后退出)
claude -p "explain this function"
# 管道输入
cat file | claude -p "query"
tail -200 app.log | claude -p "Slack me if you see any anomalies"
# 继续上次对话
claude -c
# 恢复指定会话
claude -r "auth-refactor" "Finish this PR"
# 后台运行
claude --bg "investigate the flaky test"
# 指定模型
claude --model claude-sonnet-4-6
# 设置权限模式
claude --permission-mode plan
claude --dangerously-skip-permissions # 跳过所有权限检查(危险!)
# 进入 worktree 隔离环境
claude -w feature-auth
# 远程控制
claude --remote-control "My Project"
# 自定义系统提示
claude --append-system-prompt "Always use TypeScript"
# 限制最大花费
claude -p --max-budget-usd 5.00 "query"
# 查看版本
claude -v
五、CLAUDE.md --- 项目记忆系统
CLAUDE.md 是 Claude Code 的持久化指令系统,每次会话开始时自动加载。
文件位置(优先级从高到低):
| 文件 | 作用域 | 说明 |
|---|---|---|
~/.claude/CLAUDE.md |
全局 | 所有项目通用指令 |
CLAUDE.md(项目根目录) |
项目级 | 项目特定指令 |
.claude/CLAUDE.md |
项目级 | 备选位置 |
子目录中的 CLAUDE.md |
子目录级 | 特定目录指令 |
最佳实践:
/init一键生成 :进入新项目后运行/init,Claude 会分析代码库并生成 CLAUDE.md- 每次会话结束时更新:告诉 Claude "把新发现添加到 CLAUDE.md",保持知识库最新
- 提交到 Git:不要把 CLAUDE.md 加入 .gitignore,团队共享这些知识
- 保持简洁:过长的 CLAUDE.md 会浪费每次对话的 token
- 定期清理:删除过时的指令
示例内容:
markdown
# 项目说明
## 架构
- Next.js 14 App Router
- PostgreSQL + Prisma ORM
- NextAuth.js 认证
## 常用命令
- `npm run dev` --- 启动开发服务器
- `npm test` --- 运行测试
- `npm run build` --- 生产构建
## 规范
- 使用 TypeScript 严格模式
- 组件放 src/components/
- API 路由放 src/app/api/
- 优先使用命名导出
六、Skills --- 可复用的提示词模板
Skills 是存储在 Markdown 文件中的可复用提示词模板,按需加载(比 CLAUDE.md 更节省 token)。
文件位置:
~/.claude/skills/--- 用户级(全局可用).claude/skills/--- 项目级
创建自定义 Skill:
markdown
---
name: my-skill
description: 简要描述这个 skill 的功能
---
# Skill 指令
当这个 skill 被激活时,Claude 需要遵循的详细步骤:
1. ...
2. ...
3. ...
Skill vs CLAUDE.md:
- CLAUDE.md:每次对话都加载,适合项目基本信息
- Skills:按需加载,适合特定工作流(更节省 token)
使用方式:
- 手动调用:输入
/skill-name - 自动触发:Claude 根据上下文自动匹配并加载
七、Hooks --- 自动化钩子
Hooks 在 Claude Code 执行特定操作时自动触发 shell 命令。
配置位置: ~/.claude/settings.json 或 .claude/settings.json
Hook 事件类型:
| 事件 | 触发时机 |
|---|---|
PreToolUse |
工具执行前(可修改或阻止) |
PostToolUse |
工具执行后 |
Notification |
通知时 |
Stop |
Claude 停止生成时 |
配置示例:
json
{
"hooks": {
"PostToolUse": [
{
"matcher": "Write",
"hooks": [
{
"type": "command",
"command": "prettier --write $CLAUDE_FILE_PATH"
}
]
}
],
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "echo 'Claude finished working'"
}
]
}
]
}
}
实用 Hook 场景:
- 每次写文件后自动格式化(prettier / eslint --fix)
- 每次提交前自动运行 lint
- 上下文超过 85% 时自动提示压缩
- 任务完成时发送通知
八、MCP 服务器 --- 外部工具集成
MCP(Model Context Protocol)让 Claude Code 能连接外部数据源和工具。
添加 MCP 服务器:
bash
# CLI 方式
claude mcp add my-server npx -y @modelcontextprotocol/server-filesystem /path/to/dir
# 查看所有已配置的服务器
claude mcp list
# 移除服务器
claude mcp remove <name>
settings.json 方式:
json
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
},
"slack": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-slack"],
"env": {
"SLACK_TOKEN": "..."
}
}
}
}
配置范围:
~/.claude/settings.json--- 用户级(所有项目可用).claude/settings.json--- 项目级(团队共享).claude/settings.local.json--- 本地级(不提交到 Git)
懒加载 MCP 工具(节省 token):
json
{
"env": {
"ENABLE_TOOL_SEARCH": "true"
}
}
九、Agents --- 自主任务执行器
Agents 是可以独立运行的 Claude Code 实例,处理子任务并返回结果。
类型:
- Subagents:由主 Claude 派生,并行处理子任务
- Background Agents:长时间运行的后台任务
- Worktree Agents:在隔离的 git worktree 中独立工作
使用场景:
- 并行处理多个独立任务
- 后台运行测试套件
- 自动化代码审查
- 多步骤迁移任务
后台运行:
bash
claude --bg "investigate the flaky test"
十、Plugins --- 插件系统
Plugins = Skills + Agents + MCP + Hooks 的打包方案。
管理插件:
bash
# 查看已安装插件
/plugins
# CLI 管理
claude plugin install code-review@claude-plugins-official
配置启用:
json
{
"enabledPlugins": {
"frontend-design@claude-plugins-official": true
}
}
十一、权限管理
权限模式:
- Default:默认模式,危险操作需确认
- Plan:先规划再执行
- Auto:自动批准大部分操作
- BypassPermissions :跳过所有检查(
--dangerously-skip-permissions,慎用!)
配置允许的命令:
json
{
"permissions": {
"allow": [
"Bash(npm test)",
"Bash(npm run build)",
"Bash(git log *)",
"Bash(git diff *)",
"Read",
"Glob",
"Grep"
],
"deny": [
"Bash(rm -rf *)",
"Bash(sudo *)"
]
}
}
建议使用
/fewer-permission-prompts技能自动分析你的使用习惯并生成允许列表。
十二、Plan Mode --- 先规划再动手
按 Shift+Tab 或输入 /plan 进入规划模式。
工作流程:
- Claude 先阅读和分析代码库
- 呈现修改方案(修改哪些文件、为什么改、怎么改)
- 你审核并批准/修改方案
- 只有批准后才执行变更
适用场景:
- 复杂重构任务
- 多文件变更
- 架构决策
- 需要先审核方案的场景
十三、Git Worktrees --- 并行分支开发
Worktree 让多个 Claude Agent 在同一个仓库的不同目录中独立工作。
bash
# 创建 worktree 并开始工作
claude -w feature-auth
# 也可以指定 PR
claude -w #123
优势:
- 并行开发无冲突
- 每个 Agent 独立实验
- 每个 worktree 可单独审查和合并
十四、高级技巧
1. 主动压缩上下文
不要等自动压缩,主动管理上下文:
把当前计划写入 HANDOFF.md,包含:已尝试的方案、成功和失败的经验,下一个 agent 读取这个文件就能继续工作。
然后开一个新对话,只给路径:HANDOFF.md
2. 容器化长时间任务
对于有风险的长时间任务,使用 Docker 容器隔离:
bash
# 在容器中运行 Claude Code
docker run -it claude-code claude --dangerously-skip-permissions "your task"
3. 语音输入
使用本地语音转文字工具(如 superwhisper、MacWhisper)配合 Claude Code,打字速度大幅提升。
4. 会话 Fork
bash
# 从当前会话分叉出新会话
/fork
# 或从命令行
claude -c --fork-session
5. 自定义状态栏
可以自定义底部状态栏显示模型、目录、git 分支、token 用量等信息。
6. 管道组合
bash
# 分析日志
tail -200 app.log | claude -p "Slack me if you see any anomalies"
# CI 自动翻译
claude -p "translate new strings into French and raise a PR"
# 批量安全审查
git diff main --name-only | claude -p "review these changed files for security issues"
7. 环境变量配置
json
{
"env": {
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"DISABLE_AUTOUPDATER": "1",
"ENABLE_TOOL_SEARCH": "true"
}
}
8. 审计已批准的命令
定期检查 ~/.claude/settings.json 中的权限配置,移除不再需要的 allow 规则。
9. 多终端标签页并行
同时运行多个 Claude Code 实例,每个处理不同任务。建议不超过 3-4 个并行任务。
10. 搜索历史对话
bash
# 对话存储位置
~/.claude/projects/-Users-xxx-projects-project-name/*.jsonl
# 搜索特定关键词
grep -l -i "keyword" ~/.claude/projects/-*/*.jsonl
十五、settings.json 完整配置参考
json
{
"env": {
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"DISABLE_AUTOUPDATER": "1",
"ENABLE_TOOL_SEARCH": "true"
},
"permissions": {
"allow": [
"Bash(npm test)",
"Bash(npm run build)",
"Bash(git *)",
"Read",
"Glob",
"Grep"
],
"deny": [
"Bash(rm -rf *)"
]
},
"hooks": {
"PostToolUse": [
{
"matcher": "Write",
"hooks": [
{
"type": "command",
"command": "prettier --write $CLAUDE_FILE_PATH"
}
]
}
]
},
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
}
},
"enabledPlugins": {
"frontend-design@claude-plugins-official": true
},
"attribution": {
"commit": "",
"pr": ""
}
}
十六、常用工作流速查
| 场景 | 做法 |
|---|---|
| 接手新项目 | /init 生成 CLAUDE.md → 阅读理解 → 开始工作 |
| 会话结束 | "把新发现添加到 CLAUDE.md" → /exit |
| 复杂任务 | /plan → 审核方案 → 执行 |
| 并行开发 | claude -w feature-name 创建 worktree |
| 后台任务 | claude --bg "task description" |
| 恢复会话 | claude -c(上次)或 claude -r(选择) |
| 代码审查 | /review 或 gh pr view <number> |
| 粘贴网页内容 | 浏览器 Ctrl+A 全选 → 复制 → 粘贴到 CC |
| 长对话管理 | 主动 /compact 或写 HANDOFF.md 后开新会话 |
| 定时检查 | /loop 5m /check-deploy |
参考资源: