推荐语

ClaudeCode带你玩转AI编程，从入门到精通只需20元/月，解锁10倍开发效率！

核心内容：
1. ClaudeCode软件介绍与Anthropic公司背景
2. 国内用户低成本安装指南（月费20元方案）
3. 命令行操作技巧与高性价比模型推荐

杨芳贤

53AI创始人/腾讯云(TVP)最具价值专家

今天给大家带来一期ClaudeCode的使用指南，让大家用好AI编程。

每一次都是倾尽所有，把我知道的，看到的，都给大家汇总，整理，总结了，属实不易，希望大家多多支持，点赞、喜欢、加转发关注。

文章分三个部分。

这是我收集国内外所有大神的ClaudeCode的使用指南，最终总结归纳起来的。

包括：各种薅羊毛、性价比套餐、高级技巧、最佳实践、周边插件等。

从入门安装到高级技巧，全都包括了。每一个字都是手打的，没有任何AI生成的内容。

第一部分，简单介绍下这款软件。

第二部分，教大家安装。（国内用户是可以使用的，还会说一下如何低成本使用，一个月20块钱）

第三部分，详细讲解下它的使用技巧。

相信我，读下去，有很多惊喜。

01 

简单介绍

ClaudeCode是国外一家公司Anthropic出品的CLI（命令行界面）的AI编程软件。

也就是说，它是一个命令行界面，你的对话发生在命令行。

可能很多人跟我一样，刚开始一听说命令行，就感觉挺麻烦，觉得没有界面肯定不好用，实际体验下来非常棒，简单，快捷，效率非常高。

之所以这么设计，是因为每个程序员的使用习惯不同，程序员很挑剔，所以开发一个带UI的界面，很多人用的不习惯，也就无法做到统一。

但是，所有程序员基本上都用过命令行，所以，大家都采用了命令行的形式来开发AI编程软件。

同样的命令行编程软件还有阿里的Qwen Code、谷歌的Gemini CLI等。

谈谈Anthropic这家公司

再来说说这家公司，Anthropic这家公司很厉害，但是这个单词挺不常见，所以，我刚开始对它也不感兴趣，只是经常听到。

后来，没办法，这家公司的模型能力实在太顶尖了，不得不去尝试一下，后来发现，真香。

这家公司的CEO Dario Amodei曾是百度的员工，后来就职于OpenAI，再后来自己创建了公司，公司的影响力以及研发大模型能力和OpenAI不相上下。

这里说一句，百度在大模型研发早期还是非常牛的，只是百度一贯的尿性，很多东西做着做着就做黄了，很让人叹息。

ClaudeCode默认使用Anthropic自家模型，比如说：

• Claude Opus 4.1

• Claude Sonnet 4

• Claude Haiku 3.5

这几款模型都是非常牛X的，经常就是性能排名第一第二的，他们家的模型都针对于编程这一任务专门训练，所以编程的效果非常好。

下方是Claude模型对比其他模型在一些任务测试表现上的通过率，能看出来，比其他顶尖的模型也要高出好多。

当然，这些模型都很贵，一个月可能要一二百美金，所以普通开发者很少有用的起的。

所以，我们只能找一些性价比比较高的模型，比方说：Kimi的K2、智谱的GLM4.5。

这几个模型性能都还不错，也很便宜，一个月也就几十块钱。

当然，ClaudeCode这款软件，官方是禁止在中国使用的，由于一些特殊的政策原因，但是我们还是可以绕过去的，非常简单，需要配置两个环境变量就行。

我会在安装部分说明下如何使用国内的模型。

Anthropic调用格式

通常的大模型都是兼容OpenAI的调用格式，但是Anthropic家的模型有自己的调用格式。

因为ClaudeCode使用的正是自家Anthropic调用格式，所以如果谁家的大模型支持Anthropic格式，那它就能无缝对接上ClaudeCode。

如果不支持Anthropic格式，就得通过一个叫做Claude Code Router的软件来做格式转换，这样所有的模型（例如阿里的Qwen系列）都能对接上ClaudeCode，这个放在最后说。

目前，官方支持Anthropic格式的大模型主要有两家，就是上面说的，Kimi的K2、智谱的GLM4.5。

当然，这里说一个大多数人都不知道的细节：

ClaudeCode本身也是一个智能体，它的提示词是Claude团队针对自家的模型特点专门定制的，使用自家的模型效果最好。

