跳到主要内容

终端和配置文件怎么打开？

只有教程要求你修改文件时，才需要看这页。 在 WorkBuddy、TraeWork 等工具的设置界面填写信息时，不需要执行下面的命令。

打开终端​

终端就是输入命令的窗口。下面的命令复制进去，按回车执行即可。

  • macOS：按 Command + 空格，搜索「终端」或 Terminal，打开。
  • Windows：在开始菜单搜索 PowerShell，打开。本文 Windows 命令用于 PowerShell。
  • Linux：打开系统的终端应用。

命令粘贴到终端；TOML、JSON 配置内容粘贴到文件。 不要把整段配置直接当命令运行。

打开 Codex 配置文件​

Codex 桌面端与 Codex CLI 默认使用同一个文件。只展开你电脑对应的步骤；以下命令会保留已有文件内容。

macOS

在终端执行：

mkdir -p ~/.codex
touch ~/.codex/config.toml
open -e ~/.codex/config.toml

会打开「文本编辑」。如果当前是富文本，先在「格式」菜单切换成纯文本。修改后按 Command + S 保存，文件名保持 config.toml。

Windows PowerShell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
if (-not (Test-Path "$env:USERPROFILE\.codex\config.toml")) {
  New-Item -ItemType File "$env:USERPROFILE\.codex\config.toml" | Out-Null
}
notepad "$env:USERPROFILE\.codex\config.toml"

会打开「记事本」。修改后按 Ctrl + S 保存。文件名必须保持 config.toml，不要另存为 config.toml.txt。

Linux
mkdir -p ~/.codex
touch ~/.codex/config.toml
nano ~/.codex/config.toml

修改后按 Ctrl + O，回车保存，再按 Ctrl + X 退出。如果系统没有 nano，用你已有的纯文本编辑器打开这个文件。

打开后，回到 Codex 桌面端 或 Codex CLI 教程，继续填写配置。

打开 Claude Code 配置文件​

macOS
mkdir -p ~/.claude
if [ ! -e ~/.claude/settings.json ]; then
  printf '{}\n' > ~/.claude/settings.json
fi
open -e ~/.claude/settings.json

在打开的「文本编辑」中修改，使用纯文本格式，按 Command + S 保存，文件名保持 settings.json。

Windows PowerShell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null
if (-not (Test-Path "$env:USERPROFILE\.claude\settings.json")) {
  Set-Content -Path "$env:USERPROFILE\.claude\settings.json" -Value '{}' -Encoding ASCII
}
notepad "$env:USERPROFILE\.claude\settings.json"

在记事本中修改，按 Ctrl + S 保存。不要另存为 settings.json.txt。

Linux
mkdir -p ~/.claude
if [ ! -e ~/.claude/settings.json ]; then
  printf '{}\n' > ~/.claude/settings.json
fi
nano ~/.claude/settings.json

修改后按 Ctrl + O，回车保存，再按 Ctrl + X 退出。如果没有 nano，使用已有的纯文本编辑器。

回到 Claude Code 教程，继续填写配置。

文件里已经有内容怎么办？​

先复制一份原文件作为备份，再修改原文件。

  • Codex：已有 model = ...、model_provider = ... 就改原来的值；没有才在第一个方括号标题之前添加。已有 [model_providers.tonyai] 就修改该段，没有才追加。不要出现两份同名设置。
  • Claude Code：已有 model 就改它；已有 env 就把教程里的两项写进原来的 env 大括号里。不要在文件末尾直接再粘贴一整份 JSON。

JSON 的相邻设置之间用英文逗号分隔，最后一项后面不加逗号。两种文件都保留英文引号，不要换成中文引号。

保存后，完全关闭并重新打开工具。若提示配置格式错误，先恢复备份，再检查引号、逗号及重复字段；不要为了让它启动而删掉全部原配置。

以前自定义过配置目录？

本页使用默认目录。若主动设置过 CODEX_HOME 或 CLAUDE_CONFIG_DIR，需编辑自定义目录中的文件。没有改过这些设置就忽略本项。