必须正确设置环境变量才能本地运行Codex并调用DeepSeek模型,否则将出现401错误;需在项目根目录创建UTF-8无BOM的.env文件,填入DEEPSEEK_API_KEY和PROXY_AUTH_KEY(以sk-proxy-local-开头加48位小写十六进制字符),并通过node --env-file=.env proxy.mjs验证生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在本地运行 Codex 并让它通过代理调用 DeepSeek 模型,必须正确设置环境变量,否则 codex-bridge 启动后无法读取密钥、认证失败或直接报 401 错误。
准备 .env 文件
进入你解压或克隆的 codex-bridge 项目根目录,确认目录下存在 .env.example 文件。如果没有,手动新建一个名为 .env 的纯文本文件。
这一步不能跳过,因为程序默认只读取 .env,不识别 .env.example 或其他命名。
填写关键环境变量
在 .env 文件中,至少写入以下两行(顺序不限,但必须完整):
DEEPSEEK_API_KEY=sk-你的48位密钥
PROXY_AUTH_KEY=sk-proxy-local-48位随机十六进制字符串
其中 DEEPSEEK_API_KEY 必须是你从 DeepSeek 开放平台 创建并复制的密钥;PROXY_AUTH_KEY 不是随便写的,它用于本地代理鉴权,必须是符合格式的随机值。
生成合法的 PROXY_AUTH_KEY
方法一(推荐,Windows/macOS/Linux 通用):
统一LLM网关 - 一个API对接70+AI模型,使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
打开终端(PowerShell / Terminal / CMD),执行命令:
node -e "console.log('sk-proxy-local-' + require('crypto').randomBytes(24).toString('hex'))"
命令会输出一整行类似 sk-proxy-local-a1b2c3...f4e5d6 的字符串,复制它,粘贴到 .env 中等号右侧。
方法二(手动构造易出错):
不要自己拼接或改写已有密钥,【PROXY_AUTH_KEY 必须以 sk-proxy-local- 开头,后面紧跟 48 个合法十六进制字符(0-9, a-f)】。少一位或多一位、含大写字母或符号都会导致启动失败。
验证环境变量是否生效
保存 .env 后,回到终端,确保当前路径是 codex-bridge 根目录,然后执行:
node --env-file=.env proxy.mjs
如果看到 [codex-bridge] Inbound : auth required (1 key loaded),说明环境变量已成功加载;若提示 Missing DEEPSEEK_API_KEY 或 Invalid PROXY_AUTH_KEY format,请立即检查 .env 文件是否存为 UTF-8 无 BOM 编码、等号前后无空格、密钥未被截断。


















