ClaudeCode使用教程（MacOS）

1. 下载claude code

zsh 复制代码

brew install --cask claude-code

2. 下载cc switch

zsh 复制代码

brew install --cask cc-switch

配置国产模型deepSeek

打开CCSwitch，点击右上角的加号，选择deepseek，去官网获取API Key，并充值，回到CCSWitch后，点击添加

3.claude code基础操作

在命令行使用claude打开claude code
通过shfit+tab进行模式切换，常见模式如下：
- ? for shortcuts 默认模式，每次创建文件或修改文件会询问用户
- accept edits on 自动模式，接受所有编辑，后续用户无需手动确认
- plan mode on 规划模式，主要用来探讨复杂方案，只聊天不执行
使用!切换zsh命令行
使用shift+enter换行，但如果终端输入文本很多，建议使用control+g打开文本编辑器(默认打开的是vim，可以在vscode里设置安装命令行打开)
claude code认为执行终端命令是一个危险的操作，所以执行的时候会争得用户同意。但claude code提供了一个跳过权限的选项，在启动的时候带上这个选项(不建议开启)
zsh 复制代码
```
claude --dangerously-skip-permissions
```
使用control+b将任务置于后台，使用/tasks可以查看任务列表
使用/rewind或连续两次按下esc会进入回滚选项，但是只能回滚写入的文件，不能回滚指令，建议使用git回滚
使用control+v粘贴图片
连续两次按下control+c或使用/exit退出claude code
使用/resume，或者在启动时加上 -c参数claude -c，退出再进入claude code能继续之前的对话
使用/compact进行上下文压缩，使用control+o可以看到压缩后的上下文，再按contro+o可以回到之前的页面，在上下文过长时建议压缩
使用/clear可以清空所有的上下文
使用/init命令，可以让claude code自己生成claude.md
使用/memory命令，可以方便的打开claude.md文件

4. MCP

安装mcp，如安装figma mcp(bash命令行输入，非claude输入)
zsh 复制代码
```
claude mcp add --transport http figma https://mcp.figma.com/mcp
```
使用/mcp，查看当前已经安装的mcp，在选择完mcp后可以看到相应的功能；或者我们让Claude code自己去识别调用相应的mcp

5. Hook(钩子)

通过配置setting文件进行hook配置：

setting文件有几个级别，这套体系就像 Git 的配置一样，让团队协作和个性化定制都有了清晰的规范。因为 Hook 本质上就是 settings.json 文件中 "hooks" 对象里的一个配置项

项目级: 路径为 <项目根目录>/.claude/settings.json。通常需要提交到版本控制系统，供整个团队共享。
全局级: 路径为 ~/.claude/settings.json，存放在你的用户目录下，用于个人通用配置。
本地覆盖: 路径为 <项目根目录>/.claude/settings.local.json，用于在项目内做不提交的个性化配置。

例如：

json 复制代码

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "/path/to/your-script.sh"
          }
        ]
      }
    ]
  }
}

这段 JSON 配置的作用是：在 Claude 完成一次 Edit（编辑）工具的调用后，自动执行你指定的 Shell 脚本

6. skilll

在用户路径下创建一个skills文件夹

zsh 复制代码

mkdir -p ~/.claude/skills

在skills下可以创建各种技能，可以通过/具体技能来使用，比如我们在skills文件夹下新增了daily-report技能，则可以通过/daily-report来使用该技能，也可以通过大模型识别来调用相关技能

7. subAgent

创建agent的流程

使用/agents
选择 Create new agent
可以通过/agent打开agent列表，选择对应的subAgetn，也可以通过大模型识别来调用相关子agent

skill和subAgent的主要区别是上下文处理方式不同：

skill运行时会完全继承并且共享主对话上下文，适合处理与上下文关联比较大，对上下文影响小的任务，以此避免token消耗过大，Claude code处理过慢的问题

subAgent有自己的独立的上下文，当使用subAgent时会开启一个全新的对话窗口，中间所有的过程不会回传到主agent中，只有subAgent执行完了才会拿着最终结果给到主agent，适合处理与上下文关联比较小，对上下文影响大的任务

8. Plugin

使用/plugin打开插件市场，可以安装其他开发者的插件

有些plugin包函了MCP、hook、skill、subAgent等所有能力

参考视频

【Claude Code 从 0 到 1 全攻略：MCP / SubAgent / Agent Skill / Hook / 图片 / 上下文处理/ 后台任务】 https://www.bilibili.com/video/BV14rzQB9EJj/?share_source=copy_web\&vd_source=3c9e4c525626aaebdf340eb966f54b56