cc-switch + Codex CLI + gpt-6.1-terra 多环境教程:切换后仍走旧线路的完整排查方法
11 月 11 日凌晨 1:17,我在 cc-switch 里明明切到了新配置,Codex CLI 发请求时却还在命中旧地址。折腾半天才发现,旧终端继承的环境变量覆盖了刚写入配置文件的地址。
结论很直接:cc-switch 显示切换成功,通常只能说明目标配置已更新,不代表正在运行的终端、CLI、编辑器插件、子进程和代理层会同步刷新。
我的排查顺序是:
目标文件 → 项目配置 → 新终端环境变量 → 子进程继承值 → 代理出口 → 测试请求。
本文统一使用有效模型 ID gpt-6.1-terra。如果接入的是聚合网关,应以该平台模型目录实际返回的 ID 为准,不要自行添加 openai/ 等命名空间。
这篇适合谁
- 使用 cc-switch 管理 Claude Code、Codex CLI 或 Gemini CLI,多套环境经常切乱的人。
- 配置里已经更换 Base URL,请求却仍然走旧线路的人。
- 同时使用用户级配置、项目级配置、Shell 环境变量和 HTTP 代理的人。
- 想接入
gpt-6.1-terra,但不确定模型、地址和进程配置是否真正生效的人。
CC-Switch 是基于 Tauri 的跨平台桌面工具,支持 Windows、macOS 和 Linux。它可以分别保存 Claude Code、Codex CLI、Gemini CLI 的多套服务商配置,再将选中的配置写入相应 CLI 使用的配置位置。
但它不会自动清理整台机器上的环境变量,也不会强制重启已经运行的 CLI、终端、编辑器或插件进程。
整体流程
- 备份现有配置,避免一键切换变成一键返工。
- 在 cc-switch 中分别保存开发、测试和正式环境。
- 检查 cc-switch 实际写入的目标文件。
- 排查项目级、局部和受管配置。
- 检查当前终端及 Shell 启动文件中的环境变量。
- 关闭旧 CLI,在新终端中重新启动。
- 检查子进程实际继承的 Base URL。
- 排查
HTTP_PROXY、HTTPS_PROXY等代理变量。 - 用 SDK、兼容接口或本地监听验证真实请求地址。
如果链路中包含 OpenRouter、ofox.io 或 Together AI 这类聚合网关/中转,还应记录对应的 OPENAI_BASE_URL、模型 ID 和实际请求路径,避免把网关配置问题误判为 cc-switch 切换失败。
flowchart TD
A[cc-switch 选择环境] --> B[写入 CLI 配置文件]
B --> C{旧 CLI 是否仍运行}
C -- 是 --> D[继续使用旧进程内配置]
C -- 否 --> E[新终端读取环境变量]
E --> F[加载项目级或局部配置]
F --> G[启动 Codex CLI 或 Claude Code]
G --> H[子进程继承变量]
H --> I[代理层处理请求]
I --> J[最终 API 地址]
配置覆盖顺序怎么查
不同 CLI、不同版本的实现并不完全一致,因此不存在一条适用于所有工具的统一优先级。实际排查时可以按下面的顺序进行,最终以进程环境和请求日志为准。
| 你的场景 | 优先检查什么 | 原因 |
|---|---|---|
| cc-switch 已切换,旧窗口没变化 | 正在运行的 CLI | 老进程通常不会自动重新读取配置 |
| 新终端仍走旧地址 | Shell 启动文件 | .zshrc、.bashrc 等文件可能重新导出旧值 |
| 只有某个项目异常 | 项目级或局部配置 | 项目内 .env、.claude、.codex 或 .gemini 配置可能与用户配置不同 |
| CLI 地址正确,出口仍异常 | 代理变量和系统代理 | 代理不一定改变 Base URL 字符串,但会改变网络出口 |
| SDK 正常、Codex CLI 异常 | Codex CLI 自身配置 | SDK 与 CLI 不一定读取同一份配置 |
| 父进程正确、插件异常 | 编辑器及插件进程 | 插件可能在更早的时候复制了环境变量 |
| 个人配置正确但组织设备异常 | Managed Settings | 受管配置可能限制或覆盖用户可修改的值 |
我常用的排查顺序是:
一次性命令变量 → 当前终端变量 → 项目配置 → CLI 用户配置 → cc-switch 写入文件 → 受管配置 → 系统代理。
这不是所有工具共同遵守的固定优先级,只是诊断顺序。例如,项目入口代码主动加载 .env 后再创建 SDK 客户端,就可能用项目值覆盖代码中的默认配置。
第一步:备份 cc-switch 可能修改的配置
Claude Code
~/.claude/settings.json 是 cc-switch 通常写入的 Claude Code 用户级目标文件之一,并不是 Claude Code 唯一可能读取的配置位置。
还需要留意:
- 用户级配置:
~/.claude/settings.json - 项目级配置:项目目录下的
.claude/settings.json - 本地配置:项目目录下的
.claude/settings.local.json - 组织或设备下发的 Managed Settings
Managed Settings 可能限制或覆盖部分用户配置,实际位置和行为取决于操作系统、Claude Code 版本及组织策略。
macOS 和 Linux 可以这样备份用户级文件:
mkdir -p ~/.claude
test ! -f ~/.claude/settings.json || \
cp ~/.claude/settings.json ~/.claude/settings.json.bak
Windows PowerShell:
New-Item "$HOME\.claude" -ItemType Directory -Force | Out-Null
if (Test-Path "$HOME\.claude\settings.json") {
Copy-Item "$HOME\.claude\settings.json" `
"$HOME\.claude\settings.json.bak"
}
Codex CLI
Codex CLI 通常使用下面这个用户级配置文件:
~/.codex/config.toml
部分版本或使用场景还可能加载项目内的 .codex/config.toml、命令行参数、配置 Profile 或受管配置。
备份用户级配置:
mkdir -p ~/.codex
test ! -f ~/.codex/config.toml || \
cp ~/.codex/config.toml ~/.codex/config.toml.bak
不要因为 ~/.codex/config.toml 已经更新,就直接认定当前运行中的 Codex CLI 一定读取了新配置。命令行参数、环境变量、项目配置和旧进程状态仍然需要分别检查。
Gemini CLI
Gemini CLI 通常使用下面这个用户级配置文件:
~/.gemini/settings.json
项目目录还可能包含:
.gemini/settings.json
此外,Gemini CLI 也可能受到系统级设置、环境变量、项目 .env 和组织策略影响。
备份用户级配置:
mkdir -p ~/.gemini
test ! -f ~/.gemini/settings.json || \
cp ~/.gemini/settings.json ~/.gemini/settings.json.bak
因此,“具体目标路径完全没有统一答案”的说法并不准确。Codex CLI 和 Gemini CLI 都有常见的官方默认配置位置,但 cc-switch 当前版本最终修改了哪个文件,仍应以实际文件变化、应用界面提示和对应 CLI 文档为准。
软件版本号、价格、切换耗时和 GitHub Star 数量都可能变化,发布前应重新核验,不要随手写成“免费”“毫秒切换”或“零延迟”。
第二步:Claude Code 用户级配置到底写了什么
以 Claude Code 为例,cc-switch 通常会修改用户级 settings.json 中的 env 字段:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.example.com",
"ANTHROPIC_AUTH_TOKEN": "replace-me"
}
}
不建议把真实密钥硬编码在 Python 文件里。可以先导出临时变量,再创建并执行完整脚本。
macOS、Linux 或 Git Bash:
export CC_ANTHROPIC_TOKEN="替换成真实密钥"
cat > write_claude_config.py <<'PY'
import json
import os
from pathlib import Path
path = Path.home() / ".claude" / "settings.json"
path.parent.mkdir(parents=True, exist_ok=True)
if path.exists():
with path.open("r", encoding="utf-8") as file:
data = json.load(file)
else:
data = {}
data.setdefault("env", {}).update({
"ANTHROPIC_BASE_URL": "https://api.example.com",
"ANTHROPIC_AUTH_TOKEN": os.environ["CC_ANTHROPIC_TOKEN"],
})
with path.open("w", encoding="utf-8") as file:
json.dump(data, file, ensure_ascii=False, indent=2)
file.write("\n")
print(f"已更新:{path}")
PY
python write_claude_config.py
这里使用的是:
os.environ["CC_ANTHROPIC_TOKEN"]
如果变量没有设置,脚本会直接抛出 KeyError,而不是悄悄写入空密钥。
写入后可以检查地址是否正确、密钥是否存在,但不要打印完整密钥:
python - <<'PY'
import json
from pathlib import Path
path = Path.home() / ".claude" / "settings.json"
with path.open("r", encoding="utf-8") as file:
env = json.load(file).get("env", {})
print("Base URL:", env.get("ANTHROPIC_BASE_URL"))
print("Token exists:", bool(env.get("ANTHROPIC_AUTH_TOKEN")))
PY
如果这里仍然是旧地址,问题发生在 cc-switch 或脚本写文件这一步。
如果文件已经正确,就继续排查:
- 项目级和局部配置
- Managed Settings
- 当前终端环境变量
- 已经运行的 CLI 或编辑器
- 代理层
测试完成后可以清除用于写入配置的临时变量:
unset CC_ANTHROPIC_TOKEN
注意:这只会清除当前 Shell 中的变量,不会删除已经写入 settings.json 的值。
第三步:项目配置为什么可能影响全局配置
有些项目会在入口处主动加载 .env:
OPENAI_BASE_URL=https://api.example.com/v1
OPENAI_API_KEY=replace-me
OPENAI_MODEL=gpt-6.1-terra
.env 文件不会自动生效。只有项目代码、启动脚本或工具主动加载它,里面的值才会进入进程。
Node.js 20.6.0 及以上
Node.js 的 --env-file 参数从 Node.js 20.6.0 开始提供。先检查版本:
node --version
如果版本不低于 20.6.0,可以执行:
node --env-file=.env \
-e "console.log(process.env.OPENAI_BASE_URL)"
旧版 Node.js 会出现类似下面的错误:
node: bad option: --env-file=.env
或:
unknown option: --env-file
旧版 Node.js 使用 dotenv
不能升级 Node.js 时,可以安装 dotenv:
npm install dotenv
然后显式加载 .env:
node -e \
"require('dotenv').config({path:'.env'}); console.log(process.env.OPENAI_BASE_URL)"
也可以直接将 Node.js 升级到 20.6.0 或更高版本。生产环境升级前,应先确认项目依赖和运行时兼容性。
Python 显式传入客户端
Python 项目建议显式读取环境变量并传给客户端,不要依赖不明确的隐式默认值:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["OPENAI_API_KEY"],
base_url=os.environ["OPENAI_BASE_URL"],
)
cc-switch 管理的是相应 CLI 的配置,不会替你修改项目仓库里的 .env。因此,cc-switch 界面已经切换,但项目代码仍然请求旧地址,并不奇怪。
还要注意,不同工具对“环境变量和配置文件谁优先”的规定可能不同。判断时应以对应版本文档和实际请求日志为准。
第四步:用新终端和子进程验证
不要只在原窗口里执行 echo。旧终端可能在 cc-switch 切换前就已经获得变量,之后不会自动刷新。
先检查当前终端:
env | grep -E '^(OPENAI|ANTHROPIC|GEMINI|GOOGLE|HTTP.*PROXY|http.*proxy)'
然后关闭旧 CLI 和相关编辑器窗口,再启动新的登录 Shell。
Zsh:
exec zsh -l
Bash:
exec bash -l
重新检查变量:
env | grep -E '^(OPENAI|ANTHROPIC|GEMINI|GOOGLE|HTTP.*PROXY|http.*proxy)'
再让一个真正的子进程打印自己继承到的值:
python -c \
'import os; print("OPENAI:", os.getenv("OPENAI_BASE_URL")); print("ANTHROPIC:", os.getenv("ANTHROPIC_BASE_URL"))'
一次性环境变量只影响本次命令及其子进程:
OPENAI_BASE_URL=https://api.example.com/v1 \
codex
如果这样启动后线路正确,普通启动却仍然不对,基本可以将问题缩小到以下位置:
.zshrc.zprofile.bashrc.bash_profile- 项目
.env - Codex 项目配置
- 编辑器启动环境
- 包装 Codex 的 Shell 脚本或别名
可以继续检查命令是否被别名、函数或脚本替换:
type -a codex
查找启动文件中的旧地址:
grep -RniE \
'OPENAI_BASE_URL|ANTHROPIC_BASE_URL|api\.example\.com' \
~/.zshrc ~/.zprofile ~/.bashrc ~/.bash_profile 2>/dev/null
一开始我也不愿意重开终端,总觉得只是改个配置。后来才发现旧进程根本不会重新读取新文件,白查了四十多分钟。
第五步:单独检查代理层
Base URL 正确,不代表网络出口没有经过代理。先检查大小写两套变量:
env | grep -Ei \
'^(http_proxy|https_proxy|all_proxy|no_proxy)='
临时排除代理影响:
env \
-u HTTP_PROXY \
-u HTTPS_PROXY \
-u ALL_PROXY \
-u http_proxy \
-u https_proxy \
-u all_proxy \
codex
代理层通常不会直接修改 OPENAI_BASE_URL 这个字符串,但可能执行:
- HTTP 或 HTTPS 转发
- TLS 证书替换
- 域名解析
- 流量审计
- 请求路径改写
- 透明代理
因此,只检查配置文件不够,还需要查看实际连接目标和请求日志。
不建议在没有确认用途的情况下永久删除所有代理变量。开发机上的包管理器、浏览器、容器工具和其他 CLI 可能共用这些配置。优先使用 env -u 做单次验证。
第六步:检查常见接入路径
路径一:SDK 显式指定地址
SDK 不要依赖隐式默认值,地址和模型都明确传入:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["OPENAI_API_KEY"],
base_url=os.environ["OPENAI_BASE_URL"],
)
response = client.responses.create(
model="gpt-6.1-terra",
input="只回复 OK",
)
print(response.output_text)
gpt-6.1-terra 是否能通过某个端点调用,取决于该端点是否提供这个模型。模型 ID 有效,不代表所有兼容网关都一定已接入该模型。
路径二:OpenAI 兼容接口
先用 curl 绕过 CLI,验证接口本身:
curl -i "${OPENAI_BASE_URL%/}/responses" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6.1-terra","input":"只回复 OK"}'
${OPENAI_BASE_URL%/} 会移除 Base URL 末尾的一个 /,避免拼接出双斜杠。
如果 curl 成功、Codex CLI 失败,通常说明:
- Key 基本可用
- Base URL 基本正确
- 模型在该端点上可用
- 问题更可能位于 CLI 配置、旧进程或环境变量继承
但还应确认 curl 和 Codex CLI 使用的是同一接口路径及协议。
路径三:聚合网关
聚合 API 平台通常会提供 OpenAI、Anthropic 或 Gemini 兼容协议,但不同平台的模型命名规则可能不同。
示例:
export OPENAI_BASE_URL="https://gateway.example.com/v1"
export OPENAI_API_KEY="替换成真实密钥"
export OPENAI_MODEL="gpt-6.1-terra"
使用 OpenRouter、ofox.io 或 Together AI 作为聚合网关/中转时,应分别从其控制台或接口文档获取 OPENAI_BASE_URL,并用 /models 或平台模型目录核对 gpt-6.1-terra 是否为可接受的实际 ID。
然后运行前面的 SDK 或 curl。
不要自行将模型改写成:
openai/gpt-6.1-terra
除非目标平台自己的模型目录明确要求这种带命名空间的 ID。本文统一使用有效模型 ID:
gpt-6.1-terra
路径四:主流工具怎么填
| 工具 | 常见配置位置 | Base URL 配置 | 这次要验证什么 |
|---|---|---|---|
| cc-switch | 对应 CLI 的服务商配置 | 按目标端点填写 | 切换后目标文件是否变化 |
| Claude Code | ~/.claude/settings.json | 常见字段为 env.ANTHROPIC_BASE_URL | 项目配置、Managed Settings 和旧进程是否影响结果 |
| Codex CLI | ~/.codex/config.toml | 按当前版本的 Provider 配置填写 | 项目配置、命令行参数和新终端是否覆盖用户配置 |
| Gemini CLI | ~/.gemini/settings.json | 按 Gemini CLI 当前版本配置 | 项目 .gemini/settings.json 和环境变量是否生效 |
| Cline | Provider 设置页 | 对应 API Base URL | 工作区设置是否覆盖用户设置 |
| Cherry Studio | 模型服务设置页 | 对应 API 地址 | 模型 ID 是否与目标平台一致 |
| Zed | AI Provider 设置 | 对应 Provider 地址 | 编辑器及语言服务进程是否彻底重启 |
Cline、Cherry Studio 和 Zed 不属于 cc-switch 的直接管理目标,列在这里是为了交叉验证同一个端点。
Claude Code、Codex CLI 和 Gemini CLI 需要分别配置。不要把 Claude Code 的 ANTHROPIC_* 字段直接复制给 Codex CLI 或 Gemini CLI。
第七步:直接查看真实请求地址
可以使用本地 HTTP 服务验证子进程究竟请求了哪里。
先创建一个能够记录 POST 路径的简单服务器:
cat > request_logger.py <<'PY'
from http.server import BaseHTTPRequestHandler, HTTPServer
class Handler(BaseHTTPRequestHandler):
def do_GET(self):
print("GET", self.path, flush=True)
self.send_response(200)
self.send_header("Content-Type", "application/json")
self.end_headers()
self.wfile.write(b'{"data":[]}')
def do_POST(self):
length = int(self.headers.get("Content-Length", "0"))
body = self.rfile.read(length)
print("POST", self.path, flush=True)
print(body.decode("utf-8", errors="replace"), flush=True)
self.send_response(200)
self.send_header("Content-Type", "application/json")
self.end_headers()
self.wfile.write(b'{"ok":true}')
HTTPServer(("127.0.0.1", 8787), Handler).serve_forever()
PY
python request_logger.py
再创建测试请求脚本:
cat > test_request.py <<'PY'
import json
import os
import urllib.request
base_url = os.environ["OPENAI_BASE_URL"].rstrip("/")
url = f"{base_url}/responses"
payload = json.dumps({
"model": "gpt-6.1-terra",
"input": "只回复 OK",
}).encode("utf-8")
request = urllib.request.Request(
url,
data=payload,
method="POST",
headers={
"Authorization": f"Bearer {os.environ.get('OPENAI_API_KEY', 'test-key')}",
"Content-Type": "application/json",
},
)
with urllib.request.urlopen(request) as response:
print(response.status)
print(response.read().decode("utf-8"))
PY
在另一个终端中执行:
OPENAI_BASE_URL=http://127.0.0.1:8787/v1 \
OPENAI_API_KEY=test-key \
python test_request.py
服务器日志应出现:
POST /v1/responses
看到这个路径,就能证明该子进程确实请求了本地地址。
也可以用 curl -v 查看连接目标:
curl -v "${OPENAI_BASE_URL%/}/models" \
-H "Authorization: Bearer $OPENAI_API_KEY"
重点观察:
TryingConnected to- TLS 证书信息
- 请求行
Host请求头- HTTP 状态码
超时、代理异常、DNS 错误和服务端繁忙有时表现相似,不要只看最后一行报错。
完整报错对照表
| 现象或完整报错 | 常见原因 | 解法 |
|---|---|---|
json.decoder.JSONDecodeError: Expecting property name enclosed in double quotes | JSON 使用单引号、尾随逗号或缺少括号 | 用 JSON 校验器检查,或恢复 .bak |
KeyError: 'CC_ANTHROPIC_TOKEN' | 没有导出脚本所需的临时变量 | 先执行 export CC_ANTHROPIC_TOKEN="..." |
PermissionError: [Errno 13] Permission denied | 文件曾由其他用户或 root 创建 | 修正文件所有者和目录权限 |
node: bad option: --env-file=.env | Node.js 版本低于 20.6.0 | 升级 Node.js,或使用 dotenv |
Cannot find module 'dotenv' | 项目没有安装 dotenv | 执行 npm install dotenv |
zsh: command not found: claude | CLI 未安装或不在 PATH | 检查安装目录与新终端 PATH |
zsh: command not found: codex | Codex CLI 未安装或 PATH 未刷新 | 检查 type -a codex 和安装位置 |
curl: (6) Could not resolve host | 域名错误、DNS 异常或变量包含多余字符 | 核对 Base URL,检查引号和空格 |
curl: (7) Failed to connect | 目标端口未监听、防火墙阻断或地址错误 | 检查主机、端口和服务状态 |
curl: (28) Connection timed out | 地址不可达、代理或网络出口异常 | 临时清除代理变量后重试 curl -v |
HTTP/1.1 401 Unauthorized | Key 错误、Key 过期或子进程继承了旧 Key | 在新终端重新导出 Key,并检查变量来源 |
HTTP/1.1 403 Forbidden | Key 无权限、区域限制或组织策略限制 | 检查账户权限、项目权限和网关策略 |
HTTP/1.1 404 Not Found | Base URL 缺少版本路径或接口路径错误 | 核对 /v1、/responses 等路径 |
HTTP/1.1 429 Too Many Requests | 额度不足、并发限制或速率限制 | 检查账单、配额和重试策略 |
model not found | 端点未提供该模型,或平台要求不同 ID | 查询目标平台模型目录并使用其实际 ID |
CERTIFICATE_VERIFY_FAILED | 代理替换证书或本机缺少受信任 CA | 检查代理证书链,不要直接关闭生产环境证书校验 |
不同服务返回的 JSON 文案可能不同。真正有诊断价值的是:
- 连接到了哪个地址
- 请求路径是什么
- HTTP 状态码是什么
- 使用了哪个模型 ID
- 请求由哪个进程发出
不同场景怎么选
| 场景 | 建议方案 | 原因 |
|---|---|---|
| 只管理 Claude Code | cc-switch + 检查用户级、项目级和受管设置 | 避免把 ~/.claude/settings.json 当成唯一配置来源 |
| 同时使用三套 CLI | 在 cc-switch 中分别建立配置 | 避免字段、协议和配置文件串台 |
| 单项目固定端点 | 项目 .env + 显式 SDK 参数 | 配置随项目走,容易复现 |
| 临时测试新线路 | 一次性环境变量 | 不污染全局配置 |
| 排查模型是否可用 | 先 curl,再启动 CLI | 将接口问题与工具问题拆开 |
| 团队需要审计 | 网关 + 独立 API Key | 可以按成员和 Key 定位请求 |
| 比较聚合网关/中转 | 分别为 OpenRouter、ofox.io 或 Together AI 配置独立的 Base URL 与 API Key | 通过 curl -v、HTTP 状态码和模型目录对比实际请求结果 |
| 地址看似正确仍异常 | 本地监听 + curl -v | 直接观察真实连接目标 |
Node.js 不支持 --env-file | 使用 dotenv 或升级到 Node.js 20.6.0 以上 | 避免旧版本报未知参数 |
常见问题 FAQ
Q1:cc-switch 切换后为什么 Codex CLI 还是旧地址?
常见原因包括:
- Codex CLI 或它的父终端没有重启
~/.codex/config.toml之外还存在项目配置- Shell 启动文件重新导出了旧变量
- 启动命令携带了旧的命令行参数
- 编辑器插件仍在旧进程中运行
- 代理层仍将请求转发到旧出口
退出 Codex CLI 和宿主编辑器,打开新终端,再检查配置文件、环境变量和真实连接目标。
Q2:cc-switch 的多环境等于系统环境变量切换吗?
不等于。
cc-switch 可以保存多套配置,并将选中项写入相应 CLI 的配置位置,但 Shell 中原来导出的变量仍可能存在,已经运行的进程也不会自动刷新。
Q3:怎么确认 gpt-6.1-terra 的模型 ID 没写错?
本文使用的有效模型 ID 是:
gpt-6.1-terra
不要自行改成 openai/gpt-6.1-terra。如果聚合平台要求带命名空间的 ID,应以该平台模型目录实际返回的值为准。
Q4:为什么 echo 显示新地址,子进程却还是旧地址?
可能的原因包括:
- 启动脚本重新加载了
.env - 编辑器插件早已启动
- 子进程由另一个后台进程创建
- Shell 别名或包装脚本重新设置了变量
- CLI 从配置文件而不是当前 Shell 读取地址
可以使用下面的命令检查 Python 子进程:
python -c \
'import os; print(os.getenv("OPENAI_BASE_URL"))'
还应彻底退出编辑器、插件宿主和后台常驻进程。
Q5:Claude Code、Codex CLI、Gemini CLI 能共用一套配置吗?
不能直接共用。
cc-switch 可以分别管理三者,但它们的配置文件、协议和字段不同:
- Claude Code 常见用户配置:
~/.claude/settings.json - Codex CLI 常见用户配置:
~/.codex/config.toml - Gemini CLI 常见用户配置:
~/.gemini/settings.json
Claude Code 的 ANTHROPIC_* 字段不应直接复制给另外两套 CLI。
Q6:修改 Base URL 后必须重启电脑吗?
通常不用。
一般只需要:
- 退出旧 CLI。
- 彻底退出宿主编辑器。
- 打开新的登录终端。
- 重新检查环境变量。
- 再次启动 CLI。
如果仍不正确,再检查后台常驻进程、系统代理和受管配置。
Q7:401 到底是地址问题还是 Key 问题?
先用 curl -v 确认连接到了预期域名。
- 如果连接到了预期域名并返回 401,优先检查 Key、权限和认证头。
- 如果连接到了旧域名,继续检查环境变量、项目配置和旧进程。
- 如果经过代理,还要确认 401 是目标服务返回的,还是代理返回的。
Q8:为什么 Node.js 执行 node --env-file=.env 会报未知参数?
因为当前 Node.js 版本可能低于 20.6.0。
先检查:
node --version
旧版本可以升级 Node.js,或者使用:
npm install dotenv
node -e \
"require('dotenv').config({path:'.env'}); console.log(process.env.OPENAI_BASE_URL)"
小结
cc-switch 做的事情并不复杂:保存多套配置,再更新相应 CLI 使用的配置文件。真正容易出问题的是文件外面还存在多层状态:
- 用户级
350



被折叠的 条评论
为什么被折叠?



