高效使用 Claude Code 的综合指南

在 github.dev 中打开 · 在新标签页中打开 github.dev · 在 codespace 中打开

高效使用 Claude Code 的综合指南，采用键盘优先工作流。

重要提示：请先登录，确保获得最佳体验。

1. 登录说明

1. 在终端中打开 Claude Code
2. 按提示登录
3. 选择与您的 Claude 订阅计划绑定的认证方式（而非 API 密钥）
   • 订阅了 Claude Pro 或 Claude Max？请使用 Anthropic 账户登录
   • 这样才能享有订阅的全部权益
4. 运行 /cost 确认登录成功 — 应能看到您的订阅信息

为什么重要：使用订阅计划登录（而非 API）可获得更高限额、更新模型访问权限，Claude Max 用户还无需按请求付费。

按照以下步骤配置 Claude Code，获得最佳开发体验。

最重要的设置：启用 Shift+Enter 提交消息

设置方法：

在 Claude Code 中运行 /terminal-setup，自动配置终端。

手动设置：

1. 打开 Cursor/VS Code 设置
2. 搜索 Terminal > Integrated: Send Keybindings To Shell
3. 取消勾选此选项

备选方案：Shift+Enter 无法使用时，用 \ + ENTER（反斜杠 + 回车）提交。

为什么重要：双手不离键盘，加速与 Claude 的交互。

通过项目根目录下的 .claude/settings.json 自定义 Claude Code 行为。

常用配置：

{
  "model": "claude-sonnet-4-5-20250929",
  "autoApprovalSettings": {
    "enabled": true,
    "patterns": [
      "Read(/Users/yourname/**)",
      "Bash(npm run lint)",
      "Bash(git log:*)"
    ]
  },
  "statusLine": {
    "enabled": true,
    "template": "{{model}} | {{tokens}}"
  }
}

关键配置说明：

• model：选择 Claude 模型
• autoApprovalSettings：自动批准特定工具，加速工作流
• statusLine：在状态栏显示模型和 Token 使用情况
• hooks：配置事件触发的 Shell 命令（见后文）

MCP 服务器（Model Context Protocol，模型上下文协议）为 Claude Code 扩展专业能力。

MCP 服务器功能：

• Supabase：数据库操作、迁移、日志
• Context7：最新库文档
• Time：时区转换与当前时间
• 自定义服务器：构建专属集成

配置方法（.mcp.json）：

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server"
      ]
    },
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@context7/mcp-server"
      ]
    }
  }
}

使用场景：

• 处理数据库 → Supabase MCP
• 需要最新库文档 → Context7 MCP
• 自定义工作流 → 构建专属 MCP 服务器

Hooks 响应事件自动运行 Shell 命令。

常用 Hook：Claude 完成时播放提示音

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "afplay /System/Library/Sounds/Pop.aiff"
          }
        ]
      }
    ]
  }
}

Hook 类型：

• UserPromptSubmit：提交消息时触发
• Stop：Claude 停止响应时触发
• PreToolUse：工具执行前触发（可加匹配器）
• PostToolUse：工具执行后触发（可加匹配器）
• SessionStart / SessionEnd：会话生命周期事件触发
• SubagentStop：子代理停止时触发
• PreCompact：对话压缩前触发
• Notification：通知事件触发

示例：执行前验证 Bash 命令

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 /path/to/validator.py"
          }
        ]
      }
    ]
  }
}

示例：编辑后运行 Lint

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npm run lint"
          }
        ]
      }
    ]
  }
}

Windows/Linux 音效方案：

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "powershell -c (New-Object Media.SoundPlayer 'C:\\Windows\\Media\\Windows Ding.wav').PlaySync()"
          }
        ]
      }
    ]
  }
}

掌握快捷键，双手不离键盘，高效在编辑器、终端和 Claude Code 间切换。

2. 终端管理

*注：这些快捷键需在 Cursor/VS Code 中自定义键位。详见后文自定义键位设置。

3. 文件操作

键盘使用建议：

• 双手保持在键盘中央：使用快捷键，而非伸手够鼠标
• 掌握增量搜索：CMD/CTRL + F 查找，CMD/CTRL + H 查找替换
• 使用面包屑导航：CMD/CTRL + SHIFT + . 浏览文件结构
• 熟练窗格导航：CMD/CTRL + 1/2/3 在拆分编辑器间即时跳转

上述终端管理快捷键需在 Cursor/VS Code 中自定义配置。

自定义键位设置方法：

1. 打开命令面板：CMD/CTRL + SHIFT + P
2. 输入 Preferences: Open Keyboard Shortcuts (JSON)
3. 将自定义键位添加到 keybindings.json

键位示例：

[
  {
    "key": "cmd+shift+c",
    "command": "workbench.action.terminal.newInActiveWorkspace",
    "args": {
      "location": "editor"
    }
  },
  {
    "key": "cmd+shift+r",
    "command": "workbench.action.terminal.rename"
  },
  {
    "key": "cmd+shift+[",
    "command": "workbench.action.terminal.focusPrevious"
  },
  {
    "key": "cmd+shift+]",
    "command": "workbench.action.terminal.focusNext"
  }
]

Windows/Linux 用户：将上述 "cmd" 替换为 "ctrl"。

说明：以上是示例快捷键，请根据偏好自定义。视频演示将展示完整设置过程。

与 Claude Code 协作开发的高效工作流。

Claude Code 输入框文本编辑快捷键：

核心斜杠命令：

ShipKit 模板 附带预置斜杠命令，加速开发工作流。

项目准备命令（启动新项目时按顺序运行）：

开发工作流命令：

数据库命令：

UI/设计命令：

部署与基础设施：

高级/专业命令：

常见开发任务的实用工作流。

在 Claude 协作后审查更改的典型工作流：

1. 打开源代码管理 - CMD/CTRL + SHIFT + G
   • 审查 Claude 的所有文件更改
   • 查看每个文件的 git diff
2. 打开文件资源管理器 - CMD/CTRL + SHIFT + E
   • 导航到要检查的特定文件
   • 浏览项目结构
3. 关闭侧边栏 - CMD/CTRL + B
   • 完成审查后隐藏文件资源管理器以最大化屏幕空间
   • 将焦点返回到代码

此工作流双手不离键盘，让您在提交前高效审查 Claude 的更改。