最近的几年来，我的 AI 辅助编程工具先后从 Copilot -> Cursor -> KiloCode ，再转到近期使用了 OpenCode。体验到了 OpenCode 加上 Oh-My-OpenCode 的强大之处，可以说用上就再也回不去了。在此对 Windows 系统上的环境配置作一记录。
0. 系统环境
- Windows 11 25H2
- Visual Studio Code 1.109.3
- Node.js 26.01.14
1. 安装Chocolatey
以管理员权限打开 Windows PowerShell，执行以下命令：
1
| Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
|
之后会自动安装 Chocolatey。
安装完成后，关闭并重新打开终端，然后执行：
看到版本号就说明安装成功了。
2. 安装 WezTerm
OpenCode 作为一个终端编辑器，支持如下现代化终端：
- WezTerm，跨平台
- Alacritty，跨平台
- Ghostty，Linux 和 macOS
- Kitty，Linux 和 macOS
对于 Windows 平台的两款，我个人比较倾向于WezTerm。
在终端运行命令 choco install wezterm -y 进行安装。
安装后，继续在终端依次运行如下命令以打开 WezTerm 配置文件：
1
2
| New-Item -Path "$env:USERPROFILE\.wezterm.lua" -ItemType File -Force
code "$env:USERPROFILE\.wezterm.lua"
|
之后可以根据 WezTerm 官方文档进行配置修改。以下是一个可用的参考。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
| local wezterm = require 'wezterm'
local config = {}
-- 使用更新的配置方式
if wezterm.config_builder then
config = wezterm.config_builder()
end
-- ============ 基础设置 ============
-- 默认 Shell
config.default_prog = { 'powershell.exe' }
-- config.default_prog = { 'pwsh.exe' } -- PowerShell 7
-- config.default_prog = { 'wsl.exe', '~' } -- WSL
-- 启动时窗口大小
config.initial_cols = 120
config.initial_rows = 30
-- ============ 字体设置 ============
config.font = wezterm.font('JetBrains Maple Mono', { weight = 'Medium' })
-- 备选字体：'Cascadia Code', 'Fira Code', 'Consolas'
config.font_size = 14
config.line_height = 1.1
-- 启用连字
config.harfbuzz_features = { 'calt=1', 'clig=1', 'liga=1' }
-- ============ 外观设置 ============
config.color_scheme = 'Catppuccin Mocha'
-- 其他主题：'Catppuccin Mocha', 'Tokyo Night', 'Dracula'
-- 背景透明度（1.0 = 不透明）
config.window_background_opacity = 0.95
-- 窗口边距
config.window_padding = {
left = 10,
right = 10,
top = 10,
bottom = 10,
}
-- 标签栏设置
config.use_fancy_tab_bar = false
config.hide_tab_bar_if_only_one_tab = true
-- 无标题栏（可选，更简洁）
-- config.window_decorations = "RESIZE"
-- ============ 快捷键 ============
config.keys = {
-- Ctrl+Shift+T 新建标签
{ key = 't', mods = 'CTRL|SHIFT', action = wezterm.action.SpawnTab 'DefaultDomain' },
-- Ctrl+Shift+W 关闭标签
{ key = 'w', mods = 'CTRL|SHIFT', action = wezterm.action.CloseCurrentTab { confirm = true } },
-- Alt+数字 切换标签
{ key = '1', mods = 'ALT', action = wezterm.action.ActivateTab(0) },
{ key = '2', mods = 'ALT', action = wezterm.action.ActivateTab(1) },
{ key = '3', mods = 'ALT', action = wezterm.action.ActivateTab(2) },
-- Ctrl+Shift+| 垂直分屏
{ key = '|', mods = 'CTRL|SHIFT', action = wezterm.action.SplitHorizontal { domain = 'CurrentPaneDomain' } },
-- Ctrl+Shift+_ 水平分屏
{ key = '_', mods = 'CTRL|SHIFT', action = wezterm.action.SplitVertical { domain = 'CurrentPaneDomain' } },
-- Ctrl+Shift+F 搜索
{ key = 'f', mods = 'CTRL|SHIFT', action = wezterm.action.Search { CaseSensitiveString = '' } },
-- Ctrl+Shift+C/V 复制粘贴
{ key = 'c', mods = 'CTRL|SHIFT', action = wezterm.action.CopyTo 'Clipboard' },
{ key = 'v', mods = 'CTRL|SHIFT', action = wezterm.action.PasteFrom 'Clipboard' },
}
-- ============ 其他设置 ============
-- 关闭提示音
config.audible_bell = 'Disabled'
-- 光标样式
config.default_cursor_style = 'BlinkingBar'
-- 可选：'SteadyBlock', 'BlinkingBlock', 'SteadyUnderline', 'BlinkingBar'
-- 滚动回溯行数
config.scrollback_lines = 10000
-- 关闭更新检查（可选）
config.check_for_updates = false
return config
|
3. 安装 OpenCode
在 WezTerm 终端运行命令 choco install opencode 进行安装，安装后在终端输入 opencode 以启动。打开时默认是免费的“Big Pickle”模型，在对话框输入以下命令以安装 Oh-My-OpenCode 插件：
1
2
| 按照以下说明安装和配置 oh-my-opencode：
https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md
|
之后智能体会自动读取安装说明并进行插件安装。安装过程中会提示是否要启用一些订阅例如 Claude Code、ChatGPT、Gemini、Copilot、ZAI等，如有的话可以接入，没有则全部选择 No。安装好后关闭终端即可。
接下来打开 C:\Users\你的用户名\.config\opencode路径，里面应该有两个文件：opencode.json和oh-my-opencode.json。根据需求可以进行编辑设置。我个人使用 AiHubMix 作为 Provider，以下设置仅供参考。
opencode.json
oh-my-opencode.json
之后打开 WezTerm 终端并输入 opencode，就可以愉快的使用了！
Francis Fu