OpenCode 配置教程

通过 CERouter API 接入 OpenCode，支持 Claude、GPT、Gemini 等多种 AI 模型。

前提条件

验证 Node.js

OpenCode 基于 Node.js 运行，请先确认已安装（建议 LTS 版本）。

如果没有显示版本号，请参考 Node.js 安装教程进行安装。

安装 OpenCode

方式一：安装脚本（macOS / Linux / WSL2）

该命令会自动检测系统架构并安装最新版本。

方式二：npm 全局安装（跨平台）

如果使用 nvm 管理 Node.js，可以不加 sudo。

方式三：包管理器

Homebrew（macOS / Linux）

Chocolatey（Windows）

choco install opencode

Scoop（Windows）

验证安装：

若安装失败，请检查 Node.js 版本是否为 18 及以上。

配置环境变量

如果使用 CC Switch，可以跳转 CC Switch 配置。

将下方变量中的占位符替换为你的实际信息：YOUR_API_KEY → 你的 CERouter API Key

Windows（PowerShell）

临时生效（仅当前终端会话有效）：

$env:ANTHROPIC_BASE_URL = "https://cerouter.com"
$env:ANTHROPIC_API_KEY = "YOUR_API_KEY"

永久生效（推荐）：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://cerouter.com", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "YOUR_API_KEY", "User")

设置后需重新打开终端窗口。

macOS / Linux / WSL2

将以下内容追加到 ~/.bashrc 或 ~/.zshrc：

然后使配置立即生效：

验证配置

Windows

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_API_KEY

macOS / Linux / WSL2

开始使用

OpenCode 会以当前目录作为项目上下文，请确保在正确的项目目录中启动。

基础命令

命令	说明
`/help`	显示帮助信息
`/models`	切换 AI 模型
`/init`	初始化项目，生成 AGENTS.md 文件
`/undo`	撤销上一次修改
`/share`	分享当前对话
`/exit`	退出 OpenCode

两种工作模式

Plan 模式（规划）：只分析不修改，适合代码审查和性能分析。

Build 模式（构建）：实际修改代码，适合重构和添加功能。

在交互界面中，按 Tab 键可以在两种模式间切换。

确认配置已生效

进入 OpenCode 交互界面后，输入以下命令查看当前配置状态：

期望输出示例：

Provider: Anthropic
Model: claude-sonnet-4-5
Base URL: https://cerouter.com

⚠️ 如果显示的是官方地址或默认模型，说明环境变量未生效，请退出后重新检查配置步骤。

配置文件方式

OpenCode 支持通过 JSON 配置文件进行高级设置，加载优先级为：命令行参数 > 环境变量 > 项目级 JSON > 用户级 JSON > 默认配置。

系统	路径
Windows	`C:\Users\你的用户名\.config\opencode\opencode.json`
macOS / Linux	`~/.config/opencode/opencode.json`

示例配置：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5",
  "providers": {
    "anthropic": {
      "apiKey": "YOUR_API_KEY",
      "options": {
        "baseURL": "https://cerouter.com"
      }
    }
  },
  "tui": {
    "theme": "opencode"
  }
}

💡 也可以在项目根目录下创建 .opencode.json 或 opencode.json 文件，用于项目级别的特定配置。

常见问题

问题	解决方案
环境变量设置后不生效	重新打开一个终端窗口，或执行 `source ~/.bashrc`
Windows 安装时提示权限错误	以管理员身份运行 PowerShell 后重试
macOS / Linux 安装时提示权限错误	命令前加 `sudo`，或使用 nvm 安装 Node.js（nvm 安装的 npm 无需 `sudo`）
启动后无法连接提供商	检查 API 密钥是否正确；运行 `/connect` 重新配置；检查网络连接
如何指定要使用的模型	在交互界面输入 `/models` 从列表中选择，或在配置文件中设置 `model` 字段
界面空白或卡住	按 `Ctrl+L` 强制刷新屏幕；推荐使用 WezTerm、Alacritty、Windows Terminal 等现代终端
如何更新 OpenCode	`npm install -g opencode-ai@latest`
Windows 上使用有问题	建议使用 WSL 以获得最佳体验；使用 Windows Terminal 而不是 Command Prompt

OpenCode 配置

OpenCode 配置教程#

目录#

前提条件#

验证 Node.js#

安装 OpenCode#

方式一：安装脚本（macOS / Linux / WSL2）#

方式二：npm 全局安装（跨平台）#

方式三：包管理器#

配置环境变量#

Windows（PowerShell）#

macOS / Linux / WSL2#

验证配置#

开始使用#

基础命令#

两种工作模式#

确认配置已生效#

配置文件方式#

常见问题#