前言

很多AI编程工具用起来方便，但一旦涉及团队协作，就会遇到另一个问题：服务部署在本地，只有自己能打开；想让同事一起体验，或者给客户演示效果，还要处理网络、环境和访问地址这些额外问题。

MonkeyCode适合放在这个场景里。它是一款面向代码辅助的AI应用，可以在本地Linux环境中部署，通过模型API接入对话和代码补全能力，再配合VS Code插件使用。对于想搭建一套可控AI代码助手的人来说，它比单纯使用在线工具更适合做团队化、私有化尝试。

本文会先从MonkeyCode的部署条件讲起，包括Linux系统、Docker版本、Docker Compose版本和基础资源要求。随后演示一键安装、端口设置、后台登录、模型API配置、对话模型添加和代码补全模型添加，让服务先在本地跑起来。

在基础功能完成后，再进入VS Code使用环节，包括成员邀请、客户端下载、插件安装、账号登录，以及用AI生成一个简单五子棋小游戏的测试过程。这样可以确认MonkeyCode不只是后台能打开，而是真的可以进入开发工作流。

最后，还会通过 [cpolar]配置公网访问和固定二级子域名。这样本地运行在9999端口的MonkeyCode，不只在局域网里能用，也可以在外部设备、远程协作或演示场景中稳定访问。

1.MonkeyCode安装条件

安装 MonkeyCode 前，请确保你的系统环境符合以下要求

• 操作系统：Linux
• CPU 指令架构：x86_64
• 软件依赖：Docker 20.10.14 版本以上
• 软件依赖：Docker Compose 2.0.0 版本以上
• 推荐资源：1 核 CPU / 4 GB 内存 / 20 GB 磁盘
• 最低资源：1 核 CPU / 2 GB 内存 / 5 GB 磁盘

2.在linux安装MonkeyCode

登录到root用户下，然后输入下方命令一键安装：

bash -c "$(curl -fsSLk https://release.baizhi.cloud/monkeycode/manager.sh)"

然后回车默认就可以，端口自定义，我这里定义的是9999。

下载完成后，弹出这个页面，代表安装成功：

接下来，我们可以使用它提供的访问链接，输入账号密码登录啦！

登录完成之后，我们要先配置一下AI模型的API ，才能正常使用 。

一般官网都没有详细配置，今天在这里我将手把手教你，如何配置API！

首先点模型管理，点击对话模型的“添加模型”。

点击查看文档。

登录百智云，获取API。

起个名称，点确认。

复制。

粘贴后，点击获取模型列表。

模型名称选择，如图。

这样对话模型就显示成功啦！

接下来，代码补全模型，同上。

选择模型名称，如图。

这样，代码补全模型也添加成功啦！

3.在VS Code中使用

接下来，点击成员管理，邀请新用户。

注册账号后，下载客户端。

打开vs code，如图中操作。

选择下载好的文件。

出现这个标，即代表成功啦！

使用注册好的用户名，密码登录。

点击。

输入，让其写一个五子棋小游戏。

代码生成的很快。

打开网页，游戏就生成成功啦！

我们重回Monkey Code界面，在对话记录可以看见，我们输入的命令。

现在，让我们进入激动人心的实战环节！只需几个简单步骤，就能让你的 MonkeyCode “飞”向公网。

4.安装cpolar实现随时随地开发

cpolar 可以将你本地电脑中的服务（如 SSH、Web、数据库）映射到公网。即使你在家里或外出时，也可以通过公网地址连接回本地运行的开发环境。

❤️以下是安装cpolar步骤：

使用一键脚本安装命令：

sudo curl https://get.cpolar.sh | sh

安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）

sudo systemctl status cpolar

Cpolar安装和成功启动服务后，在浏览器上输入虚拟机主机IP加9200端口即:【http://192.168.42.101:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：

打开浏览器访问本地9200端口，使用cpolar账户密码登录即可,登录后即可对隧道进行管理。

5.配置公网地址

登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：

• 隧道名称：可自定义，本例使用了:monkey，注意不要与已有的隧道名称重复

• 协议：http

• 本地地址：9999

• 域名类型：随机域名

• 地区：选择China Top

  点击创建：

创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址，接下来就可以在其他电脑或者移动端设备（异地）上，使用地址访问。

访问成功。

6.保留固定公网地址

使用cpolar为其配置二级子域名，该地址为固定地址，不会随机变化。

点击左侧的预留，选择保留二级子域名，地区选择china top，然后设置一个二级子域名名称，我这里演示使用的是monkey，大家可以自定义。填写备注信息，点击保留。

登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道monkey，点击右侧的编辑。

修改隧道信息，将保留成功的二级子域名配置到隧道中

• 域名类型：选择二级子域名
• Sub Domain：填写保留成功的二级子域名
• 地区: China Top

点击更新

更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。

最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问本地部署的monkey code页面，这样一个永久不会变化的二级子域名公网网址即设置好了。

恭喜！你成功了！ 现在，无论你身在何处，用手机、平板还是另一台电脑，都能看到并操作你本地运行的 MonkeyCode 了！

总结

完成部署后，MonkeyCode就可以作为一套本地运行的AI代码助手平台使用。模型API配置完成后，既可以在后台查看对话记录，也可以通过VS Code插件进行代码生成、补全和开发辅助。

这套方案的价值，不只是把一个AI工具安装起来，而是把代码辅助能力放到自己可控的环境中。团队成员可以通过账号接入，同一套服务也可以沉淀使用记录和模型配置，后续维护会更清晰。

配置 [cpolar]后，本地运行的MonkeyCode可以从外部网络访问。随机域名适合临时测试，固定二级子域名更适合长期使用，方便把访问入口分享给成员，或者在不同设备上继续使用。

需要注意的是，MonkeyCode涉及账号、模型API Key、代码内容和对话记录，公网访问时一定要设置强密码，不要把后台地址随意公开。涉及公司项目代码时，也要确认团队内部的数据安全和权限边界。

MonkeyCode负责提供AI代码助手能力，Linux与Docker负责承载本地服务，cpolar负责补上远程访问入口。当这几部分组合起来以后，本地AI开发工具就不再只能一个人使用，而可以成为更适合协作、演示和跨设备访问的私有AI编程入口。