Aiberm logo
登录

Codex CLI 设置

学习如何配置 Codex CLI 使用 Aiberm 的 API。本指南涵盖 Windows、macOS 和 Linux 的安装和配置。

什么是 Codex CLI？

Codex CLI 是 OpenAI 的命令行界面，专为代码相关的终端任务而设计。与通用聊天工具相比，它强调工程就绪的输出，提供更清晰、可操作的代码更改。通过配置它使用 Aiberm，您可以通过经济高效的端点访问多个 AI 模型。

前置条件

开始之前，请确保您拥有：

安装

使用 npm 全局安装 Codex CLI：

npm install -g @openai/codex

验证安装：

codex --version

这应该显示版本号。

配置

Codex CLI 使用 config.toml 文件进行配置。配置目录位置因操作系统而异：

  • Windows：%userprofile%\.codex
  • macOS/Linux：~/.codex

方法 1：手动配置

导航到配置目录并创建或编辑 config.toml：

macOS/Linux：

mkdir -p ~/.codex
nano ~/.codex/config.toml

Windows：

mkdir $env:USERPROFILE\.codex -Force
notepad $env:USERPROFILE\.codex\config.toml

添加以下配置：

model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false

重要： 将 sk-your-aiberm-api-key 替换成你在 Aiberm 控制台创建的真实 API Key。不要保留示例占位符。

API Key 会以明文保存在当前电脑的 config.toml 中。请勿将这个文件提交到 Git、上传到公开位置或分享给其他人。

方法 2：一键配置

macOS/Linux：

mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false
EOF

Windows PowerShell：

$configPath = "$env:USERPROFILE\.codex"
New-Item -ItemType Directory -Force -Path $configPath | Out-Null
@"
model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false
"@ | Out-File -FilePath "$configPath\config.toml" -Encoding utf8

执行一键配置前，也要先把命令中的 sk-your-aiberm-api-key 替换为真实 API Key，否则写入后的配置无法使用。

验证配置

检查 Node.js 安装：

node -v
npm -v

验证 Codex CLI 安装：

codex --version

测试 API 连接：

codex "Hi"

如果配置正确，Codex CLI 应该使用 Aiberm 的 API 进行响应。

故障排除

401 未授权错误

  • 验证您的 API 密钥是否正确：控制台 → API 密钥
  • 确认 experimental_bearer_token 中填写的是完整 API Key
  • 确认没有把 sk-your-aiberm-api-key 占位符原样保存
  • 保存 config.toml 后重新启动 Codex CLI

403 禁止访问错误

  • 检查您的 API 密钥的有效性
  • 在 https://aiberm.com/console 验证您的账户余额
  • 确保您的 API 密钥可以访问所请求的模型

网络错误

  • 验证您的互联网连接
  • 检查您是否可以在浏览器中访问 https://aiberm.com
  • 确保您的防火墙允许出站 HTTPS 连接
  • 确认 config.toml 中的 base_url 正确：https://aiberm.com/v1

配置未生效

  • 编辑 config.toml 后重启终端
  • 验证 TOML 语法格式（无额外空格，引号正确）
  • 确保每个配置项单独占一行
  • 检查配置文件位置对您的操作系统是否正确
  • 确保文件保存为 config.toml（而不是 config.toml.txt）

找不到 Codex 命令

macOS/Linux：

# 检查 npm 全局 bin 是否在 PATH 中
npm config get prefix

# 如果需要，在 ~/.zshrc 或 ~/.bashrc 中添加到 PATH：
export PATH="$(npm config get prefix)/bin:$PATH"

Windows：

  • 验证 npm 全局路径是否在系统 PATH 中
  • npm 安装后重启终端
在 GitHub 上编辑此页