首页

Codex 新手接入教程

这份教程适合第一次配置 Codex 的用户。按步骤操作即可。

一、安装 Codex

推荐通过 Microsoft Store 安装 Codex。请认准：

应用名称：Codex

初次唤醒：安装完毕后首次启动程序。此时系统会在后台自动构建初始化的本地目录结构，无需进行任何交互，静待其完成即可。

二、注册并生成 API Key

注册算桥 API 平台账号(https://api.suanqiaoapi.cn)
进入令牌或 Token 管理页面
新建令牌并复制 API Key

四、具体配置方法

API 地址：

https://api.suanqiaoapi.cn/v1

基础环境构建完成后，需对本地通信参数进行深度定制。

配置工作目录：C:\Users\<您的用户名>\.codex

1. 注入环境参数 (`config.toml`)

进入上述目录并打开 config.toml 文件。请保留原有的底层配置，将以下模型调度与通信参数精准复制，并粘贴至文件最顶端：

# 核心通信与模型调度参数
model_provider = "suanqiao"
model = "deepseek-v4-flash"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.suanqiao]
name = "suanqiao"
base_url = "https://api.suanqiaoapi.cn/v1"
wire_api = "responses"

注意：如果使用CCSWITCH配置，地址后面要加v1

2. 构建鉴权凭证 (`auth.json`)

在同一目录下，新建名为 auth.json 的文件，以完成 API 通信的鉴权认证。请将您的专属密钥填入其中：

{
  "OPENAI_API_KEY": "在此处替换为您的专属 API 密钥"
}

样例：（特别注意两边的括号，字母后的_符号）

推荐模型：

deepseek-v4-flash

五、常见报错

401 / Unauthorized：通常是 API Key 填错、复制不完整、额度不足，或令牌被禁用。

unknown variant image_url：说明你发送了图片。当前通道主要支持文字，请新开对话，用纯文字提问。

首页