这也是我一直以来坚信的一点：专业的提示词并不通用。

每一家的大模型都是自家的数据训练出来的，只有最符合自家训练数据的提示词，才能达到最好的训练效果。

所以，这就引出来一个事，当我们用其他模型来接入ClaudeCode，使用效果实际上会受一点点影响的。

如果这个模型本身能力不差，那么影响较小，如果本身就不怎么样，那效果将会收到比较大的影响。

好在现在模型的能力都还可以，基本上我实际感受，大约有个5%-20%的效果损失差不多。

对于我们的大部分的开发场景，这个损失其实还可以接受，只要你能把你的事描述清楚，效果不会差很多的。

但是，大家要有一个心理预期，就是如果你在ClaudeCode用过两个不同的模型，他们的效果差别可能会很大，这和软件没有关系。

毕竟，人家官方原本就没允许你用别的模型，只是我们用了特殊方法绕过去了。

而且，我正是读过ClaudeCode的提示词之后，又一次被他圈粉了，提示词写的很专业，很好。

与传统的AI编程插件的不同

再来说说和我们之前用过的其他AI编程插件有什么不同。

国内大多数用户都用过通义灵码等IDE插件，那个时候，模型能力还不太行，上下文窗口长度太小，能塞进去的内容很少。

所以，那些插件，基本上就充当了剪切板的功能，不需要复制代码到网页中和大模型对话，也就仅仅是和模型的一次对话。

当然，我不知道现在通义灵码这种IDE插件发展成什么样子了，我已经好久没用了。

ClaudeCode这种算是第二代的编程助手，是在模型能力增强之后，上下文长度增大之后的出来的。

所以，它能够理解的内容是海量的，是能够理解你整个项目文件夹的，并且有了复杂任务和多任务的处理能力，同时拥有很强的自主规划能力。传统的AI编程工具，如代码自动补全，扮演的是被动的“助手”角色，根据开发者输入的上下文提供建议。

而Claude Code则是一种主动的、具备自主性的“合作伙伴”，它能够理解高层次的自然语言指令，并将其转化为一系列具体的、可执行的动作。

它不仅仅是生成代码片段供开发者复制粘贴，而是能够直接编辑文件、运行测试套件、执行构建命令，甚至处理版本控制工作流，如创建Git提交。

这种能力将其从一个“建议引擎”转变为一个真正的“开发伙伴”，能够处理从需求分析到实现、再到验证的端到端工作流程 。开发者的角色也因此从任务的直接“执行者”转变为复杂工程任务的“委托者”。

基本上，你只要把需求跟它说清楚，它是能够按照高级工程师的思路来给你一步步完成这件事，它的能力完全不亚于一个拥有数年工作经验的架构师。

这也是我写这篇文章的主要原因，未来，我们开发者的工作，都会演变成写写需求文档，做一些架构设计，真正的编码工作完全由AI去做。

这不是天方夜谭，这是事实，很多人已经进入了VibeCoding（氛围编程）的编程状态，包括我，每天做的事，就是鞭策大模型给我写代码。

老板鞭策我，我鞭策大模型。

网上流传着这样一句话，说，年度最佳的AI编程Prompt（提示词）是：“你不干，有的是AI干！”。

将来，更进一步，直接从文档，转化成项目代码，也是趋势。Github上就有一个开源项目非常火，叫做Paper2Code，说的就是直接从论文生成代码。

02

安装教程

下面的安装教程都在苹果的Mac系统上进行，Windows上基本上也差不多，没有太多步骤。

快速安装

npm install -g @anthropic-ai/claude-code

只需要这么简单的一条命令（要求Nodejs版本大于等于18），即可全局安装ClaudeCode，安装完成后即可在任何目录下使用。

注（初学者）：npm命令找不到，是因为你没有安装Nodejs。网上搜索Node.js 18安装即可。

使用ClaudeCode

随便找个目录，可以是你的工程根目录，运行claude命令即可对话了。

# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Navigate to your project
cd your-awesome-project

# Start coding with Claude
claude
# You'll be prompted to log in on first use

提示不允许在国内的访问

如果你运行claude命令之后，显示不允许在你的国家或者地区使用，让你登录的。

这是正常的，在简单介绍里面，我们说过它确实不能在国内使用。

但是我们有办法解决，很简单，配置两行环境变量后重新打开claude即可。

国内使用方式

添加环境变量

vi .zshrc

