AIHelms Docs
Codex 接入
把 Codex CLI 连接到 AIHelms。
准备信息
从 AIHelms 用户端取得 AI 身份 Key、Endpoint 和普通模型 ID。Codex 不使用带 (Anthropic) 后缀的模型 ID。
保存 Key
macOS 或 Linux：
export AIHELMS_API_KEY="<AI 身份 Key>"PowerShell：
$env:AIHELMS_API_KEY = "<AI 身份 Key>"配置 Codex
编辑：
- macOS、Linux：
~/.codex/config.toml - Windows：
%USERPROFILE%\.codex\config.toml
model_provider = "aihelms"
model = "<模型 ID>"
[model_providers.aihelms]
name = "AIHelms"
base_url = "http://<AIHelms Endpoint>/v1"
env_key = "AIHELMS_API_KEY"
wire_api = "responses"base_url 填到 /v1，不要写成 /v1/responses。env_key 填环境变量名称，不要把真实 Key 写进 TOML。
启动和验证
codex也可以先执行一次简单测试：
codex exec "只回复：Codex 连接成功"启动信息中的 provider 应为 aihelms，model 应为模型广场中的模型 ID。普通回答成功后，再在测试目录验证读取文件和执行简单任务。
常见问题
| 现象 | 处理方法 |
|---|---|
| 缺少环境变量 | 在启动 Codex 的同一终端设置 AIHELMS_API_KEY |
| 404 | base_url 应以 /v1 结尾，不要追加 /responses |
| 401 | Key 无效、已停用或没有传给当前进程 |
model not allowed | 联系管理员为 AI 身份分配目标模型 |
| 自定义模型提示 unknown model | 先确认任务是否成功，再测试上下文和工具能力 |
| 工具调用失败 | 使用标记“工具调用”且管理员已经测试通过的模型 |
使用 CC-Switch 管理配置时，参见 CC-Switch。