CodeBuddy调试接口必须启用沙箱模式隔离生产环境，步骤为：进入API调试→点击目标接口调试→切换环境为沙箱；沙箱生效后响应含"sandbox_mode": true；未接入沙箱网关的接口切换无效；需手动添加X-CodeBuddy-Env: sandbox请求头或使用沙箱签发Token；Mock规则须配置匹配沙箱Header才生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在CodeBuddy中调试接口时，若直接连接生产环境或真实后端服务，可能因误操作触发真实订单、扣款、消息推送等不可逆行为，必须通过沙箱隔离测试流量与真实系统。
启用内置沙箱模式
第一步：打开CodeBuddy左侧导航栏，点击【API调试】→进入当前项目下的接口列表。
第二步：在目标接口右侧操作栏，点击「调试」按钮，页面顶部会出现环境选择下拉框，默认为「生产」。
第三步：将环境切换为【沙箱】——此时所有请求自动路由至预置的隔离网关，响应体中的data字段会携带"sandbox_mode": true标识，用于确认生效。
注意：沙箱模式仅对已接入CodeBuddy沙箱网关的接口生效；未配置沙箱路由的接口切换后仍走默认通道，不会报错但不具隔离性。
手动注入沙箱Header
方法一：在请求Headers区域添加键值对：
Key：X-CodeBuddy-Env
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
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数据；否则 fallback 到真实后端（若沙箱网关未拦截）。