首先，打开新的命令行，新的命令行默认运行目录是用户的Home根目录，也就是类似/Users/xiaoshi这样的目录。

你可以使用pwd目录来获取当前所在的目录。

➜  ~ pwd
/Users/xiaoshi

确定好是在你的用户根目录下之后（不是的话，通过cd命令跳转到），运行这个命令，编辑一下.zshrc文件。

注（新手）：如果你不会使用vi（也就是vim），请搜索相关教程。

我简单说下怎么操作：运行vi之后，按i进入插入模式，复制下面的内容，粘贴后。按esc键，然后输入:wq即可保存并退出。

exportANTHROPIC_BASE_URL=你的模型调用地址
exportANTHROPIC_AUTH_TOKEN=你的APIKEY

这里有人就会问了，我的APIKEY从哪里来呢？

以及这个BASE_URL从哪里来？

这个和你使用的模型有关，具体的去搜一下。

我这里举两个例子，也是大家用的最多的，性价比最高的。

智谱的GLM4.5和Kimi K2。

并不是广告哈，确实这两家性价比很高，是当前比较不错的了。

两家的运营人员看到这篇文章后，记得私聊我打钱！

特别要注意，配置完环境变量后，一定要用source命令，让操作系统重新读取下这个文件，不然不生效。

source .zshrc

然后，重新运行claude命令即可。

配置ClaudeCode使用智谱GLM4.5模型

1. 注册新用户

   注册地址：https://bigmodel.cn/login

2. 充值（可选）

   新用户一般都会赠送一定额度的Token，但是通常会限制速率。

   所以建议还是选择一个比较不错的套餐，套餐都很便宜。

3. 选购套餐（可选）

   选购地址：https://bigmodel.cn/special_area

   建议选择特惠专区的Coding编程套餐，这是专门针对开发者推出的套餐，首月20元，基本上可以算是不限制调用次数。

1. 新建APIKEY

   登录之后访问：https://bigmodel.cn/usercenter/proj-mgmt/apikeys

   新建APIKEY，名字随便起，建完之后，复制APIKEY。

   

2. 配置环境变量

   智谱的模型调用地址是：https://open.bigmodel.cn/api/anthropic

   
   
   exportANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
   exportANTHROPIC_AUTH_TOKEN=你的APIKEY

3. 配置完成后，让命令行窗口重新读取环境变量。（必须操作）

   使用source命令重新读取环境变量。

   弄一次之后，之后就不用动了，开机之后，操作系统默认会读取这个文件。

   
   
   source .zshrc

4. 重新运行claude命令即可完成配置

   如果重新运行，还是不行，还是不让用或者让登录，那就是环境变量复制错了，检查下字符。

配置ClaudeCode使用Kimi的K2模型

1. 注册新用户

   地址：https://platform.moonshot.cn/console

2. 充值（可选）

   注册完了之后打开后月之暗面的个人后台管理系统：https://platform.moonshot.cn/console

   找到账户充值。

   但是强烈建议充值50元及以上，因为他们家的模型有一个调用速率的等级限制，充值50元才能达到一个正常的速率，不然没法用。

   

1. 新建APIKEY

   然后就是新建APIKEY，复制你的APIKEY，名字随便起，这很简单。

   

2. 配置环境变量

   Kimi的模型调用地址是：https://api.moonshot.cn/anthropic/

   
   
   exportANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic/
   exportANTHROPIC_AUTH_TOKEN=你的APIKEY

3. 配置完成后，让命令行窗口重新读取环境变量。（必须操作）

   使用source命令重新读取环境变量。

   弄一次之后，之后就不用动了，开机之后，操作系统默认会读取这个文件。

   
   
   source .zshrc

4. 重新运行claude命令即可完成配置

   如果重新运行，还是不行，还是不让用或者让登录，那就是环境变量复制错了，检查下字符。

使用ClaudeCodeRouter接入OpenAI格式的大模型

如果你不喜欢用上面说的两家模型，你也可以通过ClaudeCodeRouter这个工具来将任何一家支持OpenAI格式的大模型接入ClaudeCode。

比如说Qwen系列和Doubao系列等。

注意：如果下面的ClaudeCodeRouter教程没有用，请在网上搜索最新的信息，或者去ClaudeCodeRouter开源项目找找最新的帮助。

https://github.com/musistudio/claude-code-router

安装命令如下：

npm install -g @musistudio/claude-code-router

