一、准备内容
开始前，你需要准备三样东西：
- 算桥 API 平台账号
- 平台后台生成的 API Key
- 已经安装好的 Codex
当前推荐先使用文字模型 deepseek-v4-flash，适合安装测试、代码问答、报错分析和轻量编程辅助。
二、注册与生成 Key
- 打开 https://api.suanqiaoapi.cn。
- 注册并登录账号。
- 进入令牌或 Token 管理页面。
- 新建一个令牌，复制生成的 API Key。
不要把完整 API Key 发到群聊、评论区或截图里。别人拿到 Key 后，可能会消耗你账号里的额度。
三、配置 Codex
在 Windows 的 Ubuntu / WSL 终端中运行：
mkdir -p ~/.codex
nano ~/.codex/config.toml把下面内容粘贴进去：
model = "deepseek-v4-flash"
model_provider = "suanqiao"
[model_providers.suanqiao]
name = "算桥 API"
base_url = "https://api.suanqiaoapi.cn/v1"
wire_api = "chat"
env_key = "OPENAI_API_KEY"保存方法：
Ctrl + O
回车
Ctrl + X然后设置你的 API Key：
export OPENAI_API_KEY="这里替换成你自己的 API Key"四、测试是否成功
启动 Codex：
codex进入 Codex 后，发送这句话：
请用中文回复：算桥 API 测试成功如果 Codex 能正常回复，说明你的链路已经跑通：Codex -> 算桥 API -> 模型通道。
五、常见报错
1. 401 / Unauthorized
通常是 API Key 填错、复制不完整、环境变量没有生效，或者账号/令牌额度不足。请重新复制 Key，并检查后台余额。
2. 模型不存在
请确认模型名称填写为 deepseek-v4-flash，不要多加空格，也不要自己改大小写。
3. unknown variant image_url
这表示你发送了图片，但当前通道只支持文字。请新开对话，用纯文字提问。如果是安装报错，请复制终端里的报错文字。
4. 余额不足
登录平台后台查看账号余额和令牌额度。新用户体验额度用完后，需要充值或联系管理员处理。
六、安全提醒
- 不要公开完整 API Key。
- 不要把平台用于违法违规内容。
- 当前体验通道主要支持文字，不支持图片识别。
- 模型能力、价格和可用性以后端平台展示为准。