ClaudeHub

Appearance

Codex 配置教程 ​

Codex 是 OpenAI 推出的 AI 编程助手命令行工具。通过配置 ClaudeHub，您可以使用 Codex 进行代码生成和编程辅助。

前置要求 ​

  • 已安装 Codex CLI
  • 已获取 ClaudeHub API Key（获取教程）

配置步骤 ​

第一步：创建配置文件 ​

在用户目录下创建 Codex 配置文件。

bash
# 创建配置目录
mkdir -p ~/.codex

# 创建配置文件
touch ~/.codex/config.toml
touch ~/.codex/auth.json
powershell
# 创建配置目录
mkdir -Force "$env:USERPROFILE\.codex"

# 创建配置文件（使用记事本或其他编辑器）
New-Item -Path "$env:USERPROFILE\.codex\config.toml" -ItemType File -Force
New-Item -Path "$env:USERPROFILE\.codex\auth.json" -ItemType File -Force

第二步：编辑 config.toml ​

在 ~/.codex/config.toml（Windows: %USERPROFILE%\.codex\config.toml）文件中添加以下配置：

toml
model_provider = "claudehub"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.claudehub]
name = "claudehub"
base_url = "https://api.qinzhiai.com/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CLAUDEHUB_API_KEY"

第三步：编辑 auth.json ​

在 ~/.codex/auth.json（Windows: %USERPROFILE%\.codex\auth.json）文件中添加以下配置：

json
{
  "OPENAI_API_KEY": null
}

说明

将 OPENAI_API_KEY 设置为 null，然后通过环境变量 CLAUDEHUB_API_KEY 来提供 API 密钥。

第四步：设置环境变量 ​

设置 CLAUDEHUB_API_KEY 环境变量为您的 API 密钥。

bash
# 临时设置（当前会话有效）
export CLAUDEHUB_API_KEY="sk-你的API密钥"

# 永久设置 - 添加到 shell 配置文件
# 对于 zsh（macOS 默认）
echo 'export CLAUDEHUB_API_KEY="sk-你的API密钥"' >> ~/.zshrc
source ~/.zshrc

# 对于 bash
echo 'export CLAUDEHUB_API_KEY="sk-你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile
bash
# 临时设置（当前会话有效）
export CLAUDEHUB_API_KEY="sk-你的API密钥"

# 永久设置 - 添加到 shell 配置文件
# 对于 bash（默认）
echo 'export CLAUDEHUB_API_KEY="sk-你的API密钥"' >> ~/.bashrc
source ~/.bashrc

# 对于 zsh
echo 'export CLAUDEHUB_API_KEY="sk-你的API密钥"' >> ~/.zshrc
source ~/.zshrc
powershell
# 临时设置（当前会话有效）
$env:CLAUDEHUB_API_KEY = "sk-你的API密钥"

# 永久设置（推荐）
[Environment]::SetEnvironmentVariable("CLAUDEHUB_API_KEY", "sk-你的API密钥", "User")

记得替换 API 密钥

将 sk-你的API密钥 替换为您在 获取 API Key 中创建的实际密钥。

验证配置 ​

设置完成后，运行 Codex 验证配置是否正确：

bash
codex

如果配置正确，Codex 将正常启动并连接到 ClaudeHub 服务。

配置参数说明 ​

参数说明
model_provider模型提供者名称
model使用的模型名称
model_reasoning_effort推理强度（low/medium/high）
disable_response_storage是否禁用响应存储
preferred_auth_method首选认证方式
base_urlAPI 端点地址
wire_apiAPI 协议类型
requires_openai_auth是否需要 OpenAI 认证
env_key环境变量名称

常见问题 ​

提示"无法连接" ​

检查以下几点：

  1. API Key 是否正确配置
  2. 环境变量是否设置成功
  3. 网络是否正常

验证环境变量：

bash
echo $CLAUDEHUB_API_KEY
powershell
echo $env:CLAUDEHUB_API_KEY

配置文件位置 ​

系统配置目录
macOS~/.codex/
Linux~/.codex/
Windows%USERPROFILE%\.codex\

更多资源 ​