其主要功能如下：

• 模型路由: 根据您的需求将请求路由到不同的模型（例如，后台任务、思考、长上下文）。

• 多提供商支持: 支持 OpenRouter、DeepSeek、Ollama、Gemini、Volcengine 和 SiliconFlow 等各种模型提供商。

• 请求/响应转换: 使用转换器为不同的提供商自定义请求和响应。

• 动态模型切换: 在 Claude Code 中使用 /model 命令动态切换模型。

• GitHub Actions 集成: 在您的 GitHub 工作流程中触发 Claude Code 任务。

• 插件系统: 使用自定义转换器扩展功能。

然后运行下面的命令，启动一个ClaudeCodeRouter的页面

ccr ui

然后选择，添加模型供应商，基本上，你只需要填写上APIKEY即可。

这个工具都已经配置好了很多东西，选择模版后，只需要你添加APIKEY，以及输入对应的模型名字，点击添加，然后保存即可。

添加供应商之后，在右侧的路由部分，全部选择刚刚添加上的供应商即可，然后保存并重启。

这里说明一下，ClaudCode为了节省Token消耗，因为不是所有的工作都需要调用最强的模型，不然费用很高。

所以，针对于不同的工作，分别使用不同的模型。

所以，这里可以个性化地选择不同的模型。

这就算配置完成了，使用ccr code来启动ClaudeCode。

注意，这里，只有使用ccr code，才会使用这个ClaudeCodeRouter来启动ClaudeCode，才能用上咱们配置的模型。

可以看到，这里我们使用的模型地址是：http://127.0.0.1:3456，这就说明，我们配置成功了。

接下来就可以正常对话了。

在IDE中使用ClaudeCode增强插件

ClaudeCode本身不依赖于IDE，有命令行的地方就能运行。

但是，他们也针对VS Code和JetBrains家的IDE（如IDEA、Webstorm、PyCharm等）开发了对应的插件。

这个插件能够增强使用体验，和IDE很好地交互，建议大家装上，并在IDE中使用。

下面，以IDEA为例，演示下如何安装，VS Code基本上也差不多。

在IDE中的设置中，找到插件市场，搜索Claude Code，安装即可。（我记得IDEA有版本要求，它会提示你是否需要升级IDEA版本）

安装完之后，就可以在右上角，一键启动Claude Code。

03

详解使用技巧

基本使用

@符号

使用@符号可以用来指定文件。

#符号

使用#符号，可以让ClaudeCode记住某些东西。

比如说：你期望它：“变量命名要体现出具体含义”

!符号

这个符号用来进入bash模式，也就是命令行模式，可以直接运行命令。

让你在会话模式和命令行模式来回切换。

ESC按键中断操作

ClaudeCode在处理任务过程中，如果你觉得不对，想要终止运行，就按ESC即可停止。

然后继续对话。

多行输入

运行 /terminal-setup 为 iTerm2 和 VS Code 终端安装 Shift+Enter 绑定。

安装这个之后，就可以使用Shift+Enter进行换行来，但是仅限这两个终端，在JetBrains IDE中没有用。

全部指令

ClaudeCode有很多指令（官方叫做Commands），输入斜杠，即可上下选择，回车运行，列表如下：

