怎样用ClaudeCode定义AI工作台行为驱动引擎

要让ClaudeCode真正成为代码工程里的AI工作台核心，关键不在于每次手动调整提示词，而是通过行为驱动引擎，把它的响应逻辑、上下文约束和执行边界彻底固化下来。下面说说几个关键步骤。

准备ClaudeCode本地运行环境

先确认本地环境：是否已安装支持claude-code命令行工具的Python 3.10+版本，以及~/.claude/config.yaml这个配置文件是否存在。如果后者不存在，运行claude-code init生成默认配置——这一步如果跳过，后续所有行为定义都无法加载，直接白忙活。

然后，打开配置文件，找到engine:区块，在其下新增beha vior_driven: true字段并保存。必须警惕的是，这个开关

，相当于你写了行为规则，但引擎根本没读。

编写行为定义YAML文件

在项目根目录下新建beha vior/文件夹，然后创建code_review.yml文件。写入以下内容：

name: "PR审查模式"
trigger: "review"
context: ["git diff --cached", "pyproject.toml"]
actions:
- run: "ruff check --select I --diff"
- run: "mypy --show-error-codes ."
- output: "markdown"

这里有个细节：trigger的值必须是单个纯英文单词，不能带空格或符号。它将成为你在CLI中输入claude-code review时激活该行为的唯一关键字，所以命名要简洁、好记。

绑定行为到具体代码路径

第一步：进入你要施加行为约束的子模块目录，比如src/utils/。

第二步：运行claude-code bind --beha vior code_review --scope local。这个命令会在当前目录生成一个.claude-beha vior-link隐藏文件，记录行为ID与路径的映射关系。

第三步：验证绑定效果——在src/utils/下执行claude-code review，输出应该只包含该目录内Python文件的Ruff和Mypy检查结果；如果在项目根目录执行同一命令，则会触发全局范围检查。这一步能直观验证行为生效范围。

注意，这一步操作不可逆：

。所以绑定前最好想清楚。

覆盖默认系统级行为

有三种方式可以覆盖系统默认行为：

方法一：在~/.claude/beha vior/下放置同名YAML文件（比如debug.yml），新文件会自动优先于内置版本生效。这是最直观的方式。

方法二：设置环境变量CLAUDE_BEHA VIOR_OVERRIDE=1后启动CLI，此时所有行为定义强制从当前工作目录的beha vior/读取，跳过用户主目录配置。这种方式适合临时切换或测试场景。

方法三：直接修改~/.claude/config.yaml中的default_beha vior字段，填入你自定义的beha vior名称（比如code_review）。下次无参数运行claude-code时，就会默认执行该行为，省去每次手动指定触发词的麻烦。