如何更好的使用 Claude Code

Claude Code 这个工具，你要是只会用它问几个简单问题，那可真是太亏了。今天咱们把它的看家本领从头捋一遍，从安装到高级技巧，一次给你讲透。

一、安装

macOS、Linux、WSL 一条命令搞定：

curl -fsSL https://claude.ai/install.sh | bash

Windows 用户也有对应方案：

• PowerShell: irm https://claude.ai/install.ps1 | iex
• CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

当然也有其他选择：Homebrew 可以用 brew install --cask claude-code，不过这种方式不会自动更新，得手动 brew upgrade claude-code。WinGet 同理，winget install Anthropic.ClaudeCode 也是一次性安装。Linux 这边就更灵活了，apt、dnf、apk 都支持。

装完之后，进项目目录启动就行：

cd your-project
claude

二、键盘快捷键

运行 /terminal-setup 可以配置终端集成，比如把换行键改成 Shift+Enter。习惯 Vim 的朋友，/vim 一下就能切到 Vim 键绑定模式。

三、核心 Slash 命令速查

会话管理

配置与模型

开发工作流

诊断与调试

高级功能

认证与更新

四、CLI 命令行参数

除了交互式会话，Claude Code 的命令行参数才是真正让它变成自动化利器的关键：

# 启动交互会话
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 Code 的"持久化记忆"，每次会话开始时自动加载。好比你给项目写了一份说明书，Claude 每次开工前都会读一遍。

文件位置按优先级排列：

几个经验：

1. /init 一键生成：进新项目后跑一下 /init，Claude 会自动分析代码库生成一份 CLAUDE.md
2. 每次会话结束时记得更新：告诉 Claude "把新发现添加到 CLAUDE.md"，知识库就不会过期
3. 提交到 Git：别把 CLAUDE.md 扔进 .gitignore，团队共享这些知识才是正解
4. 保持简洁：太长的 CLAUDE.md 每次都加载，token 吃不消
5. 定期清理：过时的指令该删就删

示例内容长这样：

# 项目说明
## 架构
- 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 — 可复用的提示词模板

可以理解为"按需加载的提示词模板库"。跟 CLAUDE.md 不同，Skills 不是你一上来就加载的，而是用到的时候才调取，省 token 是一绝。

文件位置：

• ~/.claude/skills/ — 用户级，全局可用
• .claude/skills/ — 项目级

创建自定义 Skill 的方法：

---
name: my-skill
description: 简要描述这个 skill 的功能
---

# Skill 指令
当这个 skill 被激活时，Claude 需要遵循的详细步骤：
1. ...
2. ...
3. ...

Skill 和 CLAUDE.md 的区别在于：CLAUDE.md 是每次都加载，适合放项目基本信息；Skills 是按需加载，适合特定工作流，更节省 token。

使用方式也灵活：手动输入 /skill-name 调用，或者 Claude 根据上下文自动匹配加载。

七、Hooks — 自动化钩子

Hooks 本质上是在 Claude Code 执行特定操作时自动触发的 shell 命令。配置在 ~/.claude/settings.json 或 .claude/settings.json 里。

支持的事件类型：

配置示例：

{
"hooks": {
"PostToolUse": [
{
"matcher": "Write",
"hooks": [
{
"type": "command",
"command": "prettier --write $CLAUDE_FILE_PATH"
}
]
}
],
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "echo 'Claude finished working'"
}
]
}
]
}
}

实用的几个场景：每次写文件后自动格式化（prettier / eslint --fix）、每次提交前自动跑 lint、上下文超过 85% 时自动提示压缩、任务完成时发个通知。

八、MCP 服务器 — 外部工具集成

MCP 协议让 Claude Code 能连接外部数据源和工具，相当于给它装上了"外接设备"。

添加 MCP 服务器：

# CLI 方式
claude mcp add my-server npx -y @modelcontextprotocol/server-filesystem /path/to/dir

# 查看所有已配置的服务器
claude mcp list

# 移除服务器
claude mcp remove

也可以在 settings.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）。