/add-dir                添加一个新的工作目录
/Agents                 管理代理配置
/bashes                 列出和管理后台任务
/clear (reset, new)     清除对话历史并释放上下文
/compact                清除对话历史，但在上下文中保留摘要。可选：/compact [摘要说明]
/config (theme)         打开配置面板
/context                将当前上下文使用情况可视化为彩色网格
/cost                   显示当前会话的总成本和持续时间
/doctor                 诊断并验证您的 Claude Code 安装和设置
/exit (quit)            退出 REPL
/export                 导出当前对话到文件或剪贴板
/feedback (bug)         提交关于 Claude Code 的反馈
/help                   显示帮助和可用命令
/hooks                  管理工具事件的钩子配置
/ide                    管理 IDE 集成并显示状态
/init          _           使用代码库文档初始化一个新的 CLAUDE.md 文件
/install-github-app     为代码仓库设置 Claude GitHub Actions
/login                  使用您的 Anthropic 帐户登录
/logout                 从您的 Anthropic 帐户注销
/MCP                    管理 MCP 服务器
/memory                          编辑 Claude 内存文件
/migrate-installer               从全局 npm 安装迁移到本地安装
/model                           设置 Claude Code 的 AI 模型
/output-style                    直接或从选择菜单设置输出样式
/output-style:new                创建一个自定义输出样式
/permissions (allowed-tools)     管理允许和拒绝工具的权限规则
/pr-comments                     从 GitHub 拉取请求中获取评论
/release-notes                   查看发行说明
/resume                          继续一个对话
/review                          审查一个拉取请求
/security-review           完成对当前分支上待定更改的安全审查
/status                    显示 Claude Code 状态，包括版本、模型、帐户、API 连接和工具状态
/statusline                设置 Claude Code 的状态行用户界面
/terminal-setup            安装 Shift+Enter 换行快捷键
/todos                     列出当前的待办事项
/upgrade                   升级到 Max 以获得更高的速率限制和更多的 Opus 模型使用权
/vim                       在 Vim 和普通编辑模式之间切换
/zcf:bmad-init             /bmad-init 命令 (project, gitignored)
/zcf:feat                  用于新增功能开发的命令，支持完整的开发流程和工具集成 (project, gitignored)
/zcf:git-cleanBranches     安全查找并清理已合并或过期的 Git 分支，支持 dry-run 模式与自定义基准/保护分支 (project, gitignored)
/zcf:git-commit            仅用 Git 分析改动并自动生成 conventional commit 信息（可选 emoji）；必要时建议拆分提交，默认运行本地 Git 钩子（可 --no-verify 跳过） (project, gitignored)
/zcf:git-rollback          交互式回滚 Git 分支到历史版本；列分支、列版本、二次确认后执行 reset / revert (project, gitignored)
/zcf:workflow              专业AI编程助手，提供结构化六阶段开发工作流（研究→构思→计划→执行→优化→评审），适用于专业开发者 (project, gitignored)

常用指令解释

这里特别说明几个比较常用的指令。

/init

这个指令是基于你的项目目录中的文档和代码文件，让大模型给你的项目生成一个CLAUDE.md文件，这个文件能够在之后的会话中起到重要的作用。

这个文档会从整体上理解这个项目的内容、构成、技术栈等，将帮助未来的 Claude Code 实例更高效地理解和操作这个代码库。

所以，这个命令有利于代码生成更符合你的项目实际情况。

/compact

这个指令用来压缩之前的对话历史，保留关键的信息。

因为在ClaudeCode处理过程中会进行大量的代码分析，这些代码都会放到模型的上下文中，Token消耗量很大。

上下文占用越多，也会影响生成的效果。

所以，为了节省Token，也为了保证连续工作后的使用效果，ClaudeCode会进行自动的上下文压缩，到达阈值之后就会触发。

它是利用大模型来进行摘要总结，保证摘要的内容能够保留关键的东西，从而不会太影响下一次的会话。

这个命令是让你手动地进行压缩，相当于你触发了压缩机制。

这个命令后面还可以空格加上你自己的压缩要求，你需要保留那些信息你可以写上。

不过一般情况下，人家写的压缩提示词就够用了，除非有很小的细节要求保留，你可以提。

/clear

清除指令，顾名思义，用来清除历史会话和上下文的。

运行之后，相当于开启一个新的会话。和你直接开启一个新的ClaudeCode效果是一样的。

/resume

这个指令用来恢复历史会话。

你可以看到之前发起过的对话，回车即可恢复，然后继续这个历史会话进行提问。

/memory

记忆指令，用来定制化你的编码需求。

比方说：你希望它的编码风格是什么样子的，按照你自己的风格来，你可以在这几个位置选择一个文件在这里面添加上你的要求。

官方默认支持七种记忆，如下：

比方说，ClaudeCode所使用的语言、个性、编码规则、技术要求、MCP服务要怎么使用等。

凡是在~/.claude目录下的，都属于全局的记忆，对于所有的工程都生效。

也就是说，ClaudeCode所谓的记忆，都是一些规则。

这也是ClaudeCode的用户提示词之一，也就是说，每次运行，ClaudeCode都会加载并使用这些提示词作为自己的上下文。

所以这些文件内容的对代码生成的影响还是挺大的。

最后一个是Project Memory，是仅仅针对于当前项目的，对其他项目没有影响。所以这个md文件也是放在当前工程的根目录下的。

我们找一个rules.md来看一下。

你的任务是：**审查、理解并迭代式地改进/推进一个[项目类型，例如：现有代码库 / 软件项目 / 技术流程]。**

