配置目录与环境变量

配置位置

Cline 的配置分两个作用域：全局配置在 ~/.cline/（适用于所有 Cline 应用，包括 IDE、CLI 和 SDK）；项目配置在 .cline/（只适用于当前工作区）。主根目录是 ~/.cline/，结构化的应用状态在 ~/.cline/data/ 下：

~/.cline/
  data/
    settings/
      providers.json           # API key 和提供商配置
      global-settings.json     # 全局设置
      cline_mcp_settings.json  # MCP 设置
    teams/                     # 团队状态
    sessions/                  # 会话数据
    db/                        # SQLite 数据库（如 cron.db）
    workflows/                 # 全局工作流
  rules/                       # 全局规则
  hooks/                       # 全局 hooks
  skills/                      # 全局技能
  agents/                      # 全局智能体定义
  plugins/                     # 全局插件（.js、.ts）
  cron/                        # 全局 cron 规格

代码还支持这些额外的全局搜索路径：~/Documents/Cline/ 下的 Rules/、Hooks/、Plugins/、Workflows/（用于兼容）。项目级配置在仓库根目录的 .cline/ 里：

.cline/
  rules/                       # 项目规则
  skills/                      # 项目技能
  hooks/                       # 生命周期 hooks
  agents/                      # 项目智能体定义
  plugins/                     # 项目插件
  cron/                        # 工作区 cron 规格

说明：全局提供商设置、全局设置和 MCP 设置存储在 ~/.cline/data/settings/ 下；全局工作流从 ~/.cline/data/workflows/ 解析；全局规则、hooks、技能、智能体、插件和 cron 规格直接在 ~/.cline/ 下解析。放在哪里：用**全局（~/.cline/）放你机器上所有 Cline 应用（IDE、CLI、SDK）共享的默认值；用项目（.cline/）**放应该随仓库流转的团队共享行为。提交你想与团队共享的 .cline/ 文件，把密钥留在仓库之外。安全注意：只使用来自你信任的来源的规则、hooks、技能和插件；hooks 和插件可以执行代码，像任何可执行产物一样在全局或项目里添加它们之前先评审。

通过 CLI 配置

用交互式配置界面：

cline config

在那里你可以查看/编辑设置（全局和工作区）、规则、技能和 hooks。有用的配置命令：用自定义配置目录 cline --config /path/to/custom/config "your task"；或通过环境变量 export CLINE_DATA_DIR=/custom/path/to/cline；排障时用 cline dev log 查看 CLI 日志。

CLINE_COMMAND_PERMISSIONS 限制 Cline 能执行哪些 shell 命令：export CLINE_COMMAND_PERMISSIONS='{"allow": ["npm *", "git *"], "deny": ["rm -rf *"]}'，格式是带 allow、deny、allowRedirects 的 JSON。规则：deny 覆盖 allow；设置了 allow 时，不匹配 allow 的命令被拒绝；allowRedirects 控制 shell 重定向（>、>>、<），默认 false。

网络与代理

如果你在企业代理或防火墙后面工作，需要配置代理设置，让 Cline 连接到 AI 提供商，配置因你用的 Cline 版本而异。

VS Code 扩展：自动使用 VS Code 内置的代理设置（见 VS Code 文档的 Network Connections、Proxy server support），Cline 本身不需要额外配置。

CLI：使用标准的 HTTP 代理环境变量，在运行 cline 命令之前配置。Windows 命令提示符：set https_proxy=http://proxy.company.com:8080、set http_proxy=...；PowerShell：$env:https_proxy="http://proxy.company.com:8080"；macOS/Linux：export https_proxy=http://proxy.company.com:8080 和 export http_proxy=...。代理需要认证时，在 URL 里包含凭据：export https_proxy=http://username:password@proxy.company.com:8080（注意：把凭据存在环境变量里可能有安全风险）。要避免 localhost 流量走代理，设置 no_proxy：export no_proxy=localhost,127.0.0.1,.local（Windows 用 set no_proxy=...）。代理使用自定义 CA 证书时：export NODE_EXTRA_CA_CERTS=/path/to/ca-certificate.pem（Windows 用 set NODE_EXTRA_CA_CERTS=C:\path\to\ca-certificate.crt）。要避免每次都设置这些变量，把它们加到你的 shell 配置文件（~/.bashrc、~/.zshrc 或 ~/.profile）或系统环境变量里（Windows：在 Windows 设置里搜索「Environment Variables」，在「User variables」或「System variables」下添加，然后重启终端或 IDE）。已知限制：Cline CLI 只支持 HTTP 代理，不支持 SOCKS 代理、代理自动配置（PAC）脚本，或需要基本用户名密码之外认证的 HTTP 代理。

JetBrains IDE：JetBrains 插件使用 IDE 的 HTTP 代理设置。配置：打开 Settings/Preferences（Windows/Linux 用 File > Settings，macOS 用 IntelliJ IDEA > Preferences，或按 Ctrl+Alt+S/Cmd+,），进入 Appearance & Behavior > System Settings > HTTP Proxy，选「Manual proxy configuration」，配置主机名、端口、「No proxy for」（如 localhost,127.0.0.1），需要时勾选「Proxy authentication」并输入用户名密码，点「Check connection」验证后点「OK」应用，然后重启 IDE。配置后测试：打开 Cline 面板发一条简单消息，连接失败时检查 IDE 的 Event Log 里的错误信息。代理使用自定义 CA 时：把证书加入系统信任库，或导入 JetBrains IDE（Settings > Tools > Server Certificates，点「+」添加证书）。已知限制：JetBrains 里的 Cline 也只支持 HTTP 代理（不支持 SOCKS、PAC 脚本或基本认证之外的代理认证），并且不会动态获取变化的代理设置，更改代理设置后要重启 IDE。

排障：连接超时——验证代理地址和端口正确、检查代理是否需要认证、确保 AI 提供商的 API 端点没有被你的防火墙阻止；SSL/TLS 证书错误——检查 NODE_EXTRA_CA_CERTS 指向正确的证书文件、确保证书文件是 PEM 格式、用 curl 验证证书可用（如 curl -x proxy.corp.example:8080 --cacert /path/to/ca-cert.pem -o - -vv https://api.cline.bot/），也可以考虑在 VS Code 里禁用 http.proxyStrictSSL（不建议用于生产）；测试代理配置——遇到 Cline 网络问题时，先用 curl 验证代理配置能工作（Linux/macOS：export https_proxy=... 然后 curl -vv https://api.anthropic.com；PowerShell：curl.exe -vv https://api.anthropic.com，需要时用 --cacert $NODE_EXTRA_CA_CERTS 指定证书），然后检查 ~/.cline/cline-core-service.log（CLI、JetBrains）里确认代理配置和任何网络相关错误的日志消息。常见代理模式：带认证的 HTTPS 代理（https_proxy 带用户名密码，加 NODE_EXTRA_CA_CERTS）；无认证的代理（https_proxy 和 http_proxy）；带绕过规则的代理（再加 no_proxy=localhost,127.0.0.1,.company.local,192.168.0.0/16）。