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.
@@ -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
@@ -0,0 +1,7 @@
1
+ # Changelog
2
+
3
+ ## 0.0.4
4
+
5
+ - Added OpenClaw config mode with JSON5 profiles and one-click apply
6
+ - Added OpenClaw workspace AGENTS.md management
7
+ - Added JSON5 parsing dependency
@@ -0,0 +1,7 @@
1
+ # 更新日志
2
+
3
+ ## 0.0.4
4
+
5
+ - 新增 OpenClaw 配置模式(JSON5 多配置管理 + 一键应用)
6
+ - 新增 OpenClaw Workspace 的 AGENTS.md 管理
7
+ - 增加 JSON5 解析依赖
package/README.md CHANGED
@@ -1,60 +1,76 @@
1
1
  # Codex Mate
2
2
 
3
- > A lightweight AI configuration assistant: CLI + Web to manage Codex providers/models and Claude Code configs
3
+ > A lightweight AI configuration assistant: quickly switch Codex providers/models and Claude Code configs, with a unified session browser
4
4
 
5
5
  [![Build](https://img.shields.io/github/actions/workflow/status/ymkiux/codexmate/release.yml?label=build)](https://github.com/ymkiux/codexmate/actions/workflows/release.yml) [![Version](https://img.shields.io/npm/v/codexmate?label=version&registry_uri=https%3A%2F%2Fregistry.npmjs.org)](https://www.npmjs.com/package/codexmate) [![Status](https://img.shields.io/badge/status-alpha-orange)](https://github.com/ymkiux/codexmate)
6
6
  [![Maintain](https://img.shields.io/github/commit-activity/m/ymkiux/codexmate?label=maintain%2Fmonth)](https://github.com/ymkiux/codexmate/commits) [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE) [![Node](https://img.shields.io/badge/node-%3E%3D14.0.0-green.svg)](https://nodejs.org)
7
7
 
8
8
  English | [Chinese](README.zh-CN.md)
9
9
 
10
- ## Overview
11
-
12
- If you frequently switch between models, providers, or configuration profiles, Codex Mate turns that into a single command or a single click.
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
- ## What You Get
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`, compatibility mode env vars |
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
- - Use OpenClaw with multiple profiles, want quick switching
49
- - Multi-project or multi-environment setups that need quick config changes
50
- - Want a visual UI without a heavy client
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. Check status:
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
- 3. Start the Web UI:
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
  ![Codex Mate Web UI](res/screenshot.png)
@@ -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.ANTHROPIC_AUTH_TOKEN` / `env.ANTHROPIC_BASE_URL` / `env.ANTHROPIC_MODEL` / `env.CLAUDE_CODE_USE_KEY`
155
- - Compatibility mode: write to system environment variables (useful for legacy workflows or specific Windows cases)
156
-
157
- ### OpenClaw Config Mode
158
-
159
- - Manage multiple OpenClaw JSON5 profiles
160
- - Apply to `~/.openclaw/openclaw.json`
161
- - Manage `AGENTS.md` under the OpenClaw Workspace (default: `~/.openclaw/workspace/AGENTS.md`)
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`; compatibility mode writes system env vars
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`). Compatibility mode env vars are Windows-only.
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. If using compatibility mode env vars, a restart is also recommended.
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 工具配置助手:CLI + Web,一站式管理 Codex 提供商与 Claude Code 配置
3
+ > 轻量级 AI 工具配置助手:快速切换 Codex 提供商/模型与 Claude Code 配置,并统一管理两者会话
4
4
 
5
5
  [![Build](https://img.shields.io/github/actions/workflow/status/ymkiux/codexmate/release.yml?label=build)](https://github.com/ymkiux/codexmate/actions/workflows/release.yml) [![Version](https://img.shields.io/npm/v/codexmate?label=version&registry_uri=https%3A%2F%2Fregistry.npmjs.org)](https://www.npmjs.com/package/codexmate) [![Status](https://img.shields.io/badge/status-alpha-orange)](https://github.com/ymkiux/codexmate)
6
6
  [![Maintain](https://img.shields.io/github/commit-activity/m/ymkiux/codexmate?label=maintain%2Fmonth)](https://github.com/ymkiux/codexmate/commits) [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE) [![Node](https://img.shields.io/badge/node-%3E%3D14.0.0-green.svg)](https://nodejs.org)
7
7
 
8
8
  [English](README.md) | 中文
9
9
 
10
- ## 你能获得什么
11
-
12
- - 更快的模型/提供商切换
13
- - 更可控的本地配置管理
14
- - 可视化 Web 操作,降低命令行负担
15
- - 配置变更可回溯、有备份
16
-
17
- ## 更新说明(0.0.4)
18
-
19
- - 新增 OpenClaw 配置模式(JSON5 多配置管理 + 一键应用)
20
- - 新增 OpenClaw Workspace AGENTS.md 管理
21
- - 增加 JSON5 解析依赖
22
-
23
- ## 功能总览
24
-
25
- | 模块 | 解决的问题 | 关键能力 |
26
- | --- | --- | --- |
27
- | Codex 配置 | 多提供商/多模型切换麻烦 | 提供商/模型切换、模型管理、CLI + Web 双入口、模板确认写入 |
28
- | Claude Code 配置 | 多方案共存、写入路径不统一 | 多配置方案管理、默认写入 `~/.claude/settings.json`、兼容模式环境变量 |
29
- | OpenClaw 配置 | OpenClaw 配置分散 | JSON5 多配置管理、应用到 `~/.openclaw/openclaw.json`、Workspace 指令文件管理 |
30
- | 会话浏览 | 本地会话难以追踪 | 会话列表/筛选、Markdown 导出、删除与批量清理 |
31
- | 附属工具 | 压缩/解压需额外工具 | 基于 7-Zip 的多线程压缩/解压 |
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
- - 使用 OpenClaw 多配置,希望快速切换
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
- 3. 启动 Web 界面:
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
  ![Codex Mate Web UI](res/screenshot.png)
@@ -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.ANTHROPIC_AUTH_TOKEN` / `env.ANTHROPIC_BASE_URL` / `env.ANTHROPIC_MODEL` / `env.CLAUDE_CODE_USE_KEY`
151
- - 兼容模式:写入系统环境变量(适合旧习惯或特定 Windows 场景)
152
-
153
- ### OpenClaw 配置模式
154
-
155
- - 管理多个 OpenClaw JSON5 配置方案
156
- - 应用到 `~/.openclaw/openclaw.json`
157
- - 管理 OpenClaw Workspace 下的 `AGENTS.md`(默认 `~/.openclaw/workspace/AGENTS.md`)
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`),兼容模式环境变量写入仅支持 Windows。
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 即生效;如果使用兼容模式写系统环境变量,也建议重启 Claude Code。
292
+ A: 点击“应用到 Claude 配置”后会写入 `~/.claude/settings.json`,重启 Claude Code 即生效。
254
293
 
255
294
  ### Q: 如何卸载?
256
295