Appearance
/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+Insertbash
# 方法二(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