Agent 一键导入命令库

本页是 Agent 一键导入命令的维护源。数据库不内置默认命令；管理员确认客户端版本和模型能力后，在 /console/agent-import-commands 中逐条创建需要提供的命令。

以下内容最后核对于 2026-07-22，适用于 macOS、Linux 的 Bash / Zsh。命令不会安装客户端，运行前须先按对应客户端的官方方式完成安装。

填写规则

控制台只支持以下模板变量：

{{api_base_url}}：根据协议自动生成。openai-compatible 和 responses 带 /v1，anthropic 和 gemini 使用站点根地址。
{{access_key}}：用户当前选择的 Lumoswitch Access Key。
{{model}}：配置 API 对外提供的模型名称。

除特别说明外，下面的条目都应设置为“启用”。建议先在测试配置 API 和测试 Access Key 上验证，再提供给全部用户。复制后的命令含明文 Access Key，用户不应粘贴到工单、聊天或公开日志中。

可直接启用的命令

Codex

平台 ID：codex
展示名称：Codex
下游协议：responses
展示顺序：10

export LUMOSWITCH_API_KEY="{{access_key}}" && codex --model "{{model}}" \
  -c 'model_provider="lumoswitch"' \
  -c 'model_providers.lumoswitch.name="Lumoswitch"' \
  -c 'model_providers.lumoswitch.base_url="{{api_base_url}}"' \
  -c 'model_providers.lumoswitch.env_key="LUMOSWITCH_API_KEY"' \
  -c 'model_providers.lumoswitch.wire_api="responses"' \
  -c 'model_providers.lumoswitch.requires_openai_auth=false'

该命令通过运行时 -c 覆盖使用自定义模型提供方，不修改 ~/.codex/config.toml。requires_openai_auth=false 配合自定义环境凭证会跳过 OpenAI 登录，直接进入 Codex。配置 API 必须启用 Responses 输出。

官方依据：Codex 自定义模型提供方和配置参考。

Claude Code

平台 ID：claude-code
展示名称：Claude Code
下游协议：anthropic
展示顺序：20

export ANTHROPIC_BASE_URL="{{api_base_url}}" \
  ANTHROPIC_AUTH_TOKEN="{{access_key}}" \
  ANTHROPIC_MODEL="{{model}}" \
  ANTHROPIC_DEFAULT_OPUS_MODEL="{{model}}" \
  ANTHROPIC_DEFAULT_SONNET_MODEL="{{model}}" \
  ANTHROPIC_DEFAULT_HAIKU_MODEL="{{model}}" \
  CLAUDE_CODE_SUBAGENT_MODEL="{{model}}" \
  ANTHROPIC_CUSTOM_MODEL_OPTION="{{model}}" && \
claude --model "{{model}}"

必须使用 ANTHROPIC_AUTH_TOKEN，不要替换成 ANTHROPIC_API_KEY；前者会以 Bearer 凭证连接网关，并在首次启动时跳过 Claude 登录。默认模型、快速模型和子 Agent 都固定到同一个对外模型，避免后台任务回退到不可用的 Claude 模型 ID。

仅在目标模型真正兼容 Claude Code 时提供此条目。模型至少应正确支持 Anthropic Messages 流式输出、Tool Use 和 Claude Code 使用的请求字段；协议转换不能弥补模型本身缺失的工具能力。

官方依据：Claude Code LLM gateway、模型配置和环境变量。

OpenCode

平台 ID：opencode
展示名称：OpenCode
下游协议：openai-compatible
展示顺序：30

export LUMOSWITCH_API_KEY="{{access_key}}" && \
export OPENCODE_CONFIG_CONTENT='{"$schema":"https://opencode.ai/config.json","provider":{"lumoswitch":{"npm":"@ai-sdk/openai-compatible","name":"Lumoswitch","options":{"baseURL":"{{api_base_url}}","apiKey":"{env:LUMOSWITCH_API_KEY}"},"models":{"{{model}}":{"name":"Lumoswitch"}}}},"model":"lumoswitch/{{model}}"}' && \
opencode

命令通过 OPENCODE_CONFIG_CONTENT 注入当前进程配置，不写入用户的 opencode.json，也不需要先执行 /connect。

官方依据：OpenCode Providers 和配置文件。

GitHub Copilot CLI

平台 ID：github-copilot-cli
展示名称：GitHub Copilot CLI
下游协议：openai-compatible
展示顺序：40

export COPILOT_PROVIDER_TYPE="openai" \
  COPILOT_PROVIDER_BASE_URL="{{api_base_url}}" \
  COPILOT_PROVIDER_API_KEY="{{access_key}}" \
  COPILOT_MODEL="{{model}}" \
  COPILOT_OFFLINE="true" && \
copilot

BYOK 模式绕过 GitHub 托管模型认证；COPILOT_OFFLINE=true 会阻止运行时为仓库集成等附加能力连接 GitHub。目标模型必须支持流式输出和 Tool / Function Calling，官方建议至少 128K 上下文。