在整个工作流程中，你必须内化并严格遵循以下核心编程原则，确保你的每次输出和建议都体现这些理念：

- **简单至上 (KISS):** 追求代码和设计的极致简洁与直观，避免不必要的复杂性。
- **精益求精 (YAGNI):** 仅实现当前明确所需的功能，抵制过度设计和不必要的未来特性预留。
- **坚实基础 (SOLID):**
  - **S (单一职责):** 各组件、类、函数只承担一项明确职责。
  - **O (开放/封闭):** 功能扩展无需修改现有代码。
  - **L (里氏替换):** 子类型可无缝替换其基类型。
  - **I (接口隔离):** 接口应专一，避免"胖接口"。
  - **D (依赖倒置):** 依赖抽象而非具体实现。
- **杜绝重复 (DRY):** 识别并消除代码或逻辑中的重复模式，提升复用性。
- **文档同步 (Doc Sync):** 代码变更必须同步更新相关文档，保持一致性。

**请严格遵循以下工作流程和输出要求：**

1.  **深入理解与初步分析（理解阶段）：**

    - 详细审阅提供的[资料/代码/项目描述]，全面掌握其当前架构、核心组件、业务逻辑及痛点。
    - 在理解的基础上，初步识别项目中潜在的**KISS, YAGNI, DRY, SOLID**原则应用点或违背现象。

2.  **明确目标与迭代规划（规划阶段）：**

    - 基于用户需求和对现有项目的理解，清晰定义本次迭代的具体任务范围和可衡量的预期成果。
    - 在规划解决方案时，优先考虑如何通过应用上述原则，实现更简洁、高效和可扩展的改进，而非盲目增加功能。

3.  **分步实施与具体改进（执行阶段）：**

    - 详细说明你的改进方案，并将其拆解为逻辑清晰、可操作的步骤。
    - 针对每个步骤，具体阐述你将如何操作，以及这些操作如何体现**KISS, YAGNI, DRY, SOLID**原则。例如：
      - "将此模块拆分为更小的服务，以遵循 SRP 和 OCP。"
      - "为避免 DRY，将重复的 XXX 逻辑抽象为通用函数。"
      - "简化了 Y 功能的用户流，体现 KISS 原则。"
      - "移除了 Z 冗余设计，遵循 YAGNI 原则。"
    - 重点关注[项目类型，例如：代码质量优化 / 架构重构 / 功能增强 / 用户体验提升 / 性能调优 / 可维护性改善 / Bug 修复]的具体实现细节。

4.  **总结、反思与展望（汇报阶段）：**
    - 检查是否需要更新文档（README、CHANGELOG、API文档等）。
    - 提供一个清晰、结构化且包含**实际代码/设计变动建议（如果适用）**的总结报告。
    - 报告中必须包含：
      - **本次迭代已完成的核心任务**及其具体成果。
      - **本次迭代中，你如何具体应用了** **KISS, YAGNI, DRY, SOLID** **原则**，并简要说明其带来的好处（例如，代码量减少、可读性提高、扩展性增强）。
      - **遇到的挑战**以及如何克服。
      - **下一步的明确计划和建议。**%

自定义指令

ClaudeCode允许你自定义一些指令来运行。

如果你有经常要做的一些工作，你可以把它写到一个markdown里面，最终做成一个自定义指令。

你就可以使用这个指令，让大模型干你所指定的工作。

举个例子：

如果你希望让大模型为你生成一个代码ChangeLog，也就是版本变更记录。

你可以写到一个md文件中，文件名就是你的指令名，然后把这个文件移动到~/.claude/commands/目录下，就可以在ClaudeCode中使用这个命令。

记得要重启ClaudeCode哈，已经打开的ClaudeCode页面没法实时加载新的指令。

cp add-changelog.md ~/.claude/commands/

下面是我运行这个add-changelog指令的效果：

可以看到，它真的基于Git提交记录和现有的Changtlog文件，生成了版本变更记录，而且非常详细。

有的人会说，这个自定义指令这么强，我不会写啊，看着好复杂。

没关系，现在就有这样一个网站收录了大量好用的指令，直接下载导入即可。

这个网站就是https://www.buildwithclaude.com/

到目前为止，已经收录了174+个指令，快去试试吧。

强烈建议大家给个关注，我这收录了很多好东西，大家多多帮忙点赞、在看、转发支持一下吧。

