从创建密钥到工具跑通，
一页完成中转配置

下面是 Codex CLI 的手动配置方式。桌面端和编辑器插件的配置入口可能随版本不同；不熟悉配置文件时，可优先使用 CC Switch。

1. 安装 Node.js 与 Codex CLI

从 Node.js 官网 ↗ 安装 LTS 版本，重新打开终端后执行：

npm install -g @openai/codex

2. 找到用户配置目录

Windows 在资源管理器地址栏输入路径；macOS 可在 Finder 中按 ⌘ + Shift + G。目录不存在时可先启动一次客户端或手动创建。

%USERPROFILE%\.codex

~/.codex

3. 配置 config.toml

先备份已有文件，再合并下方配置。将 YOUR_AVAILABLE_MODEL 替换为你在荷塘模型广场确认可用、支持 Responses 的模型名称。

model = "YOUR_AVAILABLE_MODEL"
model_provider = "hetang"

[model_providers.hetang]
name = "Hetang"
base_url = "https://www.hetanghub.com/v1"
wire_api = "responses"
env_key = "HETANG_API_KEY"

4. 在当前终端设置密钥并启动

将占位符替换为自己的平台 API Key。这些命令仅对当前终端会话生效；请在同一个窗口启动 Codex。

$env:HETANG_API_KEY = "YOUR_API_KEY"
codex

export HETANG_API_KEY="YOUR_API_KEY"
codex

配置参考：OpenAI 官方自定义服务商文档 ↗

通过 settings.json 配置荷塘请求地址与平台密钥。以下使用 npm 安装方式；请先准备好 Node.js LTS。

1. 安装 Claude Code

安装 Node.js ↗ 后重新打开终端，执行下面的命令。Windows 还需按 Claude Code 安装提示准备 Git for Windows 等依赖。

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

2. 找到 Claude 配置目录

Windows 在资源管理器地址栏输入下方路径；macOS 在 Finder 的“前往文件夹”中输入。目录不存在时可手动创建。

%USERPROFILE%\.claude

~/.claude

3. 写入 settings.json

先备份原文件，将以下 env 配置合并进去，并把 YOUR_API_KEY 替换为自己的平台密钥。保留已有的其他配置项。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.hetanghub.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
  }
}

4. 启动并确认模型

重新打开终端，运行 claude。通过 /model 选择账号实际可用的 Claude 模型，再发送一句 hello。模型名与权限以荷塘控制台为准。

claude

如果经常在 Claude Code、Codex 等工具之间切换，可以使用荷塘已有的 CC Switch 导入功能。

1. 安装并打开 CC Switch

访问 CC Switch 官网 ↗ 或 GitHub 项目页 ↗，按照说明安装适合自己系统的版本，并先打开应用。

2. 从荷塘的密钥操作菜单导入

进入 密钥管理，在目标密钥的操作菜单里选择 CC Switch。在弹窗里选择 Claude 或 Codex，填写配置名称并选择主模型，然后点击 打开 CC Switch。

3. 启用配置，再重启客户端

确认 CC Switch 内导入的请求地址、应用类型与主模型正确，切换到刚创建的荷塘配置，再重新启动对应客户端。浏览器询问是否打开外部应用时，确认目标是本机 CC Switch。