Codex 接入指南

2. 创建并复制 AIDesk API Key

打开控制台的 API 密钥页面，创建一个密钥并复制。它通常以 sk-aidesk- 开头，第 5 步会用到；现在先保持控制台页面打开，到第 5 步时按自己的系统和客户端说明保存密钥。复制后面的命令会替换剪贴板内容，到时请回到密钥页面重新复制完整密钥。

3. 在电脑上打开配置文件

config.toml 是告诉 Codex“连接哪个地址、使用哪个模型”的文本文件。下面的命令会找到这个文件；第一次使用时会创建所需目录和空文件。这一节的命令在终端执行，第 4 步的配置才粘贴到文件里。

$codexConfigDir = if ($env:CODEX_HOME) {
    $env:CODEX_HOME
} else {
    Join-Path $env:USERPROFILE '.codex'
}
New-Item -ItemType Directory -Force -Path $codexConfigDir | Out-Null
$codexConfigPath = Join-Path $codexConfigDir 'config.toml'
if (-not (Test-Path -LiteralPath $codexConfigPath)) {
    New-Item -ItemType File -Path $codexConfigPath | Out-Null
}
notepad $codexConfigPath

4. 复制连接配置，粘贴到文件并保存

先选择模型；接口地址默认使用当前站点提供的地址。点击下方代码框的“复制”，切回刚才打开的 config.toml 文件粘贴。这段内容是文件内容，不是在终端执行的命令。

model = "gpt-6.1-sol"
model_provider = "aidesk"
# 网页搜索：disabled 关闭，live 实时联网
web_search = "disabled"

[model_providers.aidesk]
name = "AIDesk API"
base_url = "https://api.aideskapp.com/v1"
wire_api = "responses"
http_headers = { "x-aidesk-source" = "codex" }
env_key = "AIDESK_API_KEY"

5. 长期保存 API Key（只需设置一次）

按自己的系统选择下面的说明。设置完成后，新开终端或重启电脑都不需要重新粘贴密钥；只有更换、撤销密钥或换电脑时才需要更新。

& {
    $ErrorActionPreference = 'Stop'
    $aideskKey = 'sk-aidesk-YOUR_KEY'
    [Environment]::SetEnvironmentVariable(
        'AIDESK_API_KEY', $aideskKey, 'User'
    )
    $env:AIDESK_API_KEY = $aideskKey
    Write-Host 'API Key 已长期保存，当前窗口也已生效。'
}

if ($env:AIDESK_API_KEY) {
    'API Key 已读取，可以继续第 6 步'
} else {
    '未读取到 API Key，请完全退出终端程序后重新打开'
}

if [ -n "$AIDESK_API_KEY" ]; then
  echo 'API Key 已读取，可以继续第 6 步'
else
  echo '未读取到 API Key，请检查保存位置并新开终端'
fi

6. 启动 Codex，发送第一条消息

codex

请只回复：aidesk-ok

收到 aidesk-ok 后，还需要按下一节确认调用记录和编码工具。CLI 切换模型可使用 /model；自定义模型未出现在列表时，可新开会话显式指定：

codex -m claude-opus-5-5

-m 只选择模型，连接仍使用配置中的 AIDesk provider；所选线路需支持 Responses。

确认连接和编码工具都正常

1. 收到 aidesk-ok 后，打开控制台调用记录，核对刚才请求的时间、模型与成功状态。客户端能回复或自报模型名，都不能单独证明请求走了 AIDesk。
2. 在测试项目里，让 Codex 读取一个已有文件并概括内容，确认实际出现读取文件的工具调用。
3. 让它创建一个临时测试文件，再继续对话修改该文件；按客户端提示审核操作，并检查文件内容。这能验证工具调用、结果回传和多轮续跑。

测试网页搜索：使用 Claude 时，将配置文件顶层设为 web_search = "live"，重启 Codex 并新建会话，然后发送：

请使用内置网页搜索查找 Python 3.14 的正式发布日期，只回复日期和 Python 官网来源链接，不要运行终端命令。

应看到搜索过程（如 Browsing / Searched）和可点击的来源链接。当前支持实时搜索，不支持 cached 模式或完整浏览器操作。