整理真的太不容易了，这些东西，网上都是很零碎的教程，甚至自己找很难找到，我的文章都花了我很大的精力，希望大家多多支持。

细心的小伙伴已经看到了上面截图中的另一个特性，Subagents，就是我们接下来要将的子代理系统。

这个网站上也有大量的已经配置好的子智能体供你挑选。

子Agent系统

子代理系统，顾名思义，就是ClaudeCode有一个主智能体。

它还开发了一套子智能体系统，让主智能体可以动态地调用各个子智能体，来完成更复杂的任务。

或者说是，把子任务分配给更专业的智能体去处理。

然后，主智能体再整理汇总。

同时，这也提高了问题的解决效率，因为子智能体的工作是并行的。

可以想象一下，如果你的工作涉及到前后端，甚至UX设计，那么你就可以先将这几个角色分别注册成智能体。

然后，直接把需求丢给主智能体，这样从UX设计到前端实现，再到后端实现，都可以一次性完成。

听起来是不是非常的Nice？

你可以自定义子智能体，说白了，就是写提示词，让它干活，并且给他一个描述。

这个子智能体的子描述是用来告诉主智能体，它能干什么。

让大模型给你创建子Agent

我们使用/agents可以看到所有的Agents。

然后选择Create new agent。

可以将该Agent定义为项目Agent，只有这个项目可以使用。

也可以定义为用户Agent，全局可用。

然后选择使用Claude来创建，也就是让大模型根据你的要求来自动生成一个Agent。

比如说这里我说：一个UX设计师，然后它就开始生成。

然后问我要给这个Agent配备哪些工具，直接Continue就行，默认就是全部工具都选中。

使用模型选择第一个就行，对于咱们来说，咱只接入了一个模型，实际上使用其他模型伪装成了Claude Sonnet模型。

颜色，随便选。

然后它就生成了，如果它生成的提示词你很满意，按回车即可保存。如果不满意，就可以自己接着他的编辑，按e开始编辑。

然后我们来使用一下我们刚刚创建的UX设计师的Agent。

只要你的提问中，能够让它觉得需要调用UX设计师来工作即可。

可以看到，主智能体调用了设计师来工作。

并且设计师，真的给出了设计。

然后主智能体就开始继续工作，开始编码了。

当然，这里你也可以设计一个专业的前端子智能体，或者说是跟你编码习惯一样的子智能体，给人的感觉好像真的就是你写的代码一样。

第一次给我的结果，运行报错了，把错误给他，他很快就找到原因解决了。

最终的效果是这样的。

说实话，这个效果已经非常不错了。如果想要更好的效果，肯定要在提示词上面多下点功夫。

就连手机端也做了完美适配。

细心的朋友们，已经看到了，他的工作，其实是有一个任务列表的，我们叫做TodoList。

他在接到用户的问题时，会将问题理解，先出一个规划，然后按照规划里的任务列表执行。

每完成一个任务，都会打勾，是不是很像咱们的工作方式。

这也是ClaudeCode最吸引我的地方，很专业。

从其他地方导入子Agent

依旧是这个网站：https://www.buildwithclaude.com/

收录了117个子Agent。

网站上也教你怎么导入了，下面给我大家举个例子，就两步，下载和移动。

比如下面这个后端架构师的例子：

注册方式也很简单，和自定义指令一样，也是把这个子智能体的md文件，移动到对应的文件夹下就可以。

不过这次的文件夹是agents目录。

cp backend-architect.md ~/.claude/agents/

然后重启ClaudeCode就行。

我们使用/agents指令，可以列出当前所有的Agent，其中就有我们刚刚添加上的backend-architect。

我们还可以看到这里分两类agents，一类是用户自建的，一类是ClaudeCode自带的。

这样，就完成了注册。

钩子系统（Hooks）

前端的小伙伴可能非常熟悉钩子系统。

就是某个事件发生之后，触发了你注册的一个函数。

ClaudeCode也有这样的东西。

hooks 的示例用例包括：

• 通知：自定义当 Claude Code 等待您的输入或运行某些内容的权限时如何获得通知。

• 自动格式化：在每次文件编辑后对 .ts 文件运行 prettier，对 .go 文件运行 gofmt 等。

• 日志记录：跟踪和计算所有执行的命令以进行合规性检查或调试。

• 反馈：当 Claude Code 生成不符合您代码库约定的代码时提供自动反馈。

