diff --git a/docs/developer-guide/core/prepare.md b/docs/developer-guide/core/prepare.md
index 52ad99b..6f31927 100644
--- a/docs/developer-guide/core/prepare.md
+++ b/docs/developer-guide/core/prepare.md
@@ -1,6 +1,24 @@
 ---
-title: 相关说明
-description: 开发环境的一些说明
+title: 准备工作
+description: 开发环境的准备工作
 ---
 
-WIP
+## 环境要求
+
+- [OpenJDK 17 LTS](https://github.com/openjdk/jdk)
+- [Node.js 16 LTS](https://nodejs.org)
+- [pnpm 7](https://pnpm.io/)
+- [IntelliJ IDEA](https://www.jetbrains.com/idea/)
+- [Git](https://git-scm.com/)
+
+## 名词解释
+
+### 工作目录
+
+指 Halo 所依赖的工作目录，在 Halo 运行的时候会在系统当前用户目录下产生一个 halo-next 的文件夹，绝对路径为 ~/halo-next。里面通常包含下列目录或文件：
+
+1. `db`：存放 H2 Database 的物理文件，如果你使用其他数据库，那么不会存在这个目录。
+2. `themes`：里面包含用户所安装的主题。
+2. `plugins`：里面包含用户所安装的插件。
+5. `attachments`：附件目录。
+4. `logs`：运行日志目录。
diff --git a/docs/developer-guide/core/run.md b/docs/developer-guide/core/run.md
new file mode 100644
index 0000000..906df63
--- /dev/null
+++ b/docs/developer-guide/core/run.md
@@ -0,0 +1,113 @@
+---
+title: 开发环境运行
+description: 开发环境运行的指南
+---
+
+:::info
+在之前之前，我们推荐你先阅读[《准备工作》](./prepare)，检查本地环境是否满足要求。
+:::
+
+## 项目结构说明
+
+目前如果需要完整的运行 Halo，总共需要三个部分：
+
+1. Halo 主项目([halo-dev/halo](https://github.com/halo-dev/halo))
+2. Console 控制台([halo-dev/console](https://github.com/halo-dev/console))
+3. 主题
+
+:::info 说明
+当前 Halo 主项目并不会将 Console 的构建资源托管到 Git 版本控制，所以在开发环境是需要同时运行 Console 项目的。当然，在我们的最终发布版本的时候会在 CI 中自动构建 Console 到 Halo 主项目。
+:::
+
+## 克隆项目
+
+如果你已经 fork 了相关仓库，请将以下命令中的 halo-dev 替换为你的 GitHub 用户名。
+
+```bash
+git clone https://github.com/halo-dev/halo
+
+或者使用 ssh 的方式 clone（推荐）
+
+git clone git@github.com:halo-dev/halo.git
+```
+
+```bash
+git clone https://github.com/halo-dev/console
+
+或者使用 ssh 的方式 clone（推荐）
+
+git clone git@github.com:halo-dev/console.git
+```
+
+## 运行 Console
+
+```bash
+cd path/to/console
+```
+
+```bash
+pnpm install 
+```
+
+```bash
+pnpm build:packages
+```
+
+```bash
+pnpm dev
+```
+
+最终控制台打印了如下信息即代表运行正常：
+
+```bash
+VITE v3.1.6  ready in 638 ms
+
+➜  Local:   http://localhost:3000/console/
+```
+
+## 运行 Halo
+
+1. 在 IntelliJ IDEA 中打开 Halo 项目，等待 Gradle 初始化和依赖下载完成。
+2. 创建本地配置文件
+
+    复制 `src/main/resources/application-dev.yaml` 为 `application-local.yaml`，修改配置如下：
+
+    ```yaml
+    halo:
+      console:
+        proxy:
+          endpoint: http://localhost:3000/
+          enabled: true
+      security:
+        initializer:
+          super-admin-username: admin
+          super-admin-password: admin
+    ```
+
+3. 修改 IntelliJ IDEA 的运行配置
+
+    将 Active Profiles 改为 `local`，如图所示：
+
+    ![IntelliJ IDEA Profiles](/img/developer-run/IntelliJ-IDEA-Profiles.png)
+
+4. 点击 IntelliJ IDEA 的运行按钮，等待项目启动完成。
+
+5. 或者使用 Gradle 运行
+
+    ```bash
+    # macOS / Linux
+    ./gradlew bootRun --args="--spring.profiles.active=local"
+
+    # Windows
+    gradlew.bat bootRun --args="--spring.profiles.active=local"
+    ```
+
+6. 最终访问 `http://localhost:8090/console` 即可进入控制台。访问 `http://localhost:8090` 即可进入站点首页。
+
+:::info 注意
+目前 Alpha 版本有以下几个使用注意事项：
+:::
+
+1. 由于目前尚未完成初始化程序，所以安装完成之后没有默认主题，你可以访问 <https://github.com/halo-sigs/awesome-halo> 查阅所有支持 2.0 的主题，并在后台主题管理页面手动安装。
+2. 同上，由于目前评论组件也被插件化，所以如果要体验完整的评论功能，需要手动在后台安装 <https://github.com/halo-sigs/plugin-comment-widget> 评论组件插件。
+3. 目前 2.0 已支持的主题和插件会同步到 <https://github.com/halo-sigs/awesome-halo>，你可以在对应仓库的 release 下载最新的主题或插件。
diff --git a/sidebars.js b/sidebars.js
index 54c8c6f..c9f546c 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -55,6 +55,7 @@ module.exports = {
           items: [
             // "developer-guide/core/structure",
             "developer-guide/core/prepare",
+            "developer-guide/core/run",
             // "developer-guide/core/code-style",
           ],
         },
diff --git a/static/img/developer-run/IntelliJ-IDEA-Profiles.png b/static/img/developer-run/IntelliJ-IDEA-Profiles.png
new file mode 100644
index 0000000..1558971
Binary files /dev/null and b/static/img/developer-run/IntelliJ-IDEA-Profiles.png differ