如何修改 Codex 新建项目的默认存储路径？

最近有不少朋友在折腾 Codex 的时候反馈一个头疼的问题：默认新建项目的文件都往系统盘（通常是 C 盘或根分区）里塞。没过几天，系统盘就爆红了，提示空间不足。其实，咱们完全可以把这些“吞金兽”般的代码项目挪到空间更大的数据盘去存放。

今天就给大家盘一盘，如何把 Codex 的默认工作目录修改到别的盘符或分区，省得以后天天清理垃圾文件。

在 docker-compose.yml 中修改 volumes 配置以映射自定义目录

为什么会出现这个问题？

Codex 这类工具在设计之初，为了配置方便，通常将默认的 WORKSPACE 或者工作卷挂载在用户目录下的隐藏文件夹中（比如 .config 或类似路径）。如果你装软件的时候没看清楚，它就默认吃你的系统盘空间了。

解决方案 1：修改环境变量（推荐 Docker 用户）

如果你是用 Docker 部署的 Codex，这是最干净利落的办法。你需要做的就是在启动容器时，把宿主机的大容量目录挂载进去。

找到你的 docker-compose.yml 文件，打开它。你会看到类似 volumes 的配置项。你需要把原来的路径改掉，或者新增一个映射。

在配置文件（如 config.json）中修改 workpace 字段

假设你想把项目存到 /mnt/data/codex_projects 这个目录，配置可以参考下面这样修改：

services:
  codex:
    image: your-codex-image
    container_name: codex
    volumes:
      # 把宿主机的 /mnt/data/codex_projects 映射到容器内的 /workspace
      - /mnt/data/codex_projects:/workspace
      # 如果还有配置文件需要持久化，也可以一并映射
      - /mnt/data/codex_config:/config
    environment:
      - WORKSPACE=/workspace
    # ... 其他配置

操作步骤：

1. 先在宿主机创建好目标目录 mkdir -p /mnt/data/codex_projects。
2. 修改完 yml 文件后，执行 docker-compose down 停止服务。
3. 执行 docker-compose up -d 重新启动。
4. 再次新建项目，你会发现文件乖乖地跑到数据盘去了。

解决方案 2：修改配置文件（本地安装版）

如果你不是用 Docker，而是直接在系统里安装的包管理版，那就得去翻配置文件了。

通常这类工具的配置文件藏在以下位置：

• Linux/Mac: ~/.config/codex/ 或者 ~/.codex/
• Windows: %APPDATA%\codex\ 或者软件安装目录下的 config 文件夹

你需要找类似 config.json 或 settings.yaml 的文件。打开后，寻找关键字段：

• workspace
• projectsDir
• storagePath

将其值修改为你想要的绝对路径，例如 Windows 下的 D:\CodexWorkspace 或者 Linux 下的 /home/user/data/codes。

注意： 修改配置文件前，记得先退出 Codex 程序，防止修改被自动覆盖。改完保存后，重启软件即可生效。

常见坑点与避雷指南

1. 权限问题： 修改路径后，一定要确保运行 Codex 的用户账号（比如 Docker 里的容器用户或系统当前用户）对那个新目录有读写权限。不然创建项目时会报错 Permission denied。
2. 旧项目迁移： 改路径只是影响“下次新建”的项目。之前已经在默认路径创建的项目不会自动搬家。你需要手动把旧文件剪切到新目录，或者在 Codex 里重新导入（如果支持的话）。
3. 软链接大法： 如果你实在找不到配置文件在哪里，或者不想改环境变量，在 Linux/Mac 下还可以用 ln -s 做一个软链接，把默认目录软链接到你的数据盘目录；Windows 下可以用“磁盘管理”里的“映射驱动器”或者 MKLINK 命令，不过这就偏硬核操作了，不推荐新手折腾。

总结

Codex 好用是好用，但默认路径太“呆板”。不管是通过 Docker 挂载卷还是硬改配置文件，把工作目录挪到宽裕的数据盘绝对是长久之计。免得以后为了腾空间把系统文件删没了，那就得不偿失了。

如果你在操作过程中遇到什么奇葩报错，欢迎在评论区或者私下交流，帮你一起看看哪里卡住了。