# CodeBuddy Models Manager

一个本地优先的 CodeBuddy `models.json` 可视化配置工具。

它会读取现有的 `models.json` 并展示到界面里。启动服务、打开页面、点击“刷新”都不会覆盖用户配置，只有点击“保存配置”时才会写回文件。写回前会自动备份原文件。

![Xnip2026-04-17_16-58-56.png](https://developer.qcloudimg.com/http-save/yehe-7650548/bd61e1c1bbb2c795075e4b49ef899679.png)


## 功能

- 查看现有模型列表
- 添加、删除、修改模型
- 刷新并重新读取本地配置
- 管理 `availableModels`
- 默认保留已有 API Key，不在界面明文回显
- 保存前校验配置
- 保存前自动备份
- 支持 Docker 部署
- 支持通过环境变量指定配置文件路径

## 界面预览

主界面会自动读取现有 `models.json`，左侧展示模型列表，右侧编辑当前模型。API Key 默认只显示掩码，留空保存时会继续沿用原密钥。

![Xnip2026-04-17_16-58-56.png](https://developer.qcloudimg.com/http-save/yehe-7650548/f86ae765aff5671e56dc88e5f8c4ade7.png)

底部可以管理 `availableModels`。勾选“显示全部模型”时会保存为空数组；取消后可选择只显示指定模型。

![Xnip2026-04-17_16-59-07.png](https://developer.qcloudimg.com/http-save/yehe-7650548/70a88101b6da6c255ae306334588501a.png)

## 本地启动

```bash
npm start
```

然后打开：

```text
http://127.0.0.1:4310/
```

默认读取：

```text
~/.codebuddy/models.json
```

这个路径下如果已经有模型配置，会直接显示在列表里；如果文件不存在，页面会显示空列表，直到你主动保存才会创建文件。

## 指定配置文件

```bash
CODEBUDDY_MODELS_PATH=/path/to/models.json npm start
```

或：

```bash
node server.js --config=/path/to/models.json
```

## Docker

```bash
docker compose up --build
```

或直接运行：

```bash
docker run --rm \
  -p 4310:4310 \
  -v ~/.codebuddy:/data \
  -e CODEBUDDY_MODELS_PATH=/data/models.json \
  codebuddy-models-manager
```

## 环境变量

| 变量 | 默认值 | 说明 |
| --- | --- | --- |
| `HOST` | `127.0.0.1` | 监听地址 |
| `PORT` | `4310` | 监听端口 |
| `CODEBUDDY_MODELS_PATH` | `~/.codebuddy/models.json` | 配置文件路径 |
| `READONLY` | `false` | 设置为 `true` 后只读 |

## 安全说明

- 页面不会默认展示完整 API Key。
- 未修改 API Key 时，保存会自动沿用原文件里的值。
- 服务默认只监听 `127.0.0.1`。
- 每次保存前会在配置文件同级的 `backups/` 目录创建备份。

## CodeBuddy 配置语义

- `models` 会按模型 `id` 合并，同 `id` 覆盖。
- `availableModels` 为空数组时表示显示全部模型。
- `availableModels` 非空时表示只显示数组里的模型。
- 项目级 `.codebuddy/models.json` 优先级高于用户级 `~/.codebuddy/models.json`。

## 地址
仓库已开源在[CodeBuddyModel Helper](https://github.com/mokong/CodebuddyModelHelper)

它会读取现有的 models.json 并展示到界面里。启动服务、打开页面、点击“刷新”都不会覆盖用户配置，只有点击“保存配置”时才会写回文件。写回前会自动备份原文件。

# CodeBuddy Models Manager

CodeBuddy 支持自定义模型，但是是 json 的格式，配置起来不方便，封装了一个可视化来配置

IOS开发工程师

前端

CodeBuddyModelsManager是一款本地优先的models.json可视化配置工具，支持模型管理、密钥保护、自动备份和Docker部署。可安全编辑CodeBuddy配置，保留原APIKey，支持环境变量指定路径，默认监听本地端口4310。开源工具助力开发者高效管理AI模型配置。

Docker

2026采购季 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

# CodeBuddy Models Manager-腾讯云开发者社区-腾讯云

# CodeBuddy Models Manager

# CodeBuddy Models Manager

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