codexmate 0.0.4 → 0.0.5
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/.github/ISSUE_TEMPLATE/bug_report.md +27 -0
- package/.github/ISSUE_TEMPLATE/feature_request.md +17 -0
- package/CHANGELOG.md +7 -0
- package/CHANGELOG.zh-CN.md +7 -0
- package/README.md +89 -54
- package/README.zh-CN.md +97 -58
- package/cli.js +1594 -411
- package/package.json +11 -5
- package/tests/e2e/recent-health.e2e.js +135 -0
- package/tests/e2e/run.js +294 -0
- package/web-ui.html +987 -548
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: Bug report
|
|
3
|
+
about: Report a problem with Codex Mate
|
|
4
|
+
labels: bug
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
**Summary**
|
|
8
|
+
A clear and concise description of the bug.
|
|
9
|
+
|
|
10
|
+
**Steps to reproduce**
|
|
11
|
+
1.
|
|
12
|
+
2.
|
|
13
|
+
3.
|
|
14
|
+
|
|
15
|
+
**Expected behavior**
|
|
16
|
+
What you expected to happen.
|
|
17
|
+
|
|
18
|
+
**Actual behavior**
|
|
19
|
+
What actually happened.
|
|
20
|
+
|
|
21
|
+
**Environment**
|
|
22
|
+
- OS:
|
|
23
|
+
- Node.js version:
|
|
24
|
+
- Codex Mate version:
|
|
25
|
+
|
|
26
|
+
**Logs or screenshots**
|
|
27
|
+
Paste relevant logs or screenshots.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: Feature request
|
|
3
|
+
about: Suggest a new idea for Codex Mate
|
|
4
|
+
labels: enhancement
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
**Problem**
|
|
8
|
+
What problem are you trying to solve?
|
|
9
|
+
|
|
10
|
+
**Proposed solution**
|
|
11
|
+
Describe the solution you want.
|
|
12
|
+
|
|
13
|
+
**Alternatives**
|
|
14
|
+
Any alternative solutions or features you considered.
|
|
15
|
+
|
|
16
|
+
**Additional context**
|
|
17
|
+
Add any other context or screenshots.
|
package/CHANGELOG.md
ADDED
package/README.md
CHANGED
|
@@ -1,60 +1,76 @@
|
|
|
1
1
|
# Codex Mate
|
|
2
2
|
|
|
3
|
-
> A lightweight AI configuration assistant:
|
|
3
|
+
> A lightweight AI configuration assistant: quickly switch Codex providers/models and Claude Code configs, with a unified session browser
|
|
4
4
|
|
|
5
5
|
[](https://github.com/ymkiux/codexmate/actions/workflows/release.yml) [](https://www.npmjs.com/package/codexmate) [](https://github.com/ymkiux/codexmate)
|
|
6
6
|
[](https://github.com/ymkiux/codexmate/commits) [](LICENSE) [](https://nodejs.org)
|
|
7
7
|
|
|
8
8
|
English | [Chinese](README.zh-CN.md)
|
|
9
9
|
|
|
10
|
-
## Overview
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
## Release Notes (0.0.4)
|
|
15
|
-
|
|
16
|
-
- Added OpenClaw config mode with JSON5 profiles and one-click apply
|
|
17
|
-
- Added OpenClaw workspace AGENTS.md management
|
|
18
|
-
- Added JSON5 parsing dependency
|
|
19
|
-
|
|
20
|
-
|
|
10
|
+
## Overview
|
|
11
|
+
|
|
12
|
+
Codex Mate makes frequent provider/model switching for Codex and Claude Code a single command or click, and gives you a unified session browser to view/export local sessions from both.
|
|
13
|
+
|
|
14
|
+
## Release Notes (0.0.4)
|
|
15
|
+
|
|
16
|
+
- Added OpenClaw config mode with JSON5 profiles and one-click apply
|
|
17
|
+
- Added OpenClaw workspace AGENTS.md management
|
|
18
|
+
- Added JSON5 parsing dependency
|
|
19
|
+
|
|
20
|
+
See [CHANGELOG.md](CHANGELOG.md) and [Releases](https://github.com/ymkiux/codexmate/releases) for the full history.
|
|
21
|
+
|
|
22
|
+
## What You Get
|
|
21
23
|
|
|
22
24
|
- Faster provider/model switching
|
|
23
25
|
- More controllable local configuration management
|
|
24
26
|
- A visual Web UI to reduce CLI burden
|
|
25
27
|
- Change tracking with backups
|
|
28
|
+
- A unified session browser for Codex + Claude Code (view/export/copy resume command when available)
|
|
26
29
|
|
|
27
30
|
## Feature Overview
|
|
28
31
|
|
|
29
|
-
| Module | Problem | Key Capabilities |
|
|
30
|
-
| --- | --- | --- |
|
|
31
|
-
| Codex Config | Switching providers/models is painful | Provider/model switching, model management, CLI + Web entry points, template-confirmed writes |
|
|
32
|
-
| Claude Code Config | Multiple profiles and inconsistent write paths | Profile management, default write to `~/.claude/settings.json
|
|
33
|
-
| OpenClaw Config | OpenClaw configs are scattered | JSON5 profiles, apply to `~/.openclaw/openclaw.json`, AGENTS workspace management |
|
|
34
|
-
| Session Browser | Local sessions are hard to track | List/filter sessions, export to Markdown, delete and batch cleanup |
|
|
35
|
-
| Utilities | Compression/extraction requires extra tools | Multithreaded compress/unzip via 7-Zip |
|
|
32
|
+
| Module | Problem | Key Capabilities |
|
|
33
|
+
| --- | --- | --- |
|
|
34
|
+
| Codex Config | Switching providers/models is painful | Provider/model switching, model management, CLI + Web entry points, template-confirmed writes |
|
|
35
|
+
| Claude Code Config | Multiple profiles and inconsistent write paths | Profile management, default write to `~/.claude/settings.json` |
|
|
36
|
+
| OpenClaw Config | OpenClaw configs are scattered | JSON5 profiles, apply to `~/.openclaw/openclaw.json`, AGENTS workspace management |
|
|
37
|
+
| Session Browser | Local sessions are hard to track | List/filter sessions, export to Markdown, copy resume command (when available), delete and batch cleanup |
|
|
38
|
+
| Utilities | Compression/extraction requires extra tools | Multithreaded compress/unzip via 7-Zip |
|
|
36
39
|
|
|
37
40
|
## Why Codex Mate
|
|
38
41
|
|
|
39
|
-
- Focused on three jobs: Codex provider/model switching + Claude Code config apply + OpenClaw config apply
|
|
42
|
+
- Focused on three jobs: Codex provider/model switching + Claude Code config apply + OpenClaw config apply
|
|
40
43
|
- Local-first: configs and API keys are written to local files, not the cloud
|
|
41
44
|
- Lightweight: CLI + Web, no desktop app required
|
|
42
45
|
- Reversible: auto-backup before first takeover
|
|
43
46
|
|
|
44
47
|
## Use Cases
|
|
45
48
|
|
|
46
|
-
- Frequent provider/model switching, want a one-command flow
|
|
47
|
-
- Use both Codex and Claude Code, want a single entry point
|
|
48
|
-
-
|
|
49
|
-
-
|
|
50
|
-
-
|
|
49
|
+
- Frequent provider/model switching, want a one-command flow
|
|
50
|
+
- Use both Codex and Claude Code, want a single entry point
|
|
51
|
+
- Need to browse/export local Codex + Claude Code sessions and copy resume commands when available
|
|
52
|
+
- Use OpenClaw with multiple profiles, want quick switching
|
|
53
|
+
- Multi-project or multi-environment setups that need quick config changes
|
|
54
|
+
- Want a visual UI without a heavy client
|
|
51
55
|
|
|
52
56
|
## Scope and Boundaries
|
|
53
57
|
|
|
54
|
-
- Only configuration management for Codex, Claude Code, and OpenClaw, not a full all-in-one tool suite
|
|
58
|
+
- Only configuration management for Codex, Claude Code, and OpenClaw, not a full all-in-one tool suite
|
|
55
59
|
- No built-in proxy/relay/billing dashboard/cloud sync (kept lightweight)
|
|
56
60
|
- Web UI runs only when you start it (`codexmate start`)
|
|
57
61
|
|
|
62
|
+
## 30-Second Start (No Install)
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
npx codexmate@latest status
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npx codexmate@latest start
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
Then open `http://localhost:3737` in your browser.
|
|
73
|
+
|
|
58
74
|
## Quick Start
|
|
59
75
|
|
|
60
76
|
1. Install (global):
|
|
@@ -67,18 +83,27 @@ Or run once without install:
|
|
|
67
83
|
npx codexmate@latest status
|
|
68
84
|
```
|
|
69
85
|
|
|
70
|
-
2.
|
|
86
|
+
2. Run the interactive setup:
|
|
87
|
+
```bash
|
|
88
|
+
codexmate setup
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
3. Check status:
|
|
71
92
|
```bash
|
|
72
93
|
codexmate status
|
|
73
94
|
```
|
|
74
95
|
|
|
75
|
-
|
|
96
|
+
4. Start the Web UI:
|
|
76
97
|
```bash
|
|
77
98
|
codexmate start
|
|
78
99
|
```
|
|
79
100
|
|
|
80
101
|
Then open `http://localhost:3737` in your browser.
|
|
81
102
|
|
|
103
|
+
## Alternatives
|
|
104
|
+
|
|
105
|
+
- cc-switch: https://github.com/farion1231/cc-switch
|
|
106
|
+
|
|
82
107
|
## UI Preview
|
|
83
108
|
|
|
84
109
|

|
|
@@ -93,10 +118,19 @@ npm install -g codexmate
|
|
|
93
118
|
|
|
94
119
|
Package name on npm: `codexmate`.
|
|
95
120
|
|
|
121
|
+
Want to update to the latest effects features each time? Install from GitHub (re-run to update):
|
|
122
|
+
|
|
123
|
+
```bash
|
|
124
|
+
npm install -g ymkiux/codexmate
|
|
125
|
+
```
|
|
126
|
+
|
|
96
127
|
### Run with npx (No Install)
|
|
97
128
|
|
|
98
129
|
```bash
|
|
99
130
|
npx codexmate@latest status
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
```bash
|
|
100
134
|
npx codexmate@latest start
|
|
101
135
|
```
|
|
102
136
|
|
|
@@ -119,6 +153,7 @@ npm link
|
|
|
119
153
|
| Command | Description |
|
|
120
154
|
| --- | --- |
|
|
121
155
|
| `codexmate` | Show help and available commands |
|
|
156
|
+
| `codexmate setup` | Interactive configuration wizard |
|
|
122
157
|
| `codexmate status` | Show current status |
|
|
123
158
|
| `codexmate list` | List all providers |
|
|
124
159
|
| `codexmate switch <provider>` | Switch provider |
|
|
@@ -147,25 +182,25 @@ codexmate start
|
|
|
147
182
|
- Add/delete custom providers
|
|
148
183
|
- Supports Codex config management on Linux/Windows
|
|
149
184
|
|
|
150
|
-
### Claude Code Config Mode (Windows / macOS / Linux)
|
|
151
|
-
|
|
152
|
-
- Manage multiple Claude Code profiles
|
|
153
|
-
- Configure API key, Base URL, and model
|
|
154
|
-
- Default write to `env` in `~/.claude/settings.json`: `env.ANTHROPIC_API_KEY` / `env.
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
-
|
|
160
|
-
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
### Session Browser
|
|
185
|
+
### Claude Code Config Mode (Windows / macOS / Linux)
|
|
186
|
+
|
|
187
|
+
- Manage multiple Claude Code profiles
|
|
188
|
+
- Configure API key, Base URL, and model
|
|
189
|
+
- Default write to `env` in `~/.claude/settings.json`: `env.ANTHROPIC_API_KEY` / `env.ANTHROPIC_BASE_URL` / `env.ANTHROPIC_MODEL`
|
|
190
|
+
|
|
191
|
+
### OpenClaw Config Mode
|
|
192
|
+
|
|
193
|
+
- Manage multiple OpenClaw JSON5 profiles
|
|
194
|
+
- Apply to `~/.openclaw/openclaw.json`
|
|
195
|
+
- Manage `AGENTS.md` under the OpenClaw Workspace (default: `~/.openclaw/workspace/AGENTS.md`)
|
|
196
|
+
|
|
197
|
+
### Session Browser
|
|
164
198
|
|
|
165
199
|
- View local Codex and Claude Code sessions in one page
|
|
166
200
|
- Filter by source (Codex / Claude / All)
|
|
167
201
|
- Filter by session path (cwd), auto refresh on selection
|
|
168
202
|
- Export selected sessions to Markdown
|
|
203
|
+
- Copy resume command when available
|
|
169
204
|
- Delete single sessions (local jsonl records)
|
|
170
205
|
- Batch delete multiple sessions with partial failure summary
|
|
171
206
|
- Delete individual records or multi-select within session details (writes back to original jsonl)
|
|
@@ -187,15 +222,15 @@ Config directory: `~/.codex/`
|
|
|
187
222
|
- `codexmate-init.json` - First-run marker
|
|
188
223
|
- `config.toml.codexmate-backup-*.bak` - Backup created on first takeover
|
|
189
224
|
|
|
190
|
-
Claude Code config files:
|
|
191
|
-
|
|
192
|
-
- `~/.claude/settings.json` - Runtime config (default write target)
|
|
193
|
-
- `~/.claude/settings.json.codexmate-backup-*.bak` - Backup before first overwrite
|
|
194
|
-
|
|
195
|
-
OpenClaw config files:
|
|
196
|
-
|
|
197
|
-
- `~/.openclaw/openclaw.json` - OpenClaw config (JSON5)
|
|
198
|
-
- `~/.openclaw/workspace/AGENTS.md` - OpenClaw workspace instructions
|
|
225
|
+
Claude Code config files:
|
|
226
|
+
|
|
227
|
+
- `~/.claude/settings.json` - Runtime config (default write target)
|
|
228
|
+
- `~/.claude/settings.json.codexmate-backup-*.bak` - Backup before first overwrite
|
|
229
|
+
|
|
230
|
+
OpenClaw config files:
|
|
231
|
+
|
|
232
|
+
- `~/.openclaw/openclaw.json` - OpenClaw config (JSON5)
|
|
233
|
+
- `~/.openclaw/workspace/AGENTS.md` - OpenClaw workspace instructions
|
|
199
234
|
|
|
200
235
|
## First Run Initialization
|
|
201
236
|
|
|
@@ -227,7 +262,7 @@ codexmate use gpt-4-turbo
|
|
|
227
262
|
2. Switch to "Claude Code Config" mode in the browser
|
|
228
263
|
3. Add a profile (example Zhipu GLM): Name=ZhipuGLM, API Key=your API key, Base URL=`https://open.bigmodel.cn/api/anthropic`, Model=`glm-4.7`
|
|
229
264
|
4. Click the card to apply, or use "Save & Apply to Claude Config" in the editor
|
|
230
|
-
5. Default write to `~/.claude/settings.json
|
|
265
|
+
5. Default write to `~/.claude/settings.json`
|
|
231
266
|
6. Restart Claude Code to apply
|
|
232
267
|
|
|
233
268
|
### Start the Web UI
|
|
@@ -242,7 +277,7 @@ Then open `http://localhost:3737`.
|
|
|
242
277
|
|
|
243
278
|
### Q: Which operating systems are supported?
|
|
244
279
|
|
|
245
|
-
A: Codex features support Windows and Linux (CLI and Web). Claude Code config applies to Windows / macOS / Linux (writes to `~/.claude/settings.json`).
|
|
280
|
+
A: Codex features support Windows and Linux (CLI and Web). Claude Code config applies to Windows / macOS / Linux (writes to `~/.claude/settings.json`).
|
|
246
281
|
|
|
247
282
|
### Q: Where are API keys stored?
|
|
248
283
|
|
|
@@ -254,7 +289,7 @@ A: The Web UI runs locally; all operations happen on your machine. API keys are
|
|
|
254
289
|
|
|
255
290
|
### Q: How do Claude Code configs take effect?
|
|
256
291
|
|
|
257
|
-
A: After clicking "Apply to Claude Config", it writes to `~/.claude/settings.json`. Restart Claude Code to apply.
|
|
292
|
+
A: After clicking "Apply to Claude Config", it writes to `~/.claude/settings.json`. Restart Claude Code to apply.
|
|
258
293
|
|
|
259
294
|
### Q: How to uninstall?
|
|
260
295
|
|
package/README.zh-CN.md
CHANGED
|
@@ -1,56 +1,76 @@
|
|
|
1
1
|
# Codex Mate
|
|
2
2
|
|
|
3
|
-
> 轻量级 AI
|
|
3
|
+
> 轻量级 AI 工具配置助手:快速切换 Codex 提供商/模型与 Claude Code 配置,并统一管理两者会话
|
|
4
4
|
|
|
5
5
|
[](https://github.com/ymkiux/codexmate/actions/workflows/release.yml) [](https://www.npmjs.com/package/codexmate) [](https://github.com/ymkiux/codexmate)
|
|
6
6
|
[](https://github.com/ymkiux/codexmate/commits) [](LICENSE) [](https://nodejs.org)
|
|
7
7
|
|
|
8
8
|
[English](README.md) | 中文
|
|
9
9
|
|
|
10
|
-
##
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
10
|
+
## 概览
|
|
11
|
+
|
|
12
|
+
Codex Mate 让 Codex 与 Claude Code 的提供商/模型切换变成“一条命令或一次点击”,并在同一 Web 页面浏览、导出两者的本地会话记录。
|
|
13
|
+
|
|
14
|
+
## 你能获得什么
|
|
15
|
+
|
|
16
|
+
- 更快的模型/提供商切换
|
|
17
|
+
- 更可控的本地配置管理
|
|
18
|
+
- 可视化 Web 操作,降低命令行负担
|
|
19
|
+
- 配置变更可回溯、有备份
|
|
20
|
+
- Codex + Claude Code 统一会话浏览(查看/导出/可用时复制恢复命令)
|
|
21
|
+
|
|
22
|
+
## 更新说明(0.0.4)
|
|
23
|
+
|
|
24
|
+
- 新增 OpenClaw 配置模式(JSON5 多配置管理 + 一键应用)
|
|
25
|
+
- 新增 OpenClaw Workspace 的 AGENTS.md 管理
|
|
26
|
+
- 增加 JSON5 解析依赖
|
|
27
|
+
|
|
28
|
+
完整更新记录见 [CHANGELOG.zh-CN.md](CHANGELOG.zh-CN.md) 与 [Releases](https://github.com/ymkiux/codexmate/releases)。
|
|
29
|
+
|
|
30
|
+
## 功能总览
|
|
31
|
+
|
|
32
|
+
| 模块 | 解决的问题 | 关键能力 |
|
|
33
|
+
| --- | --- | --- |
|
|
34
|
+
| Codex 配置 | 多提供商/多模型切换麻烦 | 提供商/模型切换、模型管理、CLI + Web 双入口、模板确认写入 |
|
|
35
|
+
| Claude Code 配置 | 多方案共存、写入路径不统一 | 多配置方案管理、默认写入 `~/.claude/settings.json` |
|
|
36
|
+
| OpenClaw 配置 | OpenClaw 配置分散 | JSON5 多配置管理、应用到 `~/.openclaw/openclaw.json`、Workspace 指令文件管理 |
|
|
37
|
+
| 会话浏览 | 本地会话难以追踪 | 会话列表/筛选、Markdown 导出、可用时复制恢复命令、删除与批量清理 |
|
|
38
|
+
| 附属工具 | 压缩/解压需额外工具 | 基于 7-Zip 的多线程压缩/解压 |
|
|
32
39
|
|
|
33
40
|
## 为什么选择 Codex Mate
|
|
34
41
|
|
|
35
|
-
- 聚焦三件事:Codex 提供商/模型切换 + Claude Code 配置应用 + OpenClaw 配置应用
|
|
42
|
+
- 聚焦三件事:Codex 提供商/模型切换 + Claude Code 配置应用 + OpenClaw 配置应用
|
|
36
43
|
- 本地优先:配置与 API Key 写入本地文件,不走云端
|
|
37
44
|
- 轻量好用:CLI + Web 双入口,无需安装桌面端
|
|
38
45
|
- 可回退:首次接管前自动备份旧配置
|
|
39
46
|
|
|
40
47
|
## 适用场景
|
|
41
48
|
|
|
42
|
-
- 频繁切换提供商/模型,想要一条命令完成
|
|
43
|
-
- 同时用 Codex 与 Claude Code,需要统一入口
|
|
44
|
-
-
|
|
45
|
-
-
|
|
46
|
-
-
|
|
49
|
+
- 频繁切换提供商/模型,想要一条命令完成
|
|
50
|
+
- 同时用 Codex 与 Claude Code,需要统一入口
|
|
51
|
+
- 需要浏览/导出本地会话记录,并在可用时复制恢复命令
|
|
52
|
+
- 使用 OpenClaw 多配置,希望快速切换
|
|
53
|
+
- 多项目/多环境切换,希望快速改写配置
|
|
54
|
+
- 想可视化改配置但又不想上大体量客户端
|
|
47
55
|
|
|
48
56
|
## 范围与边界
|
|
49
57
|
|
|
50
|
-
- 只做 Codex、Claude Code 与 OpenClaw 的配置管理,不做全量多工具一体化
|
|
58
|
+
- 只做 Codex、Claude Code 与 OpenClaw 的配置管理,不做全量多工具一体化
|
|
51
59
|
- 不内置代理/转发/费用面板/云同步(保持轻量)
|
|
52
60
|
- Web UI 仅在你启动时运行(`codexmate start`)
|
|
53
61
|
|
|
62
|
+
## 30 秒上手(免安装)
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
npx codexmate@latest status
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npx codexmate@latest start
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
然后在浏览器中打开 `http://localhost:3737`。
|
|
73
|
+
|
|
54
74
|
## 快速开始
|
|
55
75
|
|
|
56
76
|
1. 安装(全局):
|
|
@@ -63,18 +83,27 @@ npm install -g codexmate
|
|
|
63
83
|
npx codexmate@latest status
|
|
64
84
|
```
|
|
65
85
|
|
|
66
|
-
2.
|
|
86
|
+
2. 运行交互式配置向导:
|
|
87
|
+
```bash
|
|
88
|
+
codexmate setup
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
3. 查看当前状态:
|
|
67
92
|
```bash
|
|
68
93
|
codexmate status
|
|
69
94
|
```
|
|
70
95
|
|
|
71
|
-
|
|
96
|
+
4. 启动 Web 界面:
|
|
72
97
|
```bash
|
|
73
98
|
codexmate start
|
|
74
99
|
```
|
|
75
100
|
|
|
76
101
|
然后在浏览器中打开 `http://localhost:3737`。
|
|
77
102
|
|
|
103
|
+
## 竞品/替代
|
|
104
|
+
|
|
105
|
+
- cc-switch: https://github.com/farion1231/cc-switch
|
|
106
|
+
|
|
78
107
|
## 界面预览
|
|
79
108
|
|
|
80
109
|

|
|
@@ -89,10 +118,19 @@ npm install -g codexmate
|
|
|
89
118
|
|
|
90
119
|
npm 包名:`codexmate`。
|
|
91
120
|
|
|
121
|
+
若希望每次执行都能更新到最新特效功能,可使用 GitHub 源安装(重复执行即可更新):
|
|
122
|
+
|
|
123
|
+
```bash
|
|
124
|
+
npm install -g ymkiux/codexmate
|
|
125
|
+
```
|
|
126
|
+
|
|
92
127
|
### 使用 npx(免安装)
|
|
93
128
|
|
|
94
129
|
```bash
|
|
95
130
|
npx codexmate@latest status
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
```bash
|
|
96
134
|
npx codexmate@latest start
|
|
97
135
|
```
|
|
98
136
|
|
|
@@ -115,6 +153,7 @@ npm link
|
|
|
115
153
|
| 命令 | 说明 |
|
|
116
154
|
| --- | --- |
|
|
117
155
|
| `codexmate` | 查看帮助与可用命令 |
|
|
156
|
+
| `codexmate setup` | 交互式配置向导 |
|
|
118
157
|
| `codexmate status` | 查看当前状态 |
|
|
119
158
|
| `codexmate list` | 列出所有提供商 |
|
|
120
159
|
| `codexmate switch <提供商名称>` | 切换提供商 |
|
|
@@ -143,25 +182,25 @@ codexmate start
|
|
|
143
182
|
- 添加/删除自定义提供商
|
|
144
183
|
- 支持 Linux / Windows 环境下的 Codex 配置管理
|
|
145
184
|
|
|
146
|
-
### Claude Code 配置模式(Windows / macOS / Linux)
|
|
147
|
-
|
|
148
|
-
- 管理多个 Claude Code 配置方案
|
|
149
|
-
- 配置 API Key、Base URL 和模型
|
|
150
|
-
- 默认写入 `~/.claude/settings.json` 的 `env` 字段:`env.ANTHROPIC_API_KEY` / `env.
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
-
|
|
156
|
-
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
### 会话浏览模式
|
|
185
|
+
### Claude Code 配置模式(Windows / macOS / Linux)
|
|
186
|
+
|
|
187
|
+
- 管理多个 Claude Code 配置方案
|
|
188
|
+
- 配置 API Key、Base URL 和模型
|
|
189
|
+
- 默认写入 `~/.claude/settings.json` 的 `env` 字段:`env.ANTHROPIC_API_KEY` / `env.ANTHROPIC_BASE_URL` / `env.ANTHROPIC_MODEL`
|
|
190
|
+
|
|
191
|
+
### OpenClaw 配置模式
|
|
192
|
+
|
|
193
|
+
- 管理多个 OpenClaw JSON5 配置方案
|
|
194
|
+
- 应用到 `~/.openclaw/openclaw.json`
|
|
195
|
+
- 管理 OpenClaw Workspace 下的 `AGENTS.md`(默认 `~/.openclaw/workspace/AGENTS.md`)
|
|
196
|
+
|
|
197
|
+
### 会话浏览模式
|
|
160
198
|
|
|
161
199
|
- 在同一 Web 页面查看 Codex 与 Claude Code 的本地会话列表
|
|
162
200
|
- 支持按来源筛选(Codex / Claude / 全部)
|
|
163
201
|
- 支持按已有会话路径(cwd)筛选,选择后自动刷新
|
|
164
202
|
- 支持一键导出指定会话为 Markdown
|
|
203
|
+
- 支持在可用时复制恢复命令
|
|
165
204
|
- 支持删除指定会话(本地 jsonl 记录)
|
|
166
205
|
- 支持勾选多条会话并批量删除,部分失败会汇总提示
|
|
167
206
|
- 支持在会话详情内单条删除记录或多选批量删除记录(写回原始 jsonl)
|
|
@@ -183,15 +222,15 @@ codexmate start
|
|
|
183
222
|
- `codexmate-init.json` - 首次初始化标记(用于避免重复重置)
|
|
184
223
|
- `config.toml.codexmate-backup-*.bak` - 首次初始化时自动备份的旧配置(若存在)
|
|
185
224
|
|
|
186
|
-
Claude Code 配置应用涉及:
|
|
187
|
-
|
|
188
|
-
- `~/.claude/settings.json` - Claude Code 运行时配置(默认写入目标)
|
|
189
|
-
- `~/.claude/settings.json.codexmate-backup-*.bak` - 首次改写前自动备份(若存在旧文件)
|
|
190
|
-
|
|
191
|
-
OpenClaw 配置涉及:
|
|
192
|
-
|
|
193
|
-
- `~/.openclaw/openclaw.json` - OpenClaw 配置(JSON5)
|
|
194
|
-
- `~/.openclaw/workspace/AGENTS.md` - OpenClaw Workspace 指令文件
|
|
225
|
+
Claude Code 配置应用涉及:
|
|
226
|
+
|
|
227
|
+
- `~/.claude/settings.json` - Claude Code 运行时配置(默认写入目标)
|
|
228
|
+
- `~/.claude/settings.json.codexmate-backup-*.bak` - 首次改写前自动备份(若存在旧文件)
|
|
229
|
+
|
|
230
|
+
OpenClaw 配置涉及:
|
|
231
|
+
|
|
232
|
+
- `~/.openclaw/openclaw.json` - OpenClaw 配置(JSON5)
|
|
233
|
+
- `~/.openclaw/workspace/AGENTS.md` - OpenClaw Workspace 指令文件
|
|
195
234
|
|
|
196
235
|
## 首次运行初始化说明
|
|
197
236
|
|
|
@@ -223,7 +262,7 @@ codexmate use gpt-4-turbo
|
|
|
223
262
|
2. 在浏览器中切换到 "Claude Code 配置" 模式
|
|
224
263
|
3. 添加配置方案(例如智谱 GLM):配置名称=智谱GLM,API Key=你的 API Key,Base URL=`https://open.bigmodel.cn/api/anthropic`,模型=`glm-4.7`
|
|
225
264
|
4. 点击配置卡片直接应用,或在编辑弹窗点击“保存并应用到 Claude 配置”
|
|
226
|
-
5. 默认写入 `~/.claude/settings.json
|
|
265
|
+
5. 默认写入 `~/.claude/settings.json`
|
|
227
266
|
6. 重启 Claude Code,新的配置即生效
|
|
228
267
|
|
|
229
268
|
### 启动 Web 界面
|
|
@@ -238,7 +277,7 @@ codexmate start
|
|
|
238
277
|
|
|
239
278
|
### Q: 支持哪些操作系统?
|
|
240
279
|
|
|
241
|
-
A: Codex 功能支持 Windows 和 Linux(CLI 与 Web)。Claude Code 配置应用默认支持 Windows / macOS / Linux(写入 `~/.claude/settings.json
|
|
280
|
+
A: Codex 功能支持 Windows 和 Linux(CLI 与 Web)。Claude Code 配置应用默认支持 Windows / macOS / Linux(写入 `~/.claude/settings.json`)。
|
|
242
281
|
|
|
243
282
|
### Q: API key 存储在哪里?
|
|
244
283
|
|
|
@@ -250,7 +289,7 @@ A: Web 界面运行在本地,所有操作都在本地完成。API key 在界
|
|
|
250
289
|
|
|
251
290
|
### Q: Claude Code 配置后如何生效?
|
|
252
291
|
|
|
253
|
-
A: 点击“应用到 Claude 配置”后会写入 `~/.claude/settings.json`,重启 Claude Code
|
|
292
|
+
A: 点击“应用到 Claude 配置”后会写入 `~/.claude/settings.json`,重启 Claude Code 即生效。
|
|
254
293
|
|
|
255
294
|
### Q: 如何卸载?
|
|
256
295
|
|