必须配置HTTP/HTTPS代理才能打通网络链路,因企业内网、校园网或代理环境下无法直连codebuddy.tencentcloudapi.com,导致“Network Error”“Request timeout”等报错。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

CodeBuddy在企业内网、校园网或使用代理上网的环境中常因无法直连腾讯云API服务(如codebuddy.tencentcloudapi.com)而报错“Network Error”“Request timeout”或“ECONNREFUSED”,此时需显式配置HTTP/HTTPS代理才能打通网络链路。
确认当前网络是否需要代理
打开终端,执行curl -v https://codebuddy.tencentcloudapi.com/health。若返回Failed to connect或卡在Trying 100.100.100.100...阶段,且你所在环境明确要求走代理(如公司IT策略、教育网出口限制),则必须配置代理;若直接返回HTTP_PROXY与HTTPS_PROXY环境变量,这是最稳定、覆盖最全的配置路径。
第一步:确认代理地址格式。常见形式为http://127.0.0.1:7890(Clash)、http://127.0.0.1:1080(V2Ray)或企业代理如http://proxy.corp.com:8080。注意协议必须是http://,即使代理本身支持HTTPS,环境变量中也不能写https://。
第二步:在Shell配置文件中写入变量。Linux/macOS用户编辑~/.bashrc或~/.zshrc,追加两行:
export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
Windows用户以管理员身份运行PowerShell,执行:
[Environment]::SetEnvironmentVariable("HTTP_PROXY", "http://127.0.0.1:7890", "User")
[Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://127.0.0.1:7890", "User")
第三步:重载配置并验证。Linux/macOS执行source ~/.zshrc(或对应shell文件);Windows重启终端。随后运行echo $HTTPS_PROXY(macOS/Linux)或echo %HTTPS_PROXY%(Windows),确认输出为你设置的地址。
【关键前提】代理服务必须已启动并监听对应端口,否则CodeBuddy仍会报连接拒绝。可用curl -x http://127.0.0.1:7890 https://httpbin.org/ip测试代理连通性。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
方法二:IDE插件内单独配置(仅限VS Code / JetBrains)
当无法修改系统环境变量(如受限账户、多代理切换需求),可在插件设置页直接填入代理地址,该配置优先级高于系统变量,且只影响当前IDE实例。
VS Code用户:打开设置(Ctrl+,)→ 搜索codebuddy proxy → 找到CodeBuddy: Proxy URL选项 → 输入完整代理地址,例如http://127.0.0.1:7890。
JetBrains用户:Settings → Plugins → Tencent Cloud CodeBuddy → Configure → 填入Proxy URL字段,格式同上。
注意:此字段仅接受URL格式,不支持用户名密码认证的代理(如http://user:pass@host:port)。若代理需鉴权,请改用方法一并在环境变量中填写带凭据的URL。
方法三:CLI专用配置(仅对codebuddy命令生效)
若只用CLI执行codebuddy chat或codebuddy generate等指令,可绕过系统变量,直接在项目级配置中固化代理。
进入项目根目录,执行:mkdir -p .codex && echo 'HTTP_PROXY=\"http://127.0.0.1:7890\"' > .codex/.env。
CodeBuddy CLI启动时会自动加载.codex/.env中的变量,且该文件不会被Git追踪(建议将其加入.gitignore)。
这一步操作起来很简单,直接把文件拖进去就行。

















