458 字
2 分钟
终端AI编程利器:Claude Code与OpenAI Codex CLI中转配置指南

在日常开发中使用第三方 API 中转站时,临时通过终端 export 环境变量极易失效或在 IDE 终端中无法继承。最稳定、一次配置永久生效的方案是使用本地持久化配置文件

本文汇总 Claude CodeOpenAI Codex CLI 的安装与极简配置文件写法。


一、Claude Code CLI#

1. 全局安装#

确保已安装 Node.js(推荐 20+),执行:

Terminal window
npm install -g @anthropic-ai/claude-code

2. 配置文件路径#

在用户主目录下创建配置(若目录不存在则手动新建):

  • Windows: C:\Users\<你的用户名>\.claude\settings.json
  • Linux / macOS: ~/.claude/settings.json

3. 极简配置内容 (settings.json)#

{
"env": {
"ANTHROPIC_BASE_URL": "https://你的Claude中转域名",
"ANTHROPIC_API_KEY": "sk-你的Claude密钥"
}
}

踩坑注意

  • ANTHROPIC_BASE_URL 切勿在末尾添加 /v1 或斜杠(例如直接写 https://api.example.com)。客户端内部请求时会自动拼接 /v1/messages,多写会导致请求路径变成 /v1/v1/messages 报 404。
  • 若个别中转站网关只认 Bearer Token 报 401,只需在 env 下额外补一行 "ANTHROPIC_AUTH_TOKEN": "sk-你的Claude密钥" 即可。

4. 运行#

进入任意项目目录,终端直接敲:

Terminal window
claude

二、OpenAI Codex CLI#

1. 全局安装#

Terminal window
npm install -g @openai/codex

2. 配置文件路径#

  • Windows: C:\Users\<你的用户名>\.codex\config.toml
  • Linux / macOS: ~/.codex/config.toml

3. 极简配置内容 (config.toml)#

openai_base_url = "https://你的OpenAI中转域名/v1"
openai_api_key = "sk-你的Codex密钥"

踩坑注意

  • 与 Claude 相反,OpenAI 体系的 openai_base_url 必须包含 /v1,但末尾不要带斜杠。

4. 运行#

Codex CLI 依赖 Git 管理上下文与生成 diff 补丁,请在包含 .git 的项目根目录运行:

Terminal window
codex

三、快速对照总结#

工具配置文件位置核心参数规范适用场景
Claude Code~/.claude/settings.json域名不加 /v1
ANTHROPIC_BASE_URL
ANTHROPIC_API_KEY
复杂项目全自动跨文件重构、Agentic 任务
Codex CLI~/.codex/config.toml域名必须加 /v1
openai_base_url
openai_api_key
OpenAI / GPT 体系终端编码、代码补全与 Review
终端AI编程利器:Claude Code与OpenAI Codex CLI中转配置指南
https://iiii.fun/posts/ai/terminal-ai-tools-config/
作者
庆灵
发布于
2026-09-08
许可协议
CC BY-NC-SA 4.0