Skip to content

/connect 界面无法粘贴 API Key(Ctrl+V 和右键粘贴均失效)

问题

在 opencode 中执行 /connect 进入 API key 输入界面后,常见的粘贴操作全部失效:

  • Ctrl+V 无反应
  • Ctrl+Shift+V 无反应
  • 右键菜单无法弹出(或弹出后没有粘贴选项)

界面没有任何关于如何输入的提示,用户被迫手动输入长 API key。

影响平台:Windows(包括 WSL2)和 Linux,不同终端仿真器均有报告。

原因

opencode TUI 使用的键盘输入处理方式与部分系统/终端的粘贴机制不兼容。Ctrl+V 的信号在 TUI 层被拦截或忽略,导致系统剪贴板内容无法注入到输入框中。这是已知的 TUI 输入兼容性问题(#909、#6560)。

解决方案

根据不同平台/终端,尝试以下粘贴方式:

Linux / WSL2

bash
# 方法一:Shift+Insert(传统 X11 风格粘贴)
# 先 Ctrl+C 复制 API key,然后在输入框按:
Shift+Insert
bash
# 方法二(WSL2):Shift+左键点击
# 在 WSL2 终端中,用鼠标 Shift+左键点击可触发粘贴
Shift + 鼠标左键

Fedora / Wayland

Wayland 环境下右键点击偶尔可以调出粘贴菜单,需要反复尝试(不稳定,有时需点击 5-10 次)。

Windows Terminal

部分用户报告在 Windows Terminal 中,Ctrl+Enter 可以触发文本输入相关操作,但效果不稳定。

通用方法:通过环境变量预设 API Key

绕过 /connect 界面,直接在 shell 配置或 opencode 配置中设置 API key,避免手动粘贴:

bash
# ~/.bashrc 或 ~/.zshrc
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."

或在 opencode.json 中使用 {env:...} 引用:

jsonc
{
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}"
      }
    }
  }
}

这样就不需要通过 TUI 界面手动输入 key。

来源:GitHub #9922