官方依据：GitHub Copilot CLI BYOK。

Gemini CLI

平台 ID：gemini-cli
展示名称：Gemini CLI
下游协议：gemini
展示顺序：50

export GEMINI_API_KEY="{{access_key}}" GEMINI_MODEL="{{model}}" GOOGLE_GEMINI_BASE_URL="{{api_base_url}}" && \
export GEMINI_CLI_SYSTEM_SETTINGS_PATH="$HOME/.gemini/lumoswitch-system-settings.json" && \
node -e 'const fs=require("node:fs"),path=require("node:path"),p=process.env.GEMINI_CLI_SYSTEM_SETTINGS_PATH;fs.mkdirSync(path.dirname(p),{recursive:true});fs.writeFileSync(p,JSON.stringify({security:{auth:{selectedType:"gemini-api-key",enforcedType:"gemini-api-key"}}},null,2)+"\n",{mode:0o600})' && \
gemini --model "{{model}}"

Gemini CLI 即使发现 API Key，首次运行仍可能显示认证方式选择。该命令通过官方的 GEMINI_CLI_SYSTEM_SETTINGS_PATH 创建 Lumoswitch 专用覆盖文件，固定并强制使用 gemini-api-key；它不改动用户原有的 ~/.gemini/settings.json，也不会被项目级设置改回登录方式。Access Key 仍只存在于当前 shell 环境。Node.js 是 Gemini CLI 的安装前置条件。

此条目使用 Gemini 原生协议，不可改成带 /v1 的 OpenAI-compatible 地址。目标模型须兼容 Gemini CLI 使用的函数调用和流式响应。

官方依据：Gemini CLI 认证和配置参考；后者同时定义了设置优先级和 GEMINI_CLI_SYSTEM_SETTINGS_PATH。

Qwen Code

平台 ID：qwen-code
展示名称：Qwen Code
下游协议：openai-compatible
展示顺序：60

qwen --auth-type openai --model "{{model}}" --openai-api-key "{{access_key}}" --openai-base-url "{{api_base_url}}"

所有凭证和模型都通过本次启动参数提供，不进入登录流程，也不写入配置文件。

官方依据：Qwen Code 模型提供方配置。

Aider

平台 ID：aider
展示名称：Aider
下游协议：openai-compatible
展示顺序：70

export OPENAI_API_KEY="{{access_key}}" OPENAI_API_BASE="{{api_base_url}}" && aider --model "openai/{{model}}"

openai/ 是 Aider 选择 OpenAI-compatible 提供方所需的模型前缀，不会被发送为 Lumoswitch 的模型名称。

官方依据：Aider OpenAI-compatible APIs。

OpenClaw

平台 ID：openclaw
展示名称：OpenClaw
下游协议：openai-compatible
展示顺序：80

openclaw onboard --non-interactive --accept-risk --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "{{api_base_url}}" \
  --custom-model-id "{{model}}" \
  --custom-api-key "{{access_key}}" \
  --custom-provider-id "lumoswitch" \
  --custom-compatibility openai \
  --secret-input-mode plaintext && \
openclaw

这条命令执行官方非交互式 onboarding，然后启动 OpenClaw。与前面的临时环境变量方案不同，它会把自定义提供方和 Access Key 持久化到 OpenClaw 的本地凭证存储中；只有在用户接受这一行为时才应运行。若改用 Responses，需要单独维护协议为 responses、兼容模式为 openai-responses 的条目。

官方依据：OpenClaw 非交互式 onboarding 和 onboard CLI。

暂不提供一键命令的客户端

这些客户端仍属于覆盖范围，但当前官方接入方式依赖 GUI、交互式向导，或需要合并用户已有配置文件。保留它们的独立接入文档，不在控制台发布可能覆盖用户配置的伪“一键”命令。

客户端	当前接入方式	文档
Cline	VS Code / 编辑器设置页	Cline 接入
Continue	合并用户 YAML 配置	Continue 接入
Kilo Code	编辑器设置或配置文件	Kilo Code 接入
Crush	合并用户配置文件	Crush 接入
Goose	交互式提供方配置	Goose 接入
OpenWebUI	管理后台连接配置	OpenWebUI 接入

发布前验证

每次客户端大版本更新后，按以下顺序复核对应条目：

使用客户端官方最新稳定版，并核对上游官方文档中的参数或环境变量仍然存在。
创建只启用目标协议的测试配置 API，并选择具备流式输出、工具调用和足够上下文的模型。
使用测试 Access Key 在干净用户环境运行渲染后的完整命令，确认没有登录、授权方式选择或模型选择提示。
让 Agent 完成一次最小对话和一次工具调用，再检查 Lumoswitch 日志中的协议、模型和 Access Key 是否正确。
检查命令是否修改本地配置；若有持久化行为，必须与本页说明一致。
轮换测试 Access Key，确认旧 Key 失效后再将条目启用给用户。

On this page