还有个省 token 的小技巧：懒加载模式。在环境变量里设 ENABLE_TOOL_SEARCH: "true"，MCP 工具就不会一股脑全加载。

九、Agents — 自主任务执行器

Agents 是可以独立运行的 Claude Code 实例，处理子任务并返回结果。分三类：

• Subagents：由主 Claude 派生，并行处理子任务
• Background Agents：长时间运行的后台任务
• Worktree Agents：在隔离的 git worktree 中独立工作

适用场景：并行处理多个独立任务、后台运行测试套件、自动化代码审查、多步骤迁移任务。

后台运行命令：claude --bg "investigate the flaky test"

十、Plugins — 插件系统

Plugins 可以看作是 Skills + Agents + MCP + Hooks 的打包方案。一句话：需要什么功能，装个插件就行。

管理插件：

# 查看已安装插件
/plugins

# CLI 管理
claude plugin install code-review@claude-plugins-official

配置启用：

{
"enabledPlugins": {
"frontend-design@claude-plugins-official": true
}
}

十一、权限管理

Claude Code 的权限模式有四种：

• Default：默认模式，危险操作需确认
• Plan：先规划再执行
• Auto：自动批准大部分操作
• BypassPermissions：跳过所有检查（--dangerously-skip-permissions，慎用！）

可以精细配置允许和禁止的命令：

{
"permissions": {
"allow": [
"Bash(npm test)",
"Bash(npm run build)",
"Bash(git log *)",
"Bash(git diff *)",
"Read",
"Glob",
"Grep"
],
"deny": [
"Bash(rm -rf *)",
"Bash(sudo *)"
]
}
}

十二、Plan Mode — 先规划再动手

按 Shift+Tab 或输入 /plan 进入规划模式。工作流程很清晰：

1. Claude 先阅读和分析代码库
2. 呈现修改方案（改哪些文件、为什么改、怎么改）
3. 你审核并批准/修改方案
4. 只有批准后才执行变更

适用场景：复杂重构、多文件变更、架构决策，以及任何需要先审核方案的场景。

十三、Git Worktrees — 并行分支开发

Worktree 让多个 Claude Agent 在同一个仓库的不同目录中独立工作，互不干扰。

# 创建 worktree 并开始工作
claude -w feature-auth

# 也可以指定 PR
claude -w #123

优势：并行开发无冲突、每个 Agent 独立实验、每个 worktree 可单独审查和合并。

十四、高级技巧

1. 主动压缩上下文

别等自动压缩，主动管理上下文才是最省 token 的方式：

把当前计划写入 HANDOFF.md，包含：已尝试的方案、成功和失败的经验，下一个 agent 读取这个文件就能继续工作。

然后开一个新对话，只给路径：HANDOFF.md。

2. 容器化长时间任务

对于有风险的长时间任务，丢进 Docker 容器里隔离运行：

docker run -it claude-code claude --dangerously-skip-permissions "your task"

3. 语音输入

用本地语音转文字工具（像 superwhisper、MacWhisper）配合 Claude Code，打字速度瞬间起飞。

4. 会话 Fork

# 从当前会话分叉出新会话
/fork

# 或从命令行
claude -c --fork-session

5. 自定义状态栏

底部的状态栏可以自定义显示内容：模型、目录、git 分支、token 用量等。

6. 管道组合

# 分析日志
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. 环境变量配置

{
"env": {
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"DISABLE_AUTOUPDATER": "1",
"ENABLE_TOOL_SEARCH": "true"
}
}

8. 审计已批准的命令

定期检查 ~/.claude/settings.json 里的权限配置，移除那些不再需要的 allow 规则。

9. 多终端标签页并行

同时跑多个 Claude Code 实例，每个处理不同任务。建议别超过 3-4 个并行任务，否则 CPU 先扛不住。

10. 搜索历史对话

# 对话存储位置
~/.claude/projects/-Users-xxx-projects-project-name/*.jsonl

# 搜索特定关键词
grep -l -i "keyword" ~/.claude/projects/-*/*.jsonl

十五、settings.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": ""
}
}

十六、常用工作流速查