跳过主要内容
如果您在公司代理或防火墙后工作，您需要为 Cline 配置代理设置才能连接到 AI 提供商。配置因您使用的 Cline 版本而异。

​
VSCode 扩展程序

VSCode 扩展程序自动使用 VSCode 内置的代理设置。有关如何在 VSCode 中设置代理的说明，请参阅Visual Studio Code 中的网络连接，代理服务器支持。Cline 本身不需要额外的配置。

​
CLI

Cline CLI 使用标准的 HTTP 代理环境变量。在运行 cline 命令之前配置这些变量。

​
基本配置

Windows（命令提示符） 
set https_proxy=http://proxy.company.com:8080
set http_proxy=http://proxy.company.com:8080
cline start
Windows（PowerShell） 
$env:https_proxy="http://proxy.company.com:8080"
$env:http_proxy="http://proxy.company.com:8080"
cline start
macOS/Linux 
export https_proxy=http://proxy.company.com:8080
export http_proxy=http://proxy.company.com:8080
cline start

​
带身份验证的代理

如果您的代理需要身份验证，请在 URL 中包含凭据 
export https_proxy=http://username:password@proxy.company.com:8080
export http_proxy=http://username:password@proxy.company.com:8080
将凭据存储在环境变量中可能会有安全风险。

​
绕过本地主机的代理

要防止本地主机流量通过代理，请设置 no_proxy 环境变量： Windows
set no_proxy=localhost,127.0.0.1,.local
macOS/Linux 
export no_proxy=localhost,127.0.0.1,.local

​
自定义证书颁发机构

如果您的代理使用自定义 CA 证书： Windows
set NODE_EXTRA_CA_CERTS=C:\path\to\ca-certificate.crt
cline start
macOS/Linux 
export NODE_EXTRA_CA_CERTS=/path/to/ca-certificate.pem
cline start

​
永久配置

为避免每次都设置这些变量，请将它们添加到您的 shell 配置文件或系统环境变量中。 macOS/Linux（添加到 ~/.bashrc、~/.zshrc 或 ~/.profile）：
# Proxy configuration
export https_proxy=http://proxy.company.com:8080
export http_proxy=http://proxy.company.com:8080
export no_proxy=localhost,127.0.0.1,.local
export NODE_EXTRA_CA_CERTS=/path/to/ca-certificate.pem
Windows（系统环境变量）
  1. 在 Windows 设置中搜索“环境变量”
  2. 在“用户变量”或“系统变量”下添加变量
  3. 重新启动终端或 IDE

​
已知限制

Cline CLI 仅支持 HTTP 代理。它不支持 SOCKS 代理、代理自动配置 (PAC) 脚本，或需要基本用户名和密码以外身份验证的 HTTP 代理。

​
JetBrains IDE

JetBrains 插件使用 IDE 的 HTTP 代理设置。

​
配置 JetBrains 代理

  1. 打开设置/首选项
    • Windows/Linux: 文件 > 设置
    • macOS: IntelliJ IDEA > 首选项
    • 或按 Ctrl+Alt+S (Windows/Linux) 或 Cmd+, (macOS)
  2. 导航到 
    Appearance & Behavior > System Settings > HTTP Proxy
  3. 选择“手动代理配置”
  4. 配置您的代理
    • 主机名: proxy.company.com
    • 端口号: 8080
    • 不使用代理的主机: localhost,127.0.0.1
    • 如果需要，勾选“代理身份验证”
    • 输入您的用户名和密码
  5. 点击“检查连接”以验证设置
  6. 点击“确定”应用
  7. 重新启动 IDE

​
测试连接

配置代理后，测试 Cline 是否可以连接到您的 AI 提供商
  1. 打开 Cline 面板
  2. 尝试发送一条简单消息
  3. 如果连接失败，请检查 IDE 的事件日志以获取错误消息

​
自定义证书颁发机构

如果您的代理使用自定义 CA
  1. 将证书添加到系统的信任存储区，或者
  2. 将其导入到 JetBrains IDE 中
    • 设置 > 工具 > 服务器证书
    • 点击“+”添加您的证书

​
已知限制

JetBrains 中的 Cline 仅支持 HTTP 代理。它不支持 SOCKS 代理、代理自动配置 (PAC) 脚本，或需要基本用户名和密码以外身份验证的 HTTP 代理。 Cline 不会动态获取更改的代理设置。更改代理设置后，请重新启动 IDE 以使 Cline 使用新设置。

​
故障排除

​
连接超时

如果您遇到连接超时
  1. 验证您的代理地址和端口是否正确
  2. 检查代理是否需要身份验证
  3. 确保 AI 提供商的 API 端点未被您的防火墙阻止

​
SSL/TLS 证书错误

如果您看到与证书相关的错误
  1. 检查 NODE_EXTRA_CA_CERTS 是否指向正确的证书文件
  2. 确保证书文件为 PEM 格式
  3. 使用 curl 验证证书是否有效，例如：curl -x proxy.corp.example:8080 --cacert /path/to/ca-cert.pem -o - -vv https://api.cline.bot/
  4. 考虑在 VSCode 中禁用 http.proxyStrictSSL（不建议用于生产环境）

​
测试代理配置

如果您遇到 Cline 网络问题，请首先使用 curl 验证您的代理配置是否有效 
# Linux/macOS
export https_proxy=http://proxy.company.com:8080
curl -vv https://api.anthropic.com

# Windows PowerShell
$env:https_proxy="http://proxy.company.com:8080"
curl.exe -vv https://api.anthropic.com
如有必要，使用 --cacert $NODE_EXTRA_CA_CERTS 指定证书。 接下来，检查 ~/.cline/cline-core-service.log（CLI、JetBrains）中的日志消息，确认您的代理配置和任何网络相关错误。

​
常见代理模式

​
经过身份验证的 HTTPS 代理

export https_proxy=http://username:password@proxy.company.com:8080
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

​
无需身份验证的代理

export https_proxy=http://proxy.company.com:8080
export http_proxy=http://proxy.company.com:8080

​
带绕过规则的代理

export https_proxy=http://proxy.company.com:8080
export no_proxy=localhost,127.0.0.1,.company.local,192.168.0.0/16