AbsolutePathBuf deserialized without a base path，Codex

Quick fix

macOS Codex Desktop 用户可将 config.toml 中的 model_catalog_json 改为模型目录文件的绝对路径。

Symptom

报错原文复制

创建任务时出错
invalid configuration: AbsolutePathBuf deserialized without a base path
in `model_catalog_json`

Cause

CC Switch 自 v3.16.2 起将 `model_catalog_json` 写成相对路径。issue 记录称，macOS Codex Desktop 启动时无法解析这个相对路径；改成绝对路径后正常。问题在 CC Switch 每次写入配置时可能复现，并非本地数据库残留问题。

#5731 的评论还报告了 Windows 和 Linux，但没有提供相应复现细节。#5962 中另有 MCP Server 的 stdio 与 HTTP 字段冲突问题，属于不同故障，不纳入本页。

Fix

1. 1

   打开 `~/.codex/config.toml`，将 `model_catalog_json` 的值改为模型目录文件的绝对路径；issue 给出的示例路径如下。

   ~/.codex/config.toml

   model_catalog_json = "cc-switch-model-catalog.json"
   model_catalog_json = "/Users/<user>/.codex/cc-switch-model-catalog.json"

2. 2

   保存配置后重新启动 Codex。issue 报告称改为绝对路径后可以正常启动。

Affected Versions

ToolCodex Desktop

Version3.16.2 起报告；issue 提及 3.18.0 和 3.19.0，未注明修复版本

PlatformsmacOSWindowsLinux

Source Issues

本页汇总自 2 个真实 issue

• #5731创建任务时出错 invalid configuration: AbsolutePathBuf deserialized without a base path in `model_catalog_json`
• #5962macOS Codex Desktop: model_catalog_json 相对路径导致 AbsolutePathBuf deserialized without a base path

FAQ

恢复 CC Switch 最新一条数据库备份能解决吗？

#5731 有用户报告，使用 CC Switch「设置 → 高级 → 恢复与备份」恢复最新一条数据库备份并重新打开 Codex 后恢复正常；该用户不确定是否由此操作导致。#5962 则称问题不是本地数据库残留，并建议将路径改为绝对路径。

相关问题

Invalid schema for function — Codex将 CC Switch 升级至包含 v3.18.0 修复的版本可解决 `parameters.type:null` 变体；其他 `null` schema 变体仍需跟踪原帖。13 issues mergedRequest exceeds the context window原帖未提供可验证的解法；该问题已作为与 catalog 配置及自动压缩相关的重复项关闭。1 issues merged供应商 API Key 被覆盖：Codex 重启或切换后升级到 cc-switch v4.0.0 或更高版本；该版本重写了切换逻辑，避免供应商密钥互相覆盖并恢复官方登录态。6 issues merged