OpenCode - 安装配置、快速上手教程

作者：hangge | 2026-05-26 10:02

随着 AI 编程助手需求日益增长，开源工具 OpenCode 凭借灵活的模型接入、本地化配置及 Git 深度集成，提供了安全透明的代码协作体验。本文将从零开始，带大家完成 OpenCode 的安装配置并快速上手。

1，安装 Node.js

（1）首先我们电脑需要安装 Node.js 环境，我们可以去其官网（点击访问）下载安装包安装（v18.0 或更高版本）。

（2）安装后可以输入以下命令，若成功输出版本号，则表示安装成功。

node -v

2，安装 Open Code

（1）打开 CMD“命令提示符”窗口，执行如下命令安装 Open Code。

npm install -g opencode-ai

（2）安装后可以输入以下命令，若成功输出版本号，则表示安装成功。

opencode -v

3，配置 OpenCode

（1）OpenCode 运行时需要接入 LLM 提供商的 API Key。官方文档建议新手优先使用 OpenCode Zen，这是一组经过官方测试和验证的模型列表；当然，我们也可以接入其他支持的提供商。这里我使用京东的 Coding Plan 为例，打开 OpenCode 的配置文件，路径如下：

macOS / Linux：~/.config/opencode/opencode.json
Windows：C:\Users\您的用户名\.config\opencode\opencode.json

提示：如果目录下面没有 opencode.json 这个文件，我们可以手动创建一个。

（2）接着在里面添加相关的配置即可，下面是一个使用京东 Coding Plan 的样例模板：

提示：这里面的 apiKey 需要填写我们自己的 key。

{
    "$schema": "https://opencode.ai/config.json",
    "model": "joybuilder-plan/GLM-5",
    "provider": {
        "joybuilder-plan": {
            "npm": "@ai-sdk/openai-compatible",
            "name": "jcloud Engine",
            "options": {
                "baseURL": "https://modelservice.jdcloud.com/coding/openai/v1",
                "apiKey": ""
            },
            "models": {
                "DeepSeek-V3.2": {
                    "name": "DeepSeek-V3.2",
                    "limit": {
                        "context": 128000,
                        "output": 64000
                    }
                },
                "GLM-5": {
                    "name": "GLM-5",
                    "limit": {
                        "context": 200000,
                        "output": 32000
                    }
                },
                "GLM-4.7": {
                    "name": "GLM-4.7",
                    "limit": {
                        "context": 200000,
                        "output": 128000
                    }
                },
                "MiniMax-M2.5": {
                    "name": "MiniMax-M2.5",
                    "limit": {
                        "context": 200000,
                        "output": 128000
                    }
                },
                "Kimi-K2.5": {
                    "name": "Kimi-K2.5",
                    "limit": {
                        "context": 256000,
                        "output": 32000
                    }
                },
                "Kimi-K2-Turbo": {
                    "name": "Kimi-K2-Turbo",
                    "limit": {
                        "context": 256000,
                        "output": 32000
                    }
                },
                "Qwen3-Coder": {
                    "name": "Qwen3-Coder",
                    "limit": {
                        "context": 64000,
                        "output": 8000
                    }
                }
            }
        }
    }
}

附：快速上手教程

1，初始化项目

（1）我们打开命令控制台，进入需要维护的项目目录，然后执行如下命令启动 OpenCode。

opencode

（2）进入 OpenCode 后，先执行如下命令，这一步会让 OpenCode 分析当前项目，并在项目根目录生成 AGENTS.md 文件。

提示：建议把这个生成的 AGENTS.md 文件提交到 Git，这样 OpenCode 更容易理解项目结构和代码风格。

/init

2，开始实践

（1）假设系统登录页是下面这个样子。

（2）我们希望增加一个记住密码功能，同时调整下页面色调。可以按下 tab 健切换到 Plan 模式，然后输入需求回车。

（3）接着 OpenCode 就会开始进行规划，如果需求不是很明确期间还会与我们做进一步的沟通确认。

（4）规划好后，OpenCode 会展示本次修改的目标和涉及到的代码，由于 Plan 模式下 OpenCode 不会修改我们代码，我们可以按下 tab 切换到 build 模式，然后告诉 OpenCode 按计划的执行。

（5）最后修改后的登录页效果如下。

3，撤销上一步修改

（1）如果我们让 OpenCode 修改了代码，结果改错了、不符合预期，或者不小心让 AI 覆盖 / 删除了重要代码。想回退到上一个正确版本，可以执行如下命令：

/undo

（2）不过要特别注意下面两点：

/undo 和 /redo 命令完全基于 Git 实现，所以需要我们的项目是一个 Git 仓库才能正常使用。
如果项目还没初始化，在项目根目录下执行 git init 就行。OpenCode 的 /init 命令在初始化时也会帮我们完成这一步。

Python / AI