Cline Agent 接入

Cline 是面向软件开发的编码 Agent，可读取和修改项目、运行终端命令并完成多步骤任务。官方提供 VS Code、JetBrains 扩展和独立 CLI；目前没有单独的 Cline Desktop 应用。

开始前，请创建使用 OpenAI-compatible 输出的 Lumoswitch 配置 API。Cline 强依赖 Tool Call，因此目标模型不能只是“可以聊天”。

方式总览

方式	是否支持	说明
从空白环境仅本次启动	不支持	CLI 可单次覆盖 Key、提供方和模型，但没有单次 Base URL 参数；完整 Lumoswitch 地址必须先保存
已配置后临时换 Key / 模型	支持	使用 CLI 的 `--key` 与 `--model`，退出后失效
永久使用	支持	CLI 使用隔离的 Lumoswitch 数据目录；IDE 使用扩展设置
清除接入	支持	CLI 精确删除隔离的提供方文件；IDE 必须通过原生设置清理 SecretStorage

准备连接信息

占位符	应填写的内容
`{{api_base_url}}`	配置 API 的下游地址，包含 `/v1`
`{{access_key}}`	当前配置使用的 Lumoswitch Access Key
`{{model}}`	配置 API 显示的下游模型名称

CLI 永久使用

先在专门的数据目录中运行官方认证向导：

mkdir -p "$HOME/.cline/lumoswitch"
cline --data-dir "$HOME/.cline/lumoswitch" auth

在向导中选择 OpenAI Compatible，然后填写 Base URL、API Key 和 Model ID。使用隔离目录可以避免 Lumoswitch 提供方和日常 Cline CLI 配置混在一起。

认证完成后安装一个短启动命令：

set -e
LUMOSWITCH_LAUNCHER="$HOME/.local/bin/lumoswitch-cline"
mkdir -p "$(dirname "$LUMOSWITCH_LAUNCHER")"
umask 077
if [ -f "$LUMOSWITCH_LAUNCHER" ]; then
  LUMOSWITCH_BACKUP="$LUMOSWITCH_LAUNCHER.backup.$(date +%Y%m%d-%H%M%S)-$$"
  cp "$LUMOSWITCH_LAUNCHER" "$LUMOSWITCH_BACKUP"
  chmod 600 "$LUMOSWITCH_BACKUP"
fi
cat > "$LUMOSWITCH_LAUNCHER" <<'LUMOSWITCH_EOF'
#!/usr/bin/env bash
set -e
exec cline --data-dir "$HOME/.cline/lumoswitch" "$@"
LUMOSWITCH_EOF
chmod 700 "$LUMOSWITCH_LAUNCHER"
"$LUMOSWITCH_LAUNCHER"

以后运行：

~/.local/bin/lumoswitch-cline

已配置后仅本次启动

如果 Lumoswitch Base URL 已经保存在上述隔离配置中，可临时覆盖本次进程的 Key 和模型：

cline \
  --data-dir "$HOME/.cline/lumoswitch" \
  --key "{{access_key}}" \
  --model "{{model}}"

退出后覆盖值失效。--key 会出现在 Shell 历史和短时间的进程参数中，只适合个人可信设备；它也不能代替首次保存 Base URL，因此不是完整的空白环境临时接入。

清除 CLI 接入

下面命令只删除本文隔离目录中的提供方设置和专属启动器，不删除 Cline 会话数据库、项目规则或默认 ~/.cline 配置：

rm -f "$HOME/.cline/lumoswitch/data/settings/providers.json"
rm -f "$HOME/.local/bin/lumoswitch-cline"
if [ -d "$HOME/.local/bin" ]; then
  find "$HOME/.local/bin" -maxdepth 1 -type f \
    -name 'lumoswitch-cline.backup.*' -delete
fi

这里不删除整个 ~/.cline/lumoswitch，因为其中可能已有使用 Lumoswitch 产生的会话历史。

VS Code 与 JetBrains

在 Cline 面板的设置中：

API Provider 选择 OpenAI Compatible。
Base URL 填写 {{api_base_url}}。
API Key 填写 {{access_key}}。
Model ID 填写 {{model}}。
使用 Verify 验证连接。

IDE 扩展只有永久接入，没有临时终端命令。它由编辑器进程启动，不读取上述隔离 CLI 目录；凭证保存在 VS Code Secrets 或 JetBrains Credential Store，而不是普通配置文件。

要清除 IDE 接入，请在同一 Cline 设置面板中切换到其他提供方，并清除 OpenAI Compatible 的 Lumoswitch Base URL、Model ID 和 API Key。这里不提供终端删除命令，因为不同编辑器使用各自加密的 SecretStorage；直接删除产品目录既不能保证清掉钥匙串，也会误删会话和其他提供方。

验证与排查

404 时检查是否重复添加 /v1，以及是否误填上游模型 ID。
先验证普通问答，再测试文件读取、补丁和终端工具。
CLI 可运行 cline config 查看当前配置，运行 cline doctor 排查环境问题。

参考：Cline OpenAI Compatible、CLI Reference 和认证与模型选择。最近核验：2026-08-03。

维护者发布字段

平台 ID：cline
展示名称：Cline CLI
下游协议：openai-compatible
commandTemplate：不发布；官方 CLI 没有单次 Base URL 参数，已有配置后的 --key 覆盖不能独立完成接入
永久发布策略：disabled；cline auth 必须先通过交互向导写入隔离配置，无法生成安全、无交互的完整发布命令
persistentCommandTemplate：不适用；页面保留人工创建专属配置与启动器的步骤
futureCommand：不适用；人工配置完成后可日常运行 ~/.local/bin/lumoswitch-cline
展示顺序：90
最近核验：2026-08-03

On this page