快速查找命令、配置和常见问题解决方案
💡 使用说明
这是一个快速参考指南，当你忘记某个命令或需要查找某个操作时，可以快速在这里找到答案。
A.1 安装速查表
| 软件 |
下载地址 |
验证命令 |
| Python（可选） |
python.org |
python --version |
| Node.js |
nodejs.org |
node --version |
| Git |
git-scm.com |
git --version |
| Claude Code |
npm install -g @anthropic-ai/claude-code |
claude --version |
A.2 命令速查表
启动命令
| 操作 |
命令 |
| 启动（当前目录） | claude |
| 启动（指定目录） | claude /path/to/dir |
| 只读模式 | claude --read-only |
| 危险模式 | claude --dangerous |
| 系统级权限 | claude --allow-system-wide |
斜杠命令
| 类别 |
命令 |
功能 |
| 对话 | /new | 新建对话 |
| 对话 | /clear | 清空对话历史 |
| 对话 | /history | 查看历史记录 |
| 对话 | /exit | 退出 Claude Code |
| 模式 | /plan | 进入 Plan 模式 |
| 模式 | Shift+Tab | 切换权限模式（快捷键） |
| 帮助 | /help | 显示帮助信息 |
| 帮助 | /status | 查看当前状态 |
| 帮助 | /config | 查看配置信息 |
| 帮助 | /permissions | 查看/更新权限设置 |
| 帮助 | /doctor | 检查安装健康状态 |
A.3 提示词模板速查
| 场景 |
提示词模板 |
| 理解代码 |
请帮我理解 [文件名]：这是什么？结构如何？怎么运行？ |
| 修改文件 |
请修改 [文件名]：目标 [描述]，约束 [不要做什么] |
| 处理数据 |
请处理 [文件]：清洗、分析、生成报告 |
| 整理文件 |
请整理 [文件夹]：按类型分类，移动到对应文件夹，生成清单 |
| 生成文档 |
请根据 [内容] 生成 [类型] 文档，格式要专业 |
| Git 存档 |
请 Git 存档当前状态，提交信息写 [描述] |
A.4 Git 速查
用 Claude Code 操作 Git，不需要记命令！
| 操作 |
告诉 Claude |
| 初始化 Git | 请帮这个文件夹初始化 Git |
| 创建存档 | 请 Git 存档，信息写 "xxx" |
| 查看历史 | 请显示 Git 历史记录 |
| 查看差异 | 请显示修改了什么内容 |
| 回退版本 | 请回退到上一个版本 |
| 恢复文件 | 请从 Git 恢复 xxx 文件 |
| 放弃修改 | 请放弃所有未提交的修改 |
A.5 MCP 速查
配置文件位置
~/.claude/mcp-servers.json
常用 MCP 列表
| MCP |
用途 |
安装包 |
| filesystem | 访问任意文件 | @modelcontextprotocol/server-filesystem |
| git | 增强 Git | @modelcontextprotocol/server-git |
| postgres | PostgreSQL | @modelcontextprotocol/server-postgres |
| sqlite | SQLite | @modelcontextprotocol/server-sqlite |
| fetch | 获取网页 | @modelcontextprotocol/server-fetch |
| brave-search | 网页搜索 | @modelcontextprotocol/server-brave-search |
A.6 SKILL 速查
| 项目 |
路径/命令 |
| SKILL 位置 | ~/.claude/skills/ |
| 创建 SKILL | 在 skills 目录下创建文件夹 |
| SKILL 结构 | skill.json + prompt.md |
| 使用 SKILL | /技能名 参数 |
A.7 常见问题速查
安装问题
| 问题 |
解决方案 |
| npm 命令找不到 |
重新安装 Node.js，确保勾选 "Add to PATH" |
| Python 命令找不到 |
重新安装 Python，确保勾选 "Add Python to PATH" |
| claude 命令报错 |
检查 npm 全局路径，重新安装 Claude Code |
| Mac 提示权限不足 |
使用 sudo npm install -g @anthropic-ai/claude-code |
使用问题
| 问题 |
解决方案 |
| Claude 不回答 |
检查 API Key 配置，确认网络连接 |
| 不能修改文件 |
检查是否在只读模式，重新启动时不要使用 --read-only 参数 |
| 不知道当前模式 |
输入 /status 查看 |
| 如何退出 |
输入 /exit 或按 Ctrl+C |
A.8 权限决策树
你要做什么？
│
├─ 只是看看/学习
│ → claude --read-only
│ 最安全，完全不会修改文件
│
├─ 修改自己的文件
│ → claude （默认）
│ 最常用，安全且有保护
│
├─ 修改很多文件/批量操作
│ → claude --dangerous
│ 方便但危险，要有备份
│
└─ 需要操作多个文件夹
→ claude --allow-system-wide
权限很大，谨慎使用
A.9 学习路线图
零基础入门路线
- 第01章：环境安装（50分钟）
- 第02章：命令详解（40分钟）
- 第03章：Git 存档（45分钟）
进阶学习路线
- 第04章：实战场景（60分钟）
- 第05章：提示词模板（35分钟）
- 第06章：MCP 扩展（50分钟）
- 第07章：SKILL 技能（40分钟）
实战项目路线
- 第09章：需求先行（60分钟）
- 第10章：开发流程（90分钟）
- 自己完成一个实际项目
A.10 快速参考
说明
进度只保存在你当前浏览器（localStorage）。换电脑/换浏览器会丢失，建议导出备份。
键盘快捷键
| 快捷键 |
功能 |
Ctrl + C | 退出 Claude Code |
Ctrl + D | 退出 Claude Code |
Ctrl + L | 清屏 |
↑ / ↓ | 浏览历史命令 |
环境变量
| 变量 |
用途 |
ANTHROPIC_API_KEY | Anthropic 官方 Key（部分版本/场景使用） |
ANTHROPIC_AUTH_TOKEN | Anthropic 兼容 Token（国内转发/第三方常用，如智谱） |
ANTHROPIC_BASE_URL | API 端点地址（不同服务商不同） |
API_TIMEOUT_MS | 超时（毫秒），网络慢时可适当调大 |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 减少非必要网络请求（可选） |
配置文件位置
| 配置 |
位置 |
| 全局配置 | ~/.claude/settings.json |
| 项目配置 | .claude/settings.json |
| MCP 配置 | ~/.claude/mcp-servers.json |
| SKILLS 目录 | ~/.claude/skills/ |