要让claudecode成为ai工作台核心,必须启用behavior_driven: true开关并定义行为yaml文件;通过claude-code bind绑定路径,支持本地/全局作用域;覆盖默认行为可通过同名文件优先、环境变量强制或修改default_behavior字段实现。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让ClaudeCode真正成为你代码工程的AI工作台核心,必须通过行为驱动引擎把它的响应逻辑、上下文约束和执行边界明确固化下来,而不是依赖每次手动提示词微调。
准备ClaudeCode本地运行环境
确认已安装支持`claude-code`命令行工具的Python 3.10+环境,且`~/.claude/config.yaml`存在。若不存在,运行claude-code init生成默认配置——这一步跳过会导致后续所有行为定义无法加载。
打开配置文件,找到engine:区块,在其下新增behavior_driven: true字段并保存。该开关【必须在首次定义行为前启用,否则所有behavior/*.yml文件将被忽略】。
编写行为定义YAML文件
在项目根目录新建behavior/文件夹,内部创建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 --behavior code_review --scope local。此命令会在当前目录生成.claude-behavior-link隐藏文件,记录行为ID与路径的映射关系。
第三步:验证绑定效果——在src/utils/下执行claude-code review,输出应仅包含该目录内Python文件的Ruff和Mypy检查结果;若在项目根目录执行同一命令,则触发全局范围检查。
这一步操作不可逆:【删除.bind文件不会自动解绑,必须用claude-code unbind显式解除】。
覆盖默认系统级行为
方法一:在~/.claude/behavior/下放置同名YAML(如debug.yml),新文件会自动优先于内置版本生效。
方法二:设置环境变量CLAUDE_BEHAVIOR_OVERRIDE=1后启动CLI,此时所有行为定义强制从当前工作目录的behavior/读取,跳过用户主目录配置。
方法三:直接修改~/.claude/config.yaml中的default_behavior字段,填入你自定义的behavior名称(如code_review),下次无参数运行claude-code即默认执行该行为。











