458 字
2 分钟
终端AI编程利器:Claude Code与OpenAI Codex CLI中转配置指南
在日常开发中使用第三方 API 中转站时,临时通过终端 export 环境变量极易失效或在 IDE 终端中无法继承。最稳定、一次配置永久生效的方案是使用本地持久化配置文件。
本文汇总 Claude Code 与 OpenAI Codex CLI 的安装与极简配置文件写法。
一、Claude Code CLI
1. 全局安装
确保已安装 Node.js(推荐 20+),执行:
npm install -g @anthropic-ai/claude-code2. 配置文件路径
在用户主目录下创建配置(若目录不存在则手动新建):
- 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. 运行
进入任意项目目录,终端直接敲:
claude二、OpenAI Codex CLI
1. 全局安装
npm install -g @openai/codex2. 配置文件路径
- 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 的项目根目录运行:
codex三、快速对照总结
| 工具 | 配置文件位置 | 核心参数规范 | 适用场景 |
|---|---|---|---|
| Claude Code | ~/.claude/settings.json | 域名不加 /v1ANTHROPIC_BASE_URLANTHROPIC_API_KEY | 复杂项目全自动跨文件重构、Agentic 任务 |
| Codex CLI | ~/.codex/config.toml | 域名必须加 /v1openai_base_urlopenai_api_key | OpenAI / GPT 体系终端编码、代码补全与 Review |
终端AI编程利器:Claude Code与OpenAI Codex CLI中转配置指南
https://iiii.fun/posts/ai/terminal-ai-tools-config/