codexmate 0.0.14 → 0.0.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.en.md +153 -358
- package/README.md +153 -357
- package/cli.js +1351 -67
- package/doc/CHANGELOG.md +14 -9
- package/doc/CHANGELOG.zh-CN.md +7 -0
- package/package.json +3 -3
- package/web-ui/app.js +24 -324
- package/web-ui/index.html +45 -22
- package/web-ui/modules/config-mode.computed.mjs +123 -0
- package/web-ui/modules/skills.computed.mjs +82 -0
- package/web-ui/modules/skills.methods.mjs +344 -0
- package/web-ui/styles.css +4 -4
package/README.md
CHANGED
|
@@ -1,429 +1,225 @@
|
|
|
1
|
-
|
|
1
|
+
<div align="center">
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
# Codex Mate
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
**Codex / Claude Code / OpenClaw 的本地配置与会话管理工具**
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
> 当前版本:`v0.0.16`
|
|
8
|
+
|
|
9
|
+
[](https://github.com/SakuraByteCore/codexmate/actions/workflows/release.yml)
|
|
8
10
|
[](https://www.npmjs.com/package/codexmate)
|
|
9
11
|
[](https://www.npmjs.com/package/codexmate)
|
|
10
|
-
[](https://github.com/ymkiux/codexmate)
|
|
11
|
-
[](https://github.com/ymkiux/codexmate/commits)
|
|
12
12
|
[](LICENSE)
|
|
13
13
|
[](https://nodejs.org)
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
[快速开始](#快速开始) · [命令速查](#命令速查) · [Web 界面](#web-界面) · [MCP](#mcp) · [English](README.en.md)
|
|
16
16
|
|
|
17
17
|
</div>
|
|
18
18
|
|
|
19
19
|
---
|
|
20
20
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-

|
|
24
|
-
|
|
25
|
-
## 概览
|
|
26
|
-
|
|
27
|
-
Codex Mate 让 Codex 与 Claude Code 的提供商/模型切换变成“一条命令或一次点击”,并在同一 Web 页面浏览、导出两者的本地会话记录。
|
|
28
|
-
|
|
29
|
-
## 60 秒上手(源码一行安装)
|
|
30
|
-
|
|
31
|
-
环境要求:`Node.js >= 14`、`Git`
|
|
32
|
-
|
|
33
|
-
```bash
|
|
34
|
-
git clone https://github.com/ymkiux/codexmate.git && cd codexmate && npm install && npm link && codexmate run
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
浏览器打开 `http://localhost:3737`。
|
|
21
|
+
## 这是什么?
|
|
38
22
|
|
|
39
|
-
|
|
23
|
+
Codex Mate 提供一套本地优先的 CLI + Web UI,用于统一管理:
|
|
40
24
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
如果你只想临时试用,可直接用:
|
|
47
|
-
|
|
48
|
-
```bash
|
|
49
|
-
npx codexmate@latest run
|
|
50
|
-
```
|
|
25
|
+
- Codex 的 provider / model 切换与配置写入
|
|
26
|
+
- Claude Code 配置方案(写入 `~/.claude/settings.json`)
|
|
27
|
+
- OpenClaw JSON5 配置与 Workspace `AGENTS.md`
|
|
28
|
+
- Codex / Claude 本地会话浏览、筛选、导出、删除
|
|
29
|
+
- `codexmate qwen` 快捷透传命令
|
|
51
30
|
|
|
52
|
-
|
|
31
|
+
项目不依赖云端托管,配置写入你的本地文件,便于审计和回滚。
|
|
53
32
|
|
|
54
|
-
|
|
33
|
+
## 为什么选择 Codex Mate?
|
|
55
34
|
|
|
56
|
-
|
|
57
|
-
codexmate switch <提供商>
|
|
58
|
-
codexmate use <模型>
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
2. 一行写入 Claude Code 配置
|
|
62
|
-
|
|
63
|
-
```bash
|
|
64
|
-
codexmate claude <BaseURL> <API_KEY> <模型>
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
3. 导出本地会话到 Markdown
|
|
68
|
-
|
|
69
|
-
```bash
|
|
70
|
-
codexmate export-session --source codex --session-id <ID>
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
## 核心命令(最常用)
|
|
74
|
-
|
|
75
|
-
| 目标 | 命令 |
|
|
76
|
-
| --- | --- |
|
|
77
|
-
| 查看当前状态 | `codexmate status` |
|
|
78
|
-
| 启动 Web UI | `codexmate run` |
|
|
79
|
-
| 交互式初始化 | `codexmate setup` |
|
|
80
|
-
| 查看提供商/模型 | `codexmate list` / `codexmate models` |
|
|
81
|
-
| 切换提供商/模型 | `codexmate switch <提供商>` / `codexmate use <模型>` |
|
|
82
|
-
| 写入 Claude 配置 | `codexmate claude <BaseURL> <API_KEY> [模型]` |
|
|
83
|
-
| 导出会话 | `codexmate export-session --source <codex|claude> ...` |
|
|
84
|
-
|
|
85
|
-
## 你能获得什么
|
|
86
|
-
|
|
87
|
-
- 更快的模型/提供商切换
|
|
88
|
-
- 更可控的本地配置管理
|
|
89
|
-
- 可视化 Web 操作,降低命令行负担
|
|
90
|
-
- 配置变更可回溯、有备份
|
|
91
|
-
- Codex + Claude Code 统一会话浏览(查看/导出/可用时复制恢复命令)
|
|
92
|
-
- 0.0.10 新增:Claude 会话支持关键词搜索(含 `claude code` / `claude-code` / 数字关键词)
|
|
93
|
-
- 0.0.14 新增:Skills 管理弹窗加入统计概览、筛选区优化与更细滚动条
|
|
94
|
-
|
|
95
|
-
## 功能总览
|
|
96
|
-
|
|
97
|
-
| 模块 | 解决的问题 | 关键能力 |
|
|
35
|
+
| 维度 | Codex Mate | 手动维护配置 |
|
|
98
36
|
| --- | --- | --- |
|
|
99
|
-
|
|
|
100
|
-
|
|
|
101
|
-
|
|
|
102
|
-
|
|
|
103
|
-
|
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
-
|
|
109
|
-
-
|
|
110
|
-
-
|
|
111
|
-
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
-
|
|
116
|
-
-
|
|
117
|
-
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
37
|
+
| 多工具管理 | Codex + Claude Code + OpenClaw 统一入口 | 多文件、多目录分散修改 |
|
|
38
|
+
| 使用方式 | CLI + 本地 Web UI | 纯手改 TOML / JSON / JSON5 |
|
|
39
|
+
| 会话处理 | 支持浏览、导出、批量清理 | 需要手动定位和处理文件 |
|
|
40
|
+
| 可回滚性 | 首次接管前自动备份 | 易误覆盖、回滚成本高 |
|
|
41
|
+
| 自动化接入 | 提供 MCP stdio(默认只读) | 需自行封装脚本 |
|
|
42
|
+
|
|
43
|
+
## 核心特性
|
|
44
|
+
|
|
45
|
+
**配置管理**
|
|
46
|
+
- provider / model 切换(`switch` / `use`)
|
|
47
|
+
- Codex `config.toml` 模板确认后写入
|
|
48
|
+
- Claude Code 多配置方案管理与一键应用
|
|
49
|
+
- OpenClaw JSON5 配置方案管理
|
|
50
|
+
|
|
51
|
+
**会话管理**
|
|
52
|
+
- 同页查看 Codex 与 Claude 会话
|
|
53
|
+
- 关键词搜索、来源筛选、cwd 路径筛选
|
|
54
|
+
- 会话导出 Markdown
|
|
55
|
+
- 会话与消息级删除(支持批量)
|
|
56
|
+
|
|
57
|
+
**工程能力**
|
|
58
|
+
- MCP stdio 能力(tools/resources/prompts)
|
|
59
|
+
- 内建代理配置与状态控制(`proxy`)
|
|
60
|
+
- 认证档案管理(`auth`)
|
|
61
|
+
- `codexmate qwen` 兼容启动入口(默认透传 `--yolo`)
|
|
62
|
+
- Zip 压缩/解压(优先系统工具,失败回退 JS 库)
|
|
63
|
+
|
|
64
|
+
## 架构总览
|
|
65
|
+
|
|
66
|
+
```mermaid
|
|
67
|
+
flowchart LR
|
|
68
|
+
A[CLI: codexmate] --> B[本地配置文件]
|
|
69
|
+
A --> C[本地 Web UI]
|
|
70
|
+
C --> D[内建 HTTP API]
|
|
71
|
+
D --> B
|
|
72
|
+
D --> E[会话索引与导出]
|
|
73
|
+
A --> F[MCP stdio server]
|
|
74
|
+
|
|
75
|
+
subgraph Local Files
|
|
76
|
+
B1[~/.codex/config.toml]
|
|
77
|
+
B2[~/.claude/settings.json]
|
|
78
|
+
B3[~/.openclaw/openclaw.json]
|
|
79
|
+
B4[sessions/*.jsonl]
|
|
80
|
+
end
|
|
81
|
+
|
|
82
|
+
B --> B1
|
|
83
|
+
B --> B2
|
|
84
|
+
B --> B3
|
|
85
|
+
E --> B4
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
## 快速开始
|
|
89
|
+
|
|
90
|
+
### npm 全局安装
|
|
132
91
|
|
|
133
92
|
```bash
|
|
93
|
+
npm install -g codexmate
|
|
94
|
+
codexmate setup
|
|
134
95
|
codexmate status
|
|
135
96
|
codexmate run
|
|
136
97
|
```
|
|
137
98
|
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
```bash
|
|
141
|
-
npx codexmate@latest status
|
|
142
|
-
npx codexmate@latest run
|
|
143
|
-
```
|
|
99
|
+
默认监听 `127.0.0.1:3737`,并尝试自动打开浏览器。
|
|
144
100
|
|
|
145
|
-
###
|
|
101
|
+
### 从源码运行
|
|
146
102
|
|
|
147
103
|
```bash
|
|
148
|
-
|
|
104
|
+
git clone https://github.com/SakuraByteCore/codexmate.git
|
|
105
|
+
cd codexmate
|
|
106
|
+
npm install
|
|
107
|
+
npm link
|
|
108
|
+
codexmate run
|
|
149
109
|
```
|
|
150
110
|
|
|
151
|
-
|
|
111
|
+
### 测试 / CI(只启动服务)
|
|
152
112
|
|
|
153
113
|
```bash
|
|
154
|
-
|
|
114
|
+
codexmate run --no-browser
|
|
155
115
|
```
|
|
156
116
|
|
|
157
|
-
|
|
117
|
+
> 约定:自动化测试仅验证服务与 API,不依赖打开页面。
|
|
158
118
|
|
|
159
|
-
|
|
160
|
-
- 支持 Windows / macOS / Linux
|
|
161
|
-
|
|
162
|
-
## 命令行速查
|
|
119
|
+
## 命令速查
|
|
163
120
|
|
|
164
121
|
| 命令 | 说明 |
|
|
165
122
|
| --- | --- |
|
|
166
|
-
| `codexmate` |
|
|
167
|
-
| `codexmate setup` |
|
|
168
|
-
| `codexmate
|
|
169
|
-
| `codexmate
|
|
170
|
-
| `codexmate
|
|
171
|
-
| `codexmate
|
|
172
|
-
| `codexmate
|
|
173
|
-
| `codexmate delete
|
|
174
|
-
| `codexmate
|
|
175
|
-
| `codexmate
|
|
176
|
-
| `codexmate
|
|
177
|
-
| `codexmate
|
|
178
|
-
| `codexmate run` | 启动 Web
|
|
179
|
-
| `codexmate mcp
|
|
180
|
-
| `codexmate export-session --source <codex
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
- 传输方式:仅支持 `stdio`
|
|
185
|
-
- 默认模式:只读工具集
|
|
186
|
-
- 写入工具开启方式:`--allow-write` 或 `CODEXMATE_MCP_ALLOW_WRITE=1`
|
|
187
|
-
- `codexmate.claude.settings.get` 的敏感字段默认脱敏返回
|
|
123
|
+
| `codexmate status` | 查看当前配置状态 |
|
|
124
|
+
| `codexmate setup` | 交互式初始化 |
|
|
125
|
+
| `codexmate list` / `codexmate models` | 查看提供商 / 模型 |
|
|
126
|
+
| `codexmate switch <provider>` / `codexmate use <model>` | 切换 provider / model |
|
|
127
|
+
| `codexmate add <name> <URL> [API_KEY]` | 添加提供商 |
|
|
128
|
+
| `codexmate delete <name>` | 删除提供商 |
|
|
129
|
+
| `codexmate claude <BaseURL> <API_KEY> [model]` | 写入 Claude Code 配置 |
|
|
130
|
+
| `codexmate auth <list\|import\|switch\|delete\|status>` | 认证档案管理 |
|
|
131
|
+
| `codexmate proxy <status\|set\|apply\|enable\|start\|stop>` | 内建代理管理 |
|
|
132
|
+
| `codexmate workflow <list\|get\|validate\|run\|runs>` | MCP 工作流管理 |
|
|
133
|
+
| `codexmate codex [args...] [--follow-up <文本> 可重复]` | Codex CLI 透传入口(默认补 `--yolo`,可追加 queued follow-up) |
|
|
134
|
+
| `codexmate qwen [args...]` | Qwen CLI 透传入口 |
|
|
135
|
+
| `codexmate run [--host <HOST>] [--no-browser]` | 启动 Web UI |
|
|
136
|
+
| `codexmate mcp serve [--read-only\|--allow-write]` | 启动 MCP stdio 服务 |
|
|
137
|
+
| `codexmate export-session --source <codex\|claude> ...` | 导出会话为 Markdown |
|
|
138
|
+
| `codexmate zip <path> [--max:0-9]` / `codexmate unzip <zip> [out]` | 压缩 / 解压 |
|
|
139
|
+
| `codexmate unzip-ext <zip-dir> [out] [--ext:suffix[,suffix...]] [--no-recursive]` | 批量提取目录下 ZIP 内指定后缀文件(默认 `.json`,默认递归) |
|
|
188
140
|
|
|
189
|
-
|
|
190
|
-
# 只读(推荐给外部 Agent 接入)
|
|
191
|
-
codexmate mcp serve --read-only
|
|
141
|
+
### Codex follow-up 追加(可选)
|
|
192
142
|
|
|
193
|
-
|
|
194
|
-
codexmate
|
|
143
|
+
```bash
|
|
144
|
+
codexmate codex --follow-up "先扫描项目" --follow-up "再修复失败测试"
|
|
145
|
+
codexmate codex --model gpt-5.3-codex --follow-up "步骤1" --follow-up "步骤2"
|
|
195
146
|
```
|
|
196
147
|
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
- `tools`:状态/提供商/模型/会话/认证/代理/配置等操作
|
|
200
|
-
- `resources`:status/providers/sessions 快照资源
|
|
201
|
-
- `prompts`:诊断/安全切换/会话导出模板
|
|
148
|
+
> 说明:`--follow-up` / `--queued-follow-up` 都可用,支持重复。
|
|
202
149
|
|
|
203
150
|
## Web 界面
|
|
204
151
|
|
|
205
|
-
启动 Web 界面(自动打开浏览器):
|
|
206
|
-
|
|
207
|
-
```bash
|
|
208
|
-
codexmate run
|
|
209
|
-
```
|
|
210
|
-
|
|
211
152
|
### Codex 配置模式
|
|
153
|
+
- provider / model 切换
|
|
154
|
+
- 模型管理
|
|
155
|
+
- `~/.codex/AGENTS.md` 编辑
|
|
156
|
+
- `~/.codex/skills` 管理(筛选、批量删除、跨应用导入)
|
|
212
157
|
|
|
213
|
-
- 查看当前提供商和模型状态
|
|
214
|
-
- 快速切换提供商与模型
|
|
215
|
-
- 管理可用模型列表
|
|
216
|
-
- 编辑 `~/.codex/AGENTS.md` 指令文件(与 `config.toml` 同级)
|
|
217
|
-
- 打开 `~/.codex/skills` 的 Skills 管理弹窗(统计概览、关键词/状态筛选、多选删除、跨应用扫描导入)
|
|
218
|
-
- 添加/删除自定义提供商
|
|
219
|
-
- 支持 Linux / Windows 环境下的 Codex 配置管理
|
|
220
158
|
|
|
221
|
-
###
|
|
222
|
-
|
|
223
|
-
-
|
|
224
|
-
-
|
|
225
|
-
- 支持本地 skills 多选后批量删除
|
|
226
|
-
- 支持扫描其他应用中未托管 skill,并勾选后批量导入
|
|
227
|
-
|
|
228
|
-
### Claude Code 配置模式(Windows / macOS / Linux)
|
|
229
|
-
|
|
230
|
-
- 管理多个 Claude Code 配置方案
|
|
231
|
-
- 配置 API Key、Base URL 和模型
|
|
232
|
-
- 默认写入 `~/.claude/settings.json` 的 `env` 字段:`env.ANTHROPIC_API_KEY` / `env.ANTHROPIC_BASE_URL` / `env.ANTHROPIC_MODEL`
|
|
233
|
-
- CLI 一行应用示例:
|
|
234
|
-
|
|
235
|
-
```bash
|
|
236
|
-
codexmate claude https://api.example.com/v1 sk-ant-xxx claude-3-7-sonnet
|
|
237
|
-
```
|
|
238
|
-
|
|
239
|
-
- Web 界面中每个 Claude 配置卡片新增“分享导入命令”按钮,可复制一条 `codexmate claude <BaseURL> <API Key> <模型>` 命令便于分享。
|
|
159
|
+
### Claude Code 配置模式
|
|
160
|
+
- 多配置方案管理
|
|
161
|
+
- 默认写入 `~/.claude/settings.json`
|
|
162
|
+
- 支持复制分享导入命令
|
|
240
163
|
|
|
241
164
|
### OpenClaw 配置模式
|
|
242
|
-
|
|
243
|
-
- 管理多个 OpenClaw JSON5 配置方案
|
|
165
|
+
- JSON5 多方案管理
|
|
244
166
|
- 应用到 `~/.openclaw/openclaw.json`
|
|
245
|
-
- 管理
|
|
167
|
+
- 管理 `~/.openclaw/workspace/AGENTS.md`
|
|
246
168
|
|
|
247
|
-
###
|
|
169
|
+
### 会话模式
|
|
170
|
+
- Codex + Claude 会话统一列表
|
|
171
|
+
- 搜索、筛选、导出、删除、批量清理
|
|
248
172
|
|
|
249
|
-
|
|
250
|
-
- 支持按来源筛选(Codex / Claude / 全部)
|
|
251
|
-
- 支持按已有会话路径(cwd)筛选,选择后自动刷新
|
|
252
|
-
- 支持一键导出指定会话为 Markdown
|
|
253
|
-
- 支持在可用时复制恢复命令
|
|
254
|
-
- 支持删除指定会话(本地 jsonl 记录)
|
|
255
|
-
- 支持勾选多条会话并批量删除,部分失败会汇总提示
|
|
256
|
-
- 支持在会话详情内单条删除记录或多选批量删除记录(写回原始 jsonl)
|
|
173
|
+
## MCP
|
|
257
174
|
|
|
258
|
-
|
|
175
|
+
> 传输:`stdio`
|
|
259
176
|
|
|
260
|
-
-
|
|
261
|
-
-
|
|
262
|
-
-
|
|
177
|
+
- 传输:仅 `stdio`
|
|
178
|
+
- 默认:只读工具集
|
|
179
|
+
- 写入开启:`--allow-write` 或 `CODEXMATE_MCP_ALLOW_WRITE=1`
|
|
180
|
+
- 包含域:`tools`、`resources`、`prompts`
|
|
263
181
|
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
配置文件位于 `~/.codex/` 目录:
|
|
267
|
-
|
|
268
|
-
- `config.toml` - Codex 主配置文件
|
|
269
|
-
- `auth.json` - API 认证信息
|
|
270
|
-
- `models.json` - 可用模型列表
|
|
271
|
-
- `provider-current-models.json` - 提供商当前模型配置
|
|
272
|
-
- `codexmate-init.json` - 首次初始化标记(用于避免重复重置)
|
|
273
|
-
- `config.toml.codexmate-backup-*.bak` - 首次初始化时自动备份的旧配置(若存在)
|
|
274
|
-
|
|
275
|
-
Claude Code 配置应用涉及:
|
|
276
|
-
|
|
277
|
-
- `~/.claude/settings.json` - Claude Code 运行时配置(默认写入目标)
|
|
278
|
-
- `~/.claude/settings.json.codexmate-backup-*.bak` - 首次改写前自动备份(若存在旧文件)
|
|
279
|
-
|
|
280
|
-
OpenClaw 配置涉及:
|
|
281
|
-
|
|
282
|
-
- `~/.openclaw/openclaw.json` - OpenClaw 配置(JSON5)
|
|
283
|
-
- `~/.openclaw/workspace/AGENTS.md` - OpenClaw Workspace 指令文件
|
|
284
|
-
|
|
285
|
-
## 首次运行初始化说明
|
|
286
|
-
|
|
287
|
-
首次运行 `codexmate` 且检测到已有 `~/.codex/config.toml` 且不是 Codex Mate 管理的配置时,会发生以下行为:
|
|
288
|
-
|
|
289
|
-
- 会先自动备份原文件为 `config.toml.codexmate-backup-时间戳.bak`
|
|
290
|
-
- 默认保留原 `config.toml` 不覆盖,并写入初始化标记
|
|
291
|
-
- 仅在显式设置环境变量 `CODEXMATE_FORCE_RESET_EXISTING_CONFIG=1` 时,才会重建默认配置
|
|
292
|
-
- 后续运行不会重复处理,避免影响已稳定使用的用户配置
|
|
293
|
-
|
|
294
|
-
## 使用示例
|
|
295
|
-
|
|
296
|
-
### 添加自定义 API 提供商
|
|
297
|
-
|
|
298
|
-
```bash
|
|
299
|
-
codexmate add myapi https://api.example.com/v1 sk-your-api-key
|
|
300
|
-
codexmate switch myapi
|
|
301
|
-
```
|
|
302
|
-
|
|
303
|
-
### 切换到不同的模型
|
|
304
|
-
|
|
305
|
-
```bash
|
|
306
|
-
codexmate use gpt-4-turbo
|
|
307
|
-
```
|
|
308
|
-
|
|
309
|
-
### 导出会话(CLI)
|
|
310
|
-
|
|
311
|
-
```bash
|
|
312
|
-
codexmate export-session --source codex --session-id 123456
|
|
313
|
-
codexmate export-session --source claude --file "~/.claude/projects/demo/session.jsonl" --max-messages=all
|
|
314
|
-
```
|
|
315
|
-
|
|
316
|
-
默认最多导出 1000 条消息;如需完整导出可用 `--max-messages=all`(或 `Infinity`)。
|
|
317
|
-
|
|
318
|
-
### 配置 Claude Code(跨平台)
|
|
319
|
-
|
|
320
|
-
1. 启动 Web 界面:`codexmate run`
|
|
321
|
-
2. 在浏览器中切换到 "Claude Code 配置" 模式
|
|
322
|
-
3. 添加配置方案(例如智谱 GLM):配置名称=智谱GLM,API Key=你的 API Key,Base URL=`https://open.bigmodel.cn/api/anthropic`,模型=`glm-4.7`
|
|
323
|
-
4. 点击配置卡片直接应用,或在编辑弹窗点击“保存并应用到 Claude 配置”
|
|
324
|
-
5. 默认写入 `~/.claude/settings.json`
|
|
325
|
-
6. 重启 Claude Code,新的配置即生效
|
|
326
|
-
|
|
327
|
-
### 启动 Web 界面
|
|
328
|
-
|
|
329
|
-
```bash
|
|
330
|
-
codexmate run
|
|
331
|
-
```
|
|
332
|
-
|
|
333
|
-
默认仅监听 `127.0.0.1`。如需局域网访问,可用 `--host` 或 `CODEXMATE_HOST`:
|
|
334
|
-
|
|
335
|
-
```bash
|
|
336
|
-
codexmate run --host 0.0.0.0
|
|
337
|
-
```
|
|
338
|
-
|
|
339
|
-
然后在浏览器中打开 `http://localhost:3737`(或你指定的地址)。注意:监听 `0.0.0.0` 在不可信网络下不安全。
|
|
340
|
-
|
|
341
|
-
## 常见问题
|
|
342
|
-
|
|
343
|
-
### Q: 支持哪些操作系统?
|
|
344
|
-
|
|
345
|
-
A: Codex 功能支持 Windows 和 Linux(CLI 与 Web)。Claude Code 配置应用默认支持 Windows / macOS / Linux(写入 `~/.claude/settings.json`)。
|
|
346
|
-
|
|
347
|
-
### Q: API key 存储在哪里?
|
|
348
|
-
|
|
349
|
-
A: API key 存储在本地配置文件 `~/.codex/config.toml` 中,不会上传到任何服务器。
|
|
350
|
-
|
|
351
|
-
### Q: Web 界面安全吗?
|
|
352
|
-
|
|
353
|
-
A: Web 界面运行在本地,所有操作都在本地完成。API key 在界面中仅显示脱敏版本。
|
|
354
|
-
|
|
355
|
-
### Q: Claude Code 配置后如何生效?
|
|
356
|
-
|
|
357
|
-
A: 点击“应用到 Claude 配置”后会写入 `~/.claude/settings.json`,重启 Claude Code 即生效。
|
|
358
|
-
|
|
359
|
-
### Q: 如何卸载?
|
|
360
|
-
|
|
361
|
-
A: 运行 `npm uninstall -g codexmate`。
|
|
362
|
-
|
|
363
|
-
## 附属功能:压缩/解压
|
|
364
|
-
|
|
365
|
-
优先使用 7-Zip 多线程压缩/解压。缺失时回退内置 JS 库。
|
|
182
|
+
示例:
|
|
366
183
|
|
|
367
184
|
```bash
|
|
368
|
-
|
|
369
|
-
codexmate
|
|
370
|
-
|
|
371
|
-
# 指定压缩级别(0-9,0=仅存储,9=极限压缩)
|
|
372
|
-
codexmate zip <路径> --max:9
|
|
373
|
-
|
|
374
|
-
# 解压 zip 文件(默认解压到同级目录下同名文件夹)
|
|
375
|
-
codexmate unzip <zip文件路径>
|
|
376
|
-
|
|
377
|
-
# 解压到指定目录
|
|
378
|
-
codexmate unzip <zip文件路径> <输出目录>
|
|
185
|
+
codexmate mcp serve --read-only
|
|
186
|
+
codexmate mcp serve --allow-write
|
|
379
187
|
```
|
|
380
188
|
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
```bash
|
|
384
|
-
# 压缩项目文件夹
|
|
385
|
-
codexmate zip ./my-project
|
|
386
|
-
|
|
387
|
-
# 极限压缩
|
|
388
|
-
codexmate zip ./my-project --max:9
|
|
389
|
-
|
|
390
|
-
# 快速压缩(仅存储)
|
|
391
|
-
codexmate zip ./large-folder --max:0
|
|
189
|
+
## 配置文件
|
|
392
190
|
|
|
393
|
-
|
|
394
|
-
|
|
191
|
+
- `~/.codex/config.toml`
|
|
192
|
+
- `~/.codex/auth.json`
|
|
193
|
+
- `~/.codex/models.json`
|
|
194
|
+
- `~/.codex/provider-current-models.json`
|
|
195
|
+
- `~/.claude/settings.json`
|
|
196
|
+
- `~/.openclaw/openclaw.json`
|
|
197
|
+
- `~/.openclaw/workspace/AGENTS.md`
|
|
395
198
|
|
|
396
|
-
|
|
397
|
-
codexmate unzip ./backup.zip D:/restored
|
|
398
|
-
```
|
|
199
|
+
## 环境变量
|
|
399
200
|
|
|
400
|
-
|
|
201
|
+
| 变量 | 默认值 | 说明 |
|
|
202
|
+
| --- | --- | --- |
|
|
203
|
+
| `CODEXMATE_PORT` | `3737` | Web 服务端口 |
|
|
204
|
+
| `CODEXMATE_HOST` | `127.0.0.1` | Web 服务监听地址 |
|
|
205
|
+
| `CODEXMATE_NO_BROWSER` | 未设置 | 设为 `1` 后不自动打开浏览器 |
|
|
206
|
+
| `CODEXMATE_MCP_ALLOW_WRITE` | 未设置 | 设为 `1` 后默认允许 MCP 写工具 |
|
|
207
|
+
| `CODEXMATE_FORCE_RESET_EXISTING_CONFIG` | `0` | 设为 `1` 时首次可强制重建托管配置 |
|
|
401
208
|
|
|
402
209
|
## 技术栈
|
|
403
210
|
|
|
404
|
-
-
|
|
405
|
-
-
|
|
406
|
-
-
|
|
407
|
-
-
|
|
408
|
-
|
|
409
|
-
## 发布(GitHub Actions)
|
|
410
|
-
|
|
411
|
-
创建与 `package.json` 版本一致的标签(例如 `v0.0.14`)。然后在 GitHub Actions 中手动运行 `release` 工作流并输入该标签,系统会创建 GitHub Release,并附带 `npm pack` 生成的 `.tgz` 产物。
|
|
412
|
-
|
|
413
|
-
## 许可证
|
|
211
|
+
- Node.js
|
|
212
|
+
- Vue.js 3(Web UI)
|
|
213
|
+
- 原生 HTTP Server
|
|
214
|
+
- `@iarna/toml`、`json5`
|
|
414
215
|
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
## 贡献
|
|
216
|
+
## 参与贡献
|
|
418
217
|
|
|
419
218
|
欢迎提交 Issue 和 Pull Request。
|
|
420
219
|
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
英文版见 [doc/CHANGELOG.md](doc/CHANGELOG.md)。
|
|
424
|
-
中文版见 [doc/CHANGELOG.zh-CN.md](doc/CHANGELOG.zh-CN.md)。
|
|
425
|
-
|
|
426
|
-
---
|
|
220
|
+
- 英文更新日志:`doc/CHANGELOG.md`
|
|
221
|
+
- 中文更新日志:`doc/CHANGELOG.zh-CN.md`
|
|
427
222
|
|
|
428
|
-
|
|
223
|
+
## License
|
|
429
224
|
|
|
225
|
+
Apache-2.0
|