> **写在前面**：这不是什么教程，就是一个普通开发者踩坑后的经验分享。如果你也在折腾 AI 编程工具，希望能帮到你少走点弯路。

## 先说结论

**Hermes Agent 的 Claude Code 技能，是我用过最舒服的 AI 编程工作流。**

不是因为它最强，而是因为它最"省心"——不用在网页里切来切去，不用复制粘贴代码，直接在终端里告诉它要做什么，然后...就可以去倒杯咖啡了☕

当然，中间也踩过不少坑。今天就把这些经验整理出来，希望能帮到同样在探索 AI 编程的你。

---

## 我为什么需要这个？

说实话，一开始我对"AI 写代码"这事挺怀疑的。

直到有一次，老板让我给一个老项目加单元测试。那个项目有 20 多个文件，每个文件平均 300 行...我当时就想，这得写到什么时候？

后来抱着试试看的心态，用了 Hermes Agent 的 Claude Code 技能。

结果？一下午搞定了。而且测试覆盖率到了 85%+。

那一刻我意识到：**不是 AI 要取代我们，而是会用 AI 的人会取代不会用的人。**

---

## 环境搭建（踩坑预警⚠️）

### 第一步：安装 Claude Code

```bash

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

```

这一步通常没问题，除非你的 npm 源有点问题（你懂的）。

### 第二步：认证

这里有个坑。

**方式一：浏览器 OAuth**（推荐）

```bash

claude auth login

```

会弹浏览器让你登录 Anthropic 账号。Pro/Max 用户选这个。

**方式二：API Key**

```bash

claude auth login --console

```

适合想按量计费的兄弟。

**我一开始用的方式二**，结果发现费用蹭蹭涨...后来才知道 Pro 用户用 OAuth 更划算。

### 第三步：验证

```bash

claude --version

claude doctor

```

如果 `doctor` 说一切正常，那就没问题了。

---

## 两种用法，我一般这样选

### 用法一：Print 模式（最常用）

适合一次性任务，比如：

- 修复某个 bug

- 给几个文件加功能

- 代码审查

```bash

claude -p '给 src/auth 下的所有函数添加错误处理' \

  --allowedTools 'Read,Edit' \

  --max-turns 10

```

**这个模式的好处**：执行完自动退出，不会卡在那里等你输入。适合写脚本或者扔到后台跑。

**参数说明**：

- `--allowedTools`：限制它能用的工具，我一般只给 `Read,Edit`，不让它随便 `Write` 新文件

- `--max-turns`：限制循环次数，防止它陷入死循环（真发生过...）

### 用法二：交互模式（适合复杂任务）

这个需要配合 tmux 使用，因为 Claude Code 是个 TUI 应用。

```bash

# 创建 tmux 会话

tmux new-session -d -s claude-work -x 140 -y 40

# 启动 Claude

tmux send-keys -t claude-work 'cd /path/to/project && claude' Enter

# 发送任务

sleep 5

tmux send-keys -t claude-work '帮我重构这个认证模块，用 JWT' Enter

# 过一会儿看看进度

tmux capture-pane -t claude-work -p -S -50

```

**我一般什么时候用这个？**

- 任务比较复杂，需要多轮对话

- 想实时看它在干什么

- 可能需要中途调整方向

---

## ⚠️ 这几个坑我帮你踩过了

### 坑一：权限对话框

第一次运行或者用了 `--dangerously-skip-permissions` 时，会弹确认对话框。

**关键来了**：第二个对话框的默认选项是"No, exit"，但你其实想选"Yes"！

解决方法：

```bash

tmux send-keys -t claude-work Down && sleep 0.3 && tmux send-keys -t claude-work Enter

```

先按向下键，再按回车。记住这个，不然它会直接退出...

### 坑二：会话续传

有时候任务太大，一次跑不完。怎么续传？

```bash

# 第一次运行时保存 session_id

claude -p '开始重构数据库层' --output-format json --max-turns 10 > session.json

# 提取 session_id

SESSION_ID=$(cat session.json | python3 -c 'import json,sys; print(json.load(sys.stdin)["session_id"])')

# 续传

claude -p '继续，添加连接池' --resume $SESSION_ID --max-turns 5

```

或者更简单，在同一个目录下：

```bash

claude -p '继续上次的工作' --continue

```

### 坑三：后台会话不清理

tmux 会话不会自己消失，跑完记得清理：

```bash

# 查看有哪些会话

tmux list-sessions

# 删除

tmux kill-session -t claude-work

```

我有一次忘了清理，一周后发现有 20 多个会话在跑...

---

## 我常用的几个场景

### 1. 代码审查

```bash

git diff main...feature-branch | \

  claude -p '帮我看看这个 PR 有没有问题，重点看安全和性能' --max-turns 1

```

比等人 review 快多了，而且它真的能发现一些问题。

### 2. 写测试

```bash

claude -p '给 src/api/user.py 写 pytest 单元测试，覆盖率尽量高' \

  --allowedTools 'Read,Write,Bash' \

  --max-turns 10

```

写出来的测试质量还行，至少比我随便写的强😅

### 3. 批量修改

有一次需要把项目里所有的回调改成 async/await，大概 30 多个文件...

```bash

claude -p '把 src/ 下所有回调风格的代码改成 async/await' \

  --allowedTools 'Read,Edit' \

  --max-turns 20

```

跑了一小时，完成了。我检查了一下，90% 以上没问题。

### 4. 查问题

```bash

cat error.log | claude -p '分析这个日志，告诉我可能的原因和解决方法'

```

比我自己看日志快，而且它经常能想到我没想到的角度。

---

## 关于费用

这个大家应该都关心。

我用下来大概的感受：

| 任务类型 | 大概花费 |

|----------|----------|

| 小修改（单文件） | $0.01-0.03 |

| 中等重构（多文件） | $0.05-0.15 |

| 大任务（整个模块） | $0.20-0.50 |

**省钱技巧**：

1. 用 `--max-turns` 限制循环次数

2. 简单任务用 `--model haiku`，便宜很多

3. 用 `--allowedTools` 限制它的能力，避免它做不必要的事

4. 任务描述清楚一点，减少来回沟通的轮数

---

## 一些心得

### 1. 描述要具体

 "优化这个代码"

 "把这个函数的时间复杂度从 O(n²) 降到 O(n)，用哈希表"

越具体，结果越好。

### 2. 不要完全信任

它写的代码我一般都会看一遍，偶尔会有问题。特别是边界条件，AI 容易忽略。

### 3. 让它解释

不确定它为什么这么写的时候，直接问：

```bash

claude -p '解释一下你为什么用这种方式实现'

```

有时候能学到新东西。

### 4. 分而治之

大任务拆成小任务，成功率更高。

比如"重构整个项目"→"先重构 auth 模块"→"再重构 api 模块"

---

## 最后说两句

AI 编程工具不是万能的，但真的能提高效率。

我现在的 workflow 大概是：

1. 小功能/修改 → 直接让 Claude Code 写

2. 复杂功能 → 先让它出方案，我 review 后再写

3. 核心逻辑 → 自己写，让它帮忙 review

**工具是为人服务的，不是人为工具服务。** 找到适合自己的节奏最重要。

---

## 参考资源

- [Hermes Agent 官方文档](https://hermes-agent.nousresearch.com/docs/)

- [Claude Code 文档](https://code.claude.com/docs/)

- 本文的 Markdown 源文件在我桌面上，有需要可以拿去改

---

**如果你有什么 AI 编程的心得或者踩坑经历，欢迎在评论区分享！**

大家一起进步～

---

*2026 年 4 月 写于CSDN*