腾讯员工调试接口需通过iOA SSO认证，绑定工号与组织架构，登录后自动注入X-iOA-Auth头，Token有效期4小时并支持静默刷新。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯员工在CodeBuddy中调试接口时，需通过企业统一身份认证体系接入iOA（内部办公自动化系统），确保权限与上下文安全合规。该流程不依赖个人微信或手机号，而是绑定工号与组织架构信息，调用接口前必须完成iOA凭证的自动注入与校验。
确认iOA认证已启用
打开CodeBuddy IDE插件底部状态栏的「CB」图标 → 点击「设置」→ 查看「认证源」是否显示「iOA SSO」且状态为「已启用」。若未出现该选项，说明企业管理员尚未在腾讯统一身份后台开通iOA认证源，此时无法继续后续操作。
【必须由企业管理员在腾讯统一身份管理台开通iOA认证源并关联CodeBuddy应用】
触发iOA登录流程
单击底部「CB」图标 → 选择「登录」→ 在弹出页中仅出现「iOA SSO」选项，点击后自动跳转至企业iOA登录页。
输入内网邮箱（如：zhangsan@tencent.com）→ 输入iOA密码 → 完成二次验证（如短信/令牌/企微扫码）。注意：此处不能使用微信扫码或手机验证码，否则将认证失败并中断调试链路。
验证接口调试权限
登录成功后，在CodeBuddy插件内右键任意API文件（如api/user/get.js）→ 选择「Debug with CodeBuddy」→ 观察底部终端输出：
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 问题
若首行显示[iOA] Auth OK: tencent\zhangsan (Dept: IEGB)，表示iOA上下文已注入；
若提示403 Forbidden: Missing iOA context，说明当前会话未携带iOA票据，需关闭IDE重试或清除~/.codebuddy/cache/auth目录后重新登录。
调试时自动注入iOA Header
进入交互式调试模式后，所有发出的HTTP请求将自动附加以下头信息：
X-iOA-Auth: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
该Token由iOA网关签发，有效期4小时，过期后CodeBuddy会静默刷新——无需手动重登，但首次调试前必须完成上述完整登录流程。
