安装openCode

一、通过命令安装

1. 安装 OpenCode

# 一键安装脚本
curl -fsSL https://opencode.ai/install | bash

# 或使用 npm
npm install -g opencode-ai@latest

# 验证安装
opencode --version

2. 配置模型 API Key

进入项目目录，运行 /connect 选择模型提供商并配置 API Key：

cd /path/to/your-project
opencode
/connect

支持的模型提供商包括：Anthropic (Claude)、OpenAI (GPT)、DeepSeek、Google Vertex AI、本地 Ollama、OpenRouter 等 75+ 种。

 二、安装客户端openCode

GitHub地址：https://github.com/anomalyco/opencode/releases

 

三、离线安装opencode，部署到内网环境

使用 OpenCode Sentinel（专为企业内网优化）

这是一个针对内网或离线环境优化的安全增强版，叫 OpenCode Sentinel。它的优点是提供了一键打包工具，可以在一台能联网的机器上把所有依赖都下载好，然后复制到内网解压就能用，可以免去手动处理复杂依赖的麻烦。

1.安装流程大致如下：
准备打包环境（在有网的机器上）：
安装 Bun、Node.js。

克隆 Sentinel 仓库：

#克隆
git clone https://github.com/oneoflzx/opencode-sentinel.git

#进入下载好的离线文件夹
cd opencode-sentinel

生成离线安装包：

运行打包脚本，这会生成一个自包含的安装包 opencode-offline.tar.gz：

bun offline-scripts/pack.ts

然后在内网服务器上安装：
将 opencode-offline.tar.gz 复制到内网目标机器并解压。

2.在内网服务器上安装

（1）创建挂载目录

#进入数据盘
cd /data

#创建挂载目录
sudo mkdir -p opencode

创建好挂载目录后，把opencode-offline.tar.gz 复制到该目录下

（2）进入存放opencode-offline.tar.gz的目录：

#进入opencode
cd /data/opencode

#查看是否有安装包
ls

（3）解压安装包

tar -xzf opencode-offline.tar.gz

（4）安装：

进入解压后的目录，根据你的系统（Linux）运行安装脚本：

#安装
sudo ./install.sh

可能报找不到install.sh

解决方法：

第一种：权限不够

sudo chmod +x install.sh

#然后执行
sudo ./install.sh

第二种：格式不对

#确认文件确实存在且可读
ls -la install.sh

#查看前几行内容
head -5 install.sh

#检查文件格式（是否有Windows换行符）
file install.sh

# 直接用 sed 转换
sudo sed -i 's/\r$//' install.sh

#然后执行
sudo ./install.sh

验证：安装完成后，直接在终端输入 opencode 检查是否安装成功。

5.为什么输入 opencode 报"未找到命令"？

安装完成了，但输入opencode没效果，可能是其他系统版本的,如opencode-linux-x64、opencode-linux-arm64等

#在系统全局搜索opencode相关文件
sudo find / -name "*opencode*" -type f 2>/dev/null | grep -v snap | grep -v cache

#搜索可执行的opencode文件
sudo find / -name "opencode*" -type f -executable 2>/dev/null

#查看/usr/local/bin目录下有什么
ls -la /usr/local/bin/ | grep -i opencode

解决方法：

（1）刷新当前终端的环境变量（推荐）

source /root/.bashrc

（2）设置全局命令

sudo ln -s /data/opencode/opencode-linux-x64 /usr/local/bin/opencode

5.1输入opencode --version查看版本时，显示“非法指令”，可能系统不兼容，需要使用 opencode-linux-x64-baseline 版本。

# 1. 进入文件存放目录
cd /media/sangfor/vdb/opencode/bin/

# 2. 检查文件是否存在
ls -la opencode-linux-x64-baseline

# 3. 给文件添加执行权限
chmod +x opencode-linux-x64-baseline

# 4. 测试运行
./opencode-linux-x64-baseline --version
# 应显示版本号，不再报"非法指令"

# 5. 先删除可能存在的旧链接或其他opencode文件
sudo rm -f /usr/local/bin/opencode

# 6. 创建软链接，方便全局调用
sudo ln -sf /media/sangfor/vdb/opencode/bin/opencode-linux-x64-baseline /usr/local/bin/opencode

# 7. 验证
opencode --version

5.2如果执行了5.1命令后还是显示“非法指令”，请检查软链接是否正确。

# 使用 -f 选项，递归地找出最终指向的物理文件
ls -laf /usr/local/bin/opencode

# 查看文件的实际架构，确认是否为 baseline 版本
file /media/sangfor/vdb/opencode/bin/opencode-linux-x64-baseline

# 查看系统能找到的所有 opencode，可能存在多个软链接
which -a opencode

#Shell 可能缓存了旧命令的路径。执行以下命令清除缓存：
hash -r

# 用你实际的 baseline 文件路径替换
/media/sangfor/vdb/opencode/bin/opencode-linux-x64-baseline --version

当执行“which -a opencode”后，存在多个软链接时，解决方法：

# 查看所有 opencode 的位置
which -a opencode

# 根据上一步的输出，删除旧的（非 /usr/local/bin/ 的）
# 例如，如果有 /usr/bin/opencode：
sudo rm -f /usr/bin/opencode

# 如果有 /media/sangfor/vdb/opencode/bin/opencode（旧文件）：
rm -f /media/sangfor/vdb/opencode/bin/opencode

# 清除 shell 缓存
hash -r

# 验证
which opencode   # 应该只显示 /usr/local/bin/opencode
opencode --version

或：

# 先把所有 opencode 找出来
for f in $(which -a opencode); do
    if [ "$f" != "/usr/local/bin/opencode" ]; then
        echo "删除: $f"
        sudo rm -f "$f"
    fi
done

# 清除 shell 缓存
hash -r

# 验证
opencode --version

6.配置模型

#进入config
cd .config

#进入opencode文件夹
cd opencode

#查看是否有opencode.json
ls

#编辑opencode.json
vim opencode.json

输入以上命令后，会打开opencode.json编辑输入界面，然后输入：

{
    "$schema":"http://opencode.ai/config.json",
  "provider": {
    "internal": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "vLLMLM GLM-5",
      "options": {
        "baseURL": "http://172.16.49.61:8005/v1",
        "apiKey": "dummy"
      },
      "models": {
        "glm-5": {
          "name": "GLM-5 via vLLM",
          "limit":{
            "context":32768,
            "output":8192
          }
        }
      }
    }
  },
  "model": "vllm/glm-5",
}

在 Vim 中编辑完 opencode.json 后：

1. 按 Esc 键：确保退出编辑模式（左下角的 -- INSERT -- 消失）

2. 输入 :wq：保存并退出 Vim

   • :w = 保存（write）

   • :q = 退出（quit）

   • 组合起来 :wq = 保存并退出

配置文件保存后，需要让 OpenCode 重新加载配置才能生效：

重启 OpenCode（最可靠）

# 如果 OpenCode 正在运行，先退出（按 Ctrl+C）
# 然后重新启动
opencode

 四、常见问题

opencode常见问题