先说几个核心判断：在CodeBuddy中调试接口，最怕的就是误操作触发了真实的生产环境——订单生成、扣款执行、消息推送，这些都是不可逆的。必须用沙箱把测试流量和真实系统彻底隔离开，确保接口调试的安全性与可靠性。

具体应该怎么做？下面分步骤说明沙箱配置方法。

启用内置沙箱模式

第一步，打开CodeBuddy的左侧导航栏，找到【API调试】功能入口，进入当前项目所关联的接口列表页面。

第二步，在目标接口右侧的操作栏中，点击「调试」按钮。页面顶部会显示一个环境选择下拉框，默认设置为「生产」环境。

第三步，将当前环境切换为【沙箱】。切换后，所有发出的请求都会自动路由到预置的隔离网关。如何确认切换是否生效？请查看响应体中的data字段，它会携带一个"sandbox_mode": true的标识——如果看到这个标记，说明配置正确。

这里有一个关键点需要留意：沙箱模式仅对已经接入CodeBuddy沙箱网关的接口有效。如果接口本身没有配置沙箱路由，即使切换了环境也不会报错，但实际请求仍会走默认通道，无法实现真正的隔离效果。

手动注入沙箱Header

除了切换环境，还可以通过手动方式为请求添加沙箱标记。这里提供两种常用方法。

方法一：在请求Headers区域添加一组自定义键值对——Key设置为X-CodeBuddy-Env，Value填写sandbox。

方法二：如果你使用的是Bearer Token认证，务必确保该Token由沙箱授权中心签发。生产环境下的Token在沙箱环境中会被直接拒绝，返回403状态码，并附带"reason": "token_not_valid_in_sandbox"的提示信息。

这一步不可省略：沙箱相关Header必须在请求发送前完成设置。如果你中途修改了Header后再重发请求，之前已发出的旧请求仍会按原始环境执行——系统不会回溯修正已经发出的请求。

绑定沙箱Mock规则

进入该接口的「Mock配置」标签页，点击「新建规则」按钮。规则类型选择「沙箱专用」，然后在「匹配条件」中填写headers.X-CodeBuddy-Env === "sandbox"。

接着，在响应模板中可以自由定义JSON数据结构。例如，可以模拟支付成功但金额固定为0.01元，或者返回特定错误码来模拟风控拦截场景。

关键点在于：只有当请求同时满足「环境为沙箱」和「命中此Mock规则」两个条件时，系统才会返回Mock数据。否则，会回退到真实后端接口（前提是沙箱网关没有拦截该请求）。