Skip to content

找到配置文件 ​

手动配置或排查问题时,要打开客户端的配置目录。本页列出 Codex 和 Claude Code 配置文件的位置,以及在 Windows 和 macOS 上最快的打开方法。

用 CCSwitch 的话一般不用碰这些文件

CCSwitch 一键导入 会自动写好配置文件。只有手动配置、或者想确认 CCSwitch 写进去的内容时,才需要按本页打开。

文件一览 ​

客户端文件作用
Codex~/.codex/config.toml接入地址、协议、模型
Codex~/.codex/auth.jsonAPI Key
Codex~/.codex/codex-models.json模型目录,只有选「本地文件」模式时才需要,见 Codex 模型目录
Claude Code~/.claude/settings.json接入地址和 API Key(env 字段)

~ 是你的用户目录。Windows 上 ~/.codex 就是 %USERPROFILE%\.codex,比如 C:\Users\你的用户名\.codex。

打开配置目录 ​

方法一:运行窗口(最快)

  1. 按 Win + R。
  2. 粘贴下面的路径,回车:

text

text
%USERPROFILE%\.codex

Claude Code 的目录把 .codex 换成 .claude 即可。

方法二:PowerShell 直接打开文件

CodexClaude Code

powershell

powershell
notepad "$HOME\.codex\config.toml"

powershell

powershell
notepad "$HOME\.claude\settings.json"

目录不存在时先创建:

powershell

powershell
New-Item -ItemType Directory -Force "$HOME\.codex"

保存时注意扩展名

记事本「另存为」时把保存类型选成 所有文件,文件名写 config.toml。否则会存成 config.toml.txt,客户端读不到。可以在资源管理器的 查看 → 显示 → 文件扩展名 里确认。

:::

.codex、.claude 是以 . 开头的隐藏目录,Finder 默认不显示,这是正常现象。

方法一:Finder「前往文件夹」(最快)

  1. 在 Finder 中按 ⌘ + ⇧ + G。
  2. 输入下面的路径,回车:

text

text
~/.codex

Claude Code 的目录把 .codex 换成 .claude 即可。

方法二:终端

按 ⌘ + Space 搜索「终端」,然后运行:

打开目录编辑 Codex 配置编辑 Claude Code 配置

bash

bash
open ~/.codex

bash

bash
open -e ~/.codex/config.toml

bash

bash
open -e ~/.claude/settings.json

目录或文件不存在时先创建:

bash

bash
mkdir -p ~/.codex && touch ~/.codex/config.toml ~/.codex/auth.json

想在 Finder 里一直显示隐藏文件,按 ⌘ + ⇧ + .,再按一次恢复。

bash

bash
# 打开目录(不同桌面环境命令可能不同)
xdg-open ~/.codex

# 直接编辑
nano ~/.codex/config.toml
nano ~/.claude/settings.json

# 目录不存在时
mkdir -p ~/.codex ~/.claude

还是找不到 ​

  • 先启动一次客户端。 Codex、Claude Code 第一次运行时会自动创建配置目录。
  • 或者先用 CCSwitch 导入一次。 导入后文件就会出现。
  • 确认用户目录对不对。 用管理员身份或另一个账户运行时,读的是那个账户的用户目录。

这些文件里有 API Key

auth.json 和 settings.json 含完整 Key,不要发给别人、截图外发,也不要提交到代码仓库。怀疑泄露时到 API 密钥 禁用旧 Key 再新建。

改完记得重启 ​

客户端只在启动时读一次配置。保存后完全退出客户端再打开,VS Code 插件执行 重新加载窗口。详见 改了配置不生效。