Codex 接 AICodeWith 教程：Endpoint、API Key、配置与排错

Codex 接入 AICodeWith 时，当前文档使用 https://api.aicodewith.ai/chatgpt/v1 和 Responses 协议。这里的地址不能直接换成普通 /v1。除了地址，还要把认证、Provider 和模型配套设置，并用平台调用记录验证请求。本文核对于 2026 年 10 月 12 日。

开始前准备什么

准备可运行的 Codex CLI、一个测试项目和 AICodeWith API Key。模型应同时满足平台当前支持、Key 的模型范围与对应渠道可用性。本文采用平台文档当前示例 gpt-5.6-sol，仅用于说明配置；平台调整后以最新文档和模型页面为准，不把示例型号当成永远有效。

查看当前 Codex 终端接入文档

如果只使用官方 ChatGPT 登录且满足需求，无需额外配置。切换第三方 Provider 会改变模型请求的去向，但不会替代 Codex 的文件权限、审批和工作区设置。

第一步：找到并备份原配置

默认目录是 macOS/Linux 的 ~/.codex 和 Windows 用户目录中的 .codex；自定义 CODEX_HOME 时使用实际目录。备份 config.toml 和已有 auth.json，使用带时间的副本名，防止覆盖旧备份。凭证备份同样需要保密，不放入同步公开目录或 Git。

macOS/Linux 在终端确认目录：

text

mkdir -p "$HOME/.codex"

Windows PowerShell 对应：

text

New-Item -ItemType Directory -Path (Join-Path $env:USERPROFILE ".codex") -Force | Out-Null

然后用文件管理器或编辑器把已有文件复制为独立备份。不要直接运行覆盖整个目录的一键脚本；原配置里可能还包含 MCP、项目规则和其他 Provider。

默认目录中已有文件时，可用以下命令建立带时间的副本。只复制存在的文件；凭证备份按密码处理。macOS/Linux：

text

aicw_stamp=$(date +%Y%m%d-%H%M%S)
for aicw_file in config.toml auth.json; do
  if [ -f "$HOME/.codex/$aicw_file" ]; then
    cp "$HOME/.codex/$aicw_file" "$HOME/.codex/$aicw_file.before-aicw-$aicw_stamp"
  fi
done

Windows PowerShell：

text

$aicwStamp = Get-Date -Format 'yyyyMMdd-HHmmss'
$aicwDir = Join-Path $env:USERPROFILE '.codex'
foreach ($aicwFile in @('config.toml', 'auth.json')) {
  $aicwPath = Join-Path $aicwDir $aicwFile
  if (Test-Path $aicwPath) { Copy-Item $aicwPath "$aicwPath.before-aicw-$aicwStamp" }
}

如果设置了 CODEX_HOME，先把上述目录改成实际 Codex home；系统凭证存储不在 auth.json 中，文件副本也不能备份那里的登录状态。

第二步：配置专用 Provider

用文本编辑器打开用户级 config.toml。将 model 和 model_provider 放在文件顶层、任何 [table] 前；已有同名键时修改原值，不重复添加。随后添加或更新对应 Provider 表。以下每行按顺序组成一段 TOML：

text

model_provider = "codex"
model = "gpt-5.6-sol"
[model_providers.codex]
name = "codex"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

model_provider 的值必须和表名里的 codex 一致。requires_openai_auth = true 是这份平台文档采用的认证方式；官方说明启用它时 env_key 会被忽略。不要在同一配置中再加入 env_key，并期待专用变量覆盖凭证。

supports_websockets = false 来自当前平台示例。不要把这项渠道设置推成所有 Provider 的默认要求。项目级 .codex/config.toml 无法覆盖这些机器级 Provider 字段，应修改用户配置。

第三步：按该接入路线设置凭证

平台文档采用 .codex/auth.json 的 OPENAI_API_KEY 字段保存平台 Key。该字段名是 Codex 的本地凭证结构，不表示这个 Key 来自 OpenAI Platform。先完成前面的备份，再在本机编辑文件；只用于本文第三方接入路线，不拿平台 Key 到 OpenAI 官网登录。

text

{"OPENAI_API_KEY":"REPLACE_WITH_YOUR_AICODEWITH_KEY"}

替换占位符后保存为有效 JSON，Windows 编辑器选择 UTF-8。不要同时保留与当前路线无关的旧登录 Token 并猜测优先级。若本机使用系统凭证存储、组织强制登录策略或已有登录缓存，文件可能并非实际使用的凭证源；先按官方认证说明确认，再切换，不通过反复写文件绕过策略。

Key 不写进 config.toml、AGENTS.md 或 Git。验证时不要运行 cat auth.json 或 Get-Content auth.json，以免把完整密钥放进日志。

第四步：发出只读任务并核对调用记录

text

codex --version
codex

在测试项目中输入：“只读取 README，说明启动步骤，不修改文件，不安装依赖。”检查当前模型、回复内容和 git status --short，再到 AICodeWith 按时间、Key、模型匹配调用记录。正常回复与平台记录能对应，才说明请求走到了预期服务；不能只凭配置文件存在判断成功。

本文未执行真实付费请求，因此不声称该配置已经在所有客户端实测成功。桌面端配置后应重新启动客户端，并另外验证其实际请求；平台桌面文档同样以本地配置为基础，但不同版本的入口以当前界面为准。

AICodeWith 桌面端接入说明

调用记录的验收要区分三种情况：没有记录，优先检查客户端是否仍使用旧 Provider，以及请求是否到达平台；有失败记录，按服务返回的错误继续排查；有成功记录但回答不符合任务，只说明模型调用成功，仍需检查输出和工具行为。记录可作为排查线索，不能单独证明所有本地权限和功能正确。

创建并管理本次接入的 API Key

报错时按层排查

401：确认 Key 未撤销、复制完整、所属平台正确，并检查实际凭证来源。404：逐字核对 /chatgpt/v1 与 Responses 配置，不使用 Claude Messages 或通用 Chat Completions 的地址替代。model not found：检查模型 ID、Key 限制和渠道，不靠展示名猜模型字段。

长时间无结果：记录时间、客户端版本和错误信息，先区分网络、认证与模型响应阶段。不要为了连接问题关闭所有审批；审批控制本地动作，不能修复远程 API 地址。