CodeBuddy 国际版一直登不上,是入口不对还是网络问题

腾讯云代码助手 CodeBuddy 分国内站和国际站,登录失败里一半是选错入口,一半是浏览器回调或到 codebuddy.ai 的链路不通。下面按公开文档写排查步骤。

先分清两个站。CodeBuddy Code(CLI)首次启动会出登录方式菜单:Chinese Site / International Site / Enterprise Domain / iOA(腾讯内部)。官方对照表写明:Chinese Site 走腾讯云中国站认证,域名是 copilot.tencent.com,面向境内用户、境内主流模型;International Site 走国际站,域名是 codebuddy.ai,面向海外用户、境外主流模型;企业专享/私有化选 Enterprise Domain,填企业给的服务地址。↑↓ 选中后回车,会自动开浏览器做认证。腾讯云国际站文档也写:CodeBuddy Code 首次要用 Log in via International Site,再经 CodeBuddy 官网完成登录。

IDE 侧入口也不一样。国际站文档(codebuddy.ai):官网右上角 Login / Sign Up,注册时选 region,可用 Google、GitHub 或邮箱;装好 IDE 后点 Login,跳浏览器用已注册账号,成功后再回 IDE。国内站文档(codebuddy.cn):个人版常见是微信或手机号;企业旗舰走腾讯统一身份 / SSO。公开页没说过两套账号能用同一个手机号通用。登国际版却走国内的微信登录,或者反过来,先想想是不是选错了站,别急着怀疑密码。

卡在登录页、浏览器没弹出来的,国际站和国内站 FAQ 的说法差不多:选 Open in Browser(在浏览器中打开)再拉一次;或 Copy Link(复制链接),自己打开浏览器粘贴完成验证。CLI 侧腾讯云文档补充:浏览器没自动打开,或页面一直 Waiting for auth…,把终端里打印的登录 URL 复制到地址栏手动完成。插件登录报 timeout of 30000ms exceeded 时,FAQ 步骤是命令面板 >show out → Show Output Channel → 通道选 CodeBuddy → 按日志里的链接/二维码在浏览器完成。别在 IDE 内嵌窗口里干等。

测网络要用国际版域名,国内域名通了不代表国际版也通。Troubleshooting 把国内版/国际版拆开写了:服务连通性用 curl -v https://www.codebuddy.ai(国内对照是 https://copilot.tencent.com);超时再 timeout 30s curl -v ...;看关键词 timeout / certificate / proxy / connection refused。Hosts 解析:检查本机 hosts 有没有把目标域名指错,国际版用 nslookup www.codebuddy.ai(或 dig)。代理:核对 http.proxy、codingcopilot.httpProxySettings、codingcopilot.httpProxyURL;代理可用性示例是 curl -x http://127.0.0.1:8004 -v https://www.codebuddy.ai;代理挂了就先修进程/端口/协议,不需要代理就临时关掉再试。TCP:nc -vz www.codebuddy.ai 443,公司防火墙常拦 443。远程 SSH 登录异常:先确认本机 IDE 能登;远端要有外网;设置里搜 codebuddy.remote.SSH.enableDynamicForwarding,取消勾选(false)后重连,这是官方文档里写的开关。

账号和环境变量也容易出错。CLI 用 API Key 时,身份文档强调必须配对 CODEBUDDY_INTERNET_ENVIRONMENT:海外版默认不设该变量;中国版要 internal;设错会认证失败或打到错误端点。Key 获取地址也分站:海外 https://www.codebuddy.ai/profile/keys,中国 https://copilot.tencent.com/profile/。想换登录方式:slash 命令有 /logout、/login,登出后再选 International Site。FAQ 另有登录地址 404 时改 https://copilot.tencent.com/admin 的条目,那是中国站的说明,国际版别照搬这个 URL。企业 SSO / OneID 按企业在腾讯统一身份里开的方式走,个人 Google/GitHub 账号进不了企业租户是预期行为。

排完仍不行:IDE 可从帮助打开日志文件夹打包;CLI 可 /doctor、/status;邮件文档写可联系 codebuddy@tencent.com(邮箱可能会换,以防万一看下各站 FAQ)。

要自己核对的话看这几页:CLI Installation and Login / Quickstart(登录方式表)、IDE Installation(国际站注册登录)、IDE/插件 Troubleshooting(卡登录、代理、hosts、连通性)、IAM(环境变量与 Key 地址)。产品名和域名还会改,到时候按页面上写的来。

官方文档(写稿时核对过):