OpenCode 配置
OpenCode 配置教程
获取 API Key 后，按照你的操作系统选择对应步骤完成配置。
步骤 1：验证是否安装 Node.js
windows用户（win+R）输入 cmd 回车 分别执行
node -v
npm -v
查看是否有版本号，如果没有显示版本号的可以参考 node 安装教程 进行安装
步骤 2：安装 OpenCode
方案一：一键脚本安装 (macOS / Linux / WSL2)
方案二：npm 全局安装 (跨平台)
💡 提示：如果使用 nvm 管理 Node.js，可以不加 sudo。
方案三：使用包管理器
choco install opencodescoop bucket add extras
scoop install extras/opencode验证安装
若安装失败，请检查 Node.js 版本是否为 18 及以上。
步骤 3：配置环境变量
如果使用CC Switch的可以跳转 CC Switch 配置
YOUR_API_KEY → 你的 API KeyWindows（PowerShell）
$env:ANTHROPIC_BASE_URL = "https://www.aiide.com"
$env:ANTHROPIC_API_KEY = "YOUR_API_KEY"[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://www.aiide.com", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "YOUR_API_KEY", "User")macOS / Linux / WSL2
~/.bashrc 或 ~/.zshrc（zsh 用户）：步骤 4：验证环境变量
Windows
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_API_KEYmacOS / Linux / WSL2
步骤 5：开始使用
启动 OpenCode
基础命令
| 命令 | 说明 |
|---|---|
/help | 显示帮助信息 |
/models | 切换 AI 模型 |
/init | 初始化项目，生成 AGENTS.md 文件 |
/undo | 撤销上一次修改 |
/share | 分享当前对话 |
/exit | 退出 OpenCode |
两种工作模式
Tab 键可以在两种模式间切换。步骤 6：确认配置已生效
/statusCtrl+P 进入命令面板，选择 switch model 来查看和切换当前使用的模型。Provider: Anthropic
Model: claude-sonnet-4-5
Base URL: https://www.aiide.com如果显示的是官方地址或默认模型，说明环境变量未生效，请退出后重新检查步骤 3。
可选：全局配置文件
| 系统 | 全局配置文件路径 |
|---|---|
| Windows | C:\Users\你的用户名\.config\opencode\opencode.json |
| macOS / Linux | ~/.config/opencode/opencode.json |
opencode.json 配置：{
"$schema": "https://opencode.ai/config.json",
"model": "anthropic/claude-sonnet-4-5",
"providers": {
"anthropic": {
"apiKey": "YOUR_API_KEY",
"options": {
"baseURL": "https://www.aiide.com"
}
}
},
"tui": {
"theme": "opencode"
}
}💡 提示：你可以在项目根目录下创建一个 .opencode.json或opencode.json文件，用于项目级别的特定配置。
常见问题
重新打开一个终端窗口，或执行
source ~/.bashrc。以管理员身份运行 PowerShell 后重试。
命令前加
sudo，或使用 nvm 安装 Node.js（nvm 安装的 npm 无需 sudo）。1.
2.
/connect 重新配置连接。3.
在交互界面中输入
/models，从列表中选择要使用的模型。你也可以在配置文件中设置 model 字段来指定默认模型，格式为 provider_id/model_id（例如 anthropic/claude-sonnet-4-5）。按
Ctrl+L 强制刷新屏幕，或检查终端兼容性。官方推荐使用 WezTerm、Alacritty、Windows Terminal 等现代终端模拟器。Windows 用户建议使用 WSL 以获得最佳体验。如果使用原生 Windows，确保使用 Windows Terminal 而不是 Command Prompt。
Modified at 2026-05-29 05:39:37