• 自定义权限：阻止对生产文件或敏感目录的修改。

举个实际场景，你希望ClaudeCode每次生成代码之后，都自动进行代码格式化，以保持代码的美观性。

那就可以用到这个钩子系统，配置也相当简单。

编辑后自动格式化 TypeScript 文件：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|MultiEdit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | { read file_path; if echo \"$file_path\" | grep -q '\\.ts$'; then npx prettier --write \"$file_path\"; fi; }"
          }
        ]
      }
    ]
  }
}

配置好后，重启ClaudeCode，之后它就会在每次编辑完成后，触发这个钩子，自动运行这个Command命令。

所以，如果你有其他的需求，也可以执行任意命令。

我们可以运行/hooks指令来查看所有的hooks事件。

这里再给大家分享一个好用的工具。

利用AI来帮我生成对应的Hooks配置。

你只要说明你想要做什么，它就能给你生成。

这个工具叫做claudecode-rule2hook：https://github.com/zxdxjtu/claudecode-rule2hook

用这个就可以自然语言写hook了！

配置MCP Server

添加本地Stdio MCP Server

# 基本语法
claude mcp add <name> <command> [args...]

# 实际示例：添加 Airtable 服务器
claude mcp add airtable --envAIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server

添加SSE MCP Server

# 基本语法
claude mcp add --transport sse <name> <url>

# 实际示例：连接到 Linear
claude mcp add --transport sse linear https://mcp.linear.app/sse

# 带认证头的示例
claude mcp add --transport sse private-api https://api.company.com/mcp \
  --header"X-API-Key: your-key-here"

添加HTTP服务器

# 基本语法
claude mcp add --transport http <name> <url>

# 实际示例：连接到 Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 带 Bearer 令牌的示例
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header"Authorization: Bearer your-token"

管理MCP Server

# 列出所有配置的服务器
claude mcp list

# 获取特定服务器的详细信息
claude mcp get github

# 删除服务器
claude mcp remove github

# （在 Claude Code 中）检查服务器状态
/mcp

更改ClaudeCode设置

提示词技巧

XML 标签结构化提示

Claude 对结构化语言比较敏感，使用类似 XML 的分块格式，可以显著提升提示词的清晰度与可控性。推荐使用如下结构：

<instruction>
你希望 Claude 执行的主要任务或目标
</instruction>

<context>
任务的背景信息，比如涉及的框架、业务逻辑、团队规范等
</context>

<code_example>
可以参考的代码片段、接口规范或已有实现
</code_example>

这种写法能帮助 Claude 更准确地区分“你要它做什么”和“你提供了哪些辅助信息”，避免它把背景当成目标来执行。

三种工作模式切换

ClaudeCode一共有三种模式：自动接受模式、计划模式和正常模式。

一般情况下，使用Claude Code是正常模式。

普通模式下，它可以编辑文件，但是需要经过用户的批准。

如果你不想被打扰，十分信任他的话，你可以把编辑权限、命令权限全都交给他，所有操作默认批准。

通过Shift+Tab，来循环切换三种模式。

模式一：正常模式

模式二：自动接受模式

模式三：计划模式

计划模式下，是先要做规划，不能做执行操作。

回退历史

双击ESC回退会话

双击ESC可以选择回退到当前对话的某句话。

当然，这个回退，只能回退对话，代码变动无法撤销，估计后续官方可能会支持。

可以配合/resume指令来恢复到任何会话中的某一句。

有一个开源工具，可以回退ClaudeCode的代码更改。

叫做ccundo：https://github.com/RonitSachdev/ccundo

npm install -g ccundo

ClaudeCode可视化配置工具opcode

上面所说的基本上所有的配置工作，都可以通过这个可视化工具来整。

包括工具使用权限、钩子事件、自定义指令，甚至是查看对话和可视化使用ClaudeCode。

网站：https://opcode.sh/

Claude官方中文指南

https://docs.claude.com/zh-CN/docs/claude-code/hooks

这里，贴一个ClaudeCode官方的指南，东西非常的全，国内也可以访问，有中文。

04

结语

好了，朋友了，今天的分享到此结束了。

还是希望朋友们多多点赞、喜欢、转发一下，希望大家多给我一些动力支持，我才能继续更新下去。

每一次都是倾尽所有，把我知道的，看到的，都给大家汇总，整理，总结了，属实不易，希望大家多多支持。

感谢大家。