首页搜索文章教程工具关于

OpenCode + DeepSeek API 的全平台安装教程

#OpenCode#DeepSeek#教程#代理#终端#开发环境
约 3 分钟

OpenCode 是开源的 AI 编程助手，支持终端、桌面应用、IDE 插件、Web 等多种形态。GitHub 177K+ stars，兼容 75+ LLM 提供商，无地区限制。(OpenCode)

为什么不选 Claude Code？Claude Code 安装脚本会做地区检测，非支持地区返回 302 重定向而非安装脚本，导致 irm https://claude.ai/install.ps1 | iex 报一堆 PowerShell 语法错误、winget 下载 downloads.claude.ai 时报 0x80072efd。而 OpenCode 走 npm registry，全球无墙，安装零障碍。

零、安装 Node.js

OpenCode 依赖 Node.js 18+，先装环境。

Windows

去 nodejs.org 下载 LTS 版安装包（.msi），双击安装，一路 Next。安装时勾选 "Automatically install the necessary tools"。

安装完成后重新打开 PowerShell，验证：

powershell
node -v
npm -v

如果提示 node 不是可识别的命令，说明安装时没勾"Add to PATH"，重新运行安装程序选 Repair 即可。

也可以通过包管理器安装：

powershell
# winget（Windows 11 自带）
winget install OpenJS.NodeJS.LTS
 
# Chocolatey
choco install nodejs-lts

macOS

bash
# Homebrew（推荐）
brew install node@20
 
# 或者去 nodejs.org 下载 .pkg 安装包

验证：

bash
node -v
npm -v

Linux

bash
# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
 
# Fedora
sudo dnf install nodejs
 
# Arch
sudo pacman -S nodejs npm

验证：

bash
node -v
npm -v

WSL

WSL 里按 Linux 方式安装（Ubuntu 最常见）：

bash
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
 
node -v
npm -v

一、Windows 安装 OpenCode

确保已安装 Node.js 18+（见上文「零、安装 Node.js」）。

1. npm 安装（推荐）

powershell
npm install -g opencode-ai

2. 验证安装

powershell
opencode --version

opencode 是 npm 全局安装的，自动在 PATH 中，不需要额外配置。

3. 其他 Windows 安装方式

powershell
# Chocolatey
choco install opencode
 
# Scoop
scoop install opencode

二、macOS 安装 OpenCode

确保已安装 Node.js 18+（见上文「零、安装 Node.js」）。

1. npm 安装

bash
npm install -g opencode-ai

2. Homebrew 安装

bash
brew install anomalyco/tap/opencode

推荐使用 anomalyco/tap，更新比官方 Homebrew formula 更及时。(OpenCode)

验证：

bash
opencode --version

三、Linux 安装 OpenCode

确保已安装 Node.js 18+（见上文「零、安装 Node.js」）。

bash
npm install -g opencode-ai

验证：

bash
opencode --version

刷新 shell（如果找不到命令）：

bash
source ~/.bashrc

四、WSL 安装 OpenCode

确保已安装 Node.js 18+（见上文「零、安装 Node.js」）。

WSL 里按 Linux 方式安装：

bash
npm install -g opencode-ai

验证：

bash
opencode --version

五、配置 OpenCode 接 DeepSeek API

安装完成后直接启动 OpenCode，用内置的 /connect 命令交互式配置：

bash
opencode

进入 TUI 后输入：

text
/connect

在弹出的列表里选 DeepSeek，然后输入你的 API Key 即可。OpenCode 会自动保存配置，不需要手写任何文件。(OpenCode Providers)

如果你的 DeepSeek API Key 来自 OpenRouter，在 /connect 里选 OpenRouter 即可。

备选：手动写配置文件

如果偏好手动配置，在项目根目录或 ~/.opencode/ 创建 opencode.json：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "deepseek": {
      "options": {
        "apiKey": "你的DeepSeek_API_Key"
      }
    }
  }
}

⚠️ 注意替换 apiKey。如果提交到 Git 记得加 .gitignore。

六、启动 OpenCode

进入项目目录：

bash
cd /path/to/my-project
opencode

Windows 示例：

powershell
cd E:\your-project
opencode

OpenCode 启动后显示 TUI 界面，默认使用计划模式（Plan agent），可以先分析项目结构再动手。

切换模式

在 TUI 中按 Tab 在计划模式（plan）和构建模式（build）之间切换：

  • Plan：先分析、提问、制定计划
  • Build：直接执行代码修改

一键执行

跳过 TUI，直接执行任务：

bash
opencode run "解释当前项目的目录结构和技术栈"
opencode run "添加用户登录功能并写测试" --agent build

七、常用命令

在 OpenCode 内或终端：

text
opencode run '...'          一键执行任务
opencode -c                 继续上次会话
opencode -s <session_id>    恢复指定会话
opencode --model <model>    指定模型
opencode session list       列出会话
opencode stats              查看用量统计
opencode auth list          查看已配提供商

TUI 快捷键：

按键功能
Enter发送消息（可能需要按两次）
Tab切换 Plan / Build 代理
Ctrl+P打开命令面板
Ctrl+X M切换模型
Ctrl+X N新会话
Ctrl+X L切换会话
Ctrl+C退出

八、更新 OpenCode

bash
npm update -g opencode-ai

Homebrew（macOS）：

bash
brew upgrade opencode

九、卸载

npm

bash
npm uninstall -g opencode-ai

Homebrew

bash
brew uninstall opencode

清除配置

bash
rm -rf ~/.opencode

最短安装路径

Windows + DeepSeek

powershell
# 安装
npm install -g opencode-ai
 
# 配置（用你的 API Key 替换）
mkdir ~/.opencode -Force
vim ~/.opencode/opencode.json
 
opencode

macOS / Linux / WSL + DeepSeek

bash
npm install -g opencode-ai
 
mkdir -p ~/.opencode
vim ~/.opencode/opencode.json
 
opencode

评论