Metadata-Version: 2.4
Name: codex-mode
Version: 0.1.0a10
Summary: Independent Linux tool to switch Codex ChatGPT and API routes with shared history
Author: henrychi
License-Expression: MIT
Keywords: codex,cli,authentication,benchmark
Classifier: Development Status :: 3 - Alpha
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: tomlkit<1,>=0.13
Dynamic: license-file

# codex-mode

在 ChatGPT 登录与 Responses API 之间切换，保留同一份本地聊天历史。

支持命名账号、交互式配置和双线路测速。独立社区工具，非 OpenAI 官方产品。

## 安装

Linux · Python 3.11+ · Codex 0.153.4+

```bash
python -m pip install codex-mode==0.1.0a10
```

可直接安装到现有 Conda / 虚拟环境；系统 Python 限制安装时，请使用独立虚拟环境。
Desktop SSH 用户在远程服务器安装，而不是在 Desktop 本机安装。

## 配置

先运行一次 Codex 完成初始化，再停止任务、暂停 goal、退出 CLI 并断开 Desktop：

```bash
codex-mode setup
```

向导会备份并扫描 Codex 目录，引导填写 Responses API 地址、key、模型名，
完成 ChatGPT 登录，并可选验证两条线路。API 建议使用 HTTPS；
首次配置的模型默认是 `gpt-5.6-sol`，直接回车即可，推理强度为 `medium`。
重新配置时会显示已保存的模型作为默认值；也可输入上游支持的其他模型。
请先清理可能覆盖配置的鉴权环境变量，例如 `OPENAI_API_KEY`、`OPENAI_BASE_URL`。

默认使用 `CODEX_HOME`，未设置时使用 `~/.codex`。自定义目录：

```bash
codex-mode setup --state-dir /absolute/path/to/codex-home
```

后续命令也需使用相同的 `--state-dir`。

## 使用

```bash
codex-mode status       # 查看模式和凭据状态
codex-mode chatgpt      # 使用 ChatGPT 登录
codex-mode api          # 使用 API；sub2api 为同义命令
codex-mode speed --rounds 3
```

切换前停止任务、暂停 goal 并断开客户端；切换后重新打开原任务，检查进度并继续。
已落盘聊天保留，不自动恢复执行，也不迁移代码目录。

测速默认比较 `gpt-5.6-sol / medium` 对 `hello` 的完整响应耗时，
使用空白临时任务，不发送旧聊天或代码、不切换当前线路。
结果包含 CLI 启动、排队和内部重试；真实请求消耗额度或费用。
临时 ChatGPT 登录可能触发令牌刷新，首次建议避开重要运行任务。

## 多账号（可选）

```bash
codex-mode account-save --account first # 服务停止后保存当前登录
codex-mode login --account second       # 独立登录并保存，不立即启用
codex-mode accounts
codex-mode chatgpt --account second
```

账号轮流使用同一份本地历史，不合并云端任务，不支持同目录双账号并发。

## 注意事项

- Alpha 版；已验证 Codex 0.153.4、0.154.0、0.155.1。更高版本会警告后继续。
- 切换影响整个 Codex 目录；客户端筛选仍可能隐藏部分历史任务。
- 完整备份可能较大且包含凭据；key 文件为明文私有保存，请勿分享。
- 第三方 API 会接收实际任务上下文和代码，使用前确认数据政策。
- 不自动配置网络中继；外部训练、下载等进程不会随模式切换停止。
- 安装环境需要保持可访问。更多参数见 `codex-mode --help`。

MIT License.
