LondAI Developer KB · Codex

CODEX知识库：从安装到接入 LondAI 中转站

这是一份面向 LondAI 用户的 Codex 实战知识库，覆盖 Codex CLI、Codex App、IDE 插件、CC Switch、API Key、Base URL、模型分组、常见错误和团队使用规范。内容按 LondAI 平台环境重新整理，不复制第三方教程原文。

开始配置 进入用户后台 查看接入文档
CLI / App本地与桌面工作流
CC Switch多模型配置切换
LondAI Key统一余额与计费
londai-codex-setup
# 1. 安装 Codex CLI
npm install -g @openai/codex

# 2. 配置 LondAI Key
export OPENAI_API_KEY="sk-你的LondAIKey"
export OPENAI_BASE_URL="https://www.londai.com/v1"

# 3. 进入项目目录
cd your-project
codex

知识库定位

Codex 是面向软件开发的 AI 编程工具体系，可以在终端、IDE、桌面应用或云端工作流中辅助阅读代码、修改文件、运行命令和做代码审查。LondAI 知识库的重点不是复述官方文档，而是告诉用户如何把 Codex 类工具接到我们的统一模型平台。

给个人开发者

快速完成安装、Key 配置、模型选择和常见报错排查。

给团队负责人

统一 API Key 管理、预算控制、权限分组和使用记录追踪。

给代理客户

可以把这份知识库作为售后教程，降低重复咨询。

说明不同 Codex 版本、不同客户端对自定义 Base URL 的支持可能不完全一致。只要工具支持 OpenAI 兼容接口，就优先填写 LondAI 的地址和用户后台创建的 API Key。

安装 Codex

官方 Codex CLI 可以通过安装脚本、npm、Homebrew 或二进制包安装。普通用户建议优先使用官方安装方式；国内网络环境如果 npm 慢，可以换镜像或手动下载发行版。

Mac / Linux 官方脚本

适合终端用户，安装后直接运行 codex。

Windows 官方脚本

适合 PowerShell 用户，安装前建议打开管理员终端。

Mac / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npm 安装
npm install -g @openai/codex
codex --version
codex

安装前检查

项目建议原因
Node.js建议安装当前 LTS 版本npm 安装和部分工具链依赖 Node 环境
Git建议安装并配置用户名Codex 做代码修改、diff、回滚时更容易追踪
项目目录进入真实代码仓库再启动让 Codex 能读取项目结构和本地约定

接入 LondAI API Key

用户登录 LondAI 后，在用户后台创建 API 密钥。这个 Key 是调用 LondAI 中转站的统一凭证，消费会进入用户余额、订单和使用记录体系。

1

进入用户后台

打开 https://www.londai.com/dashboard，确认账号已经登录且余额正常。

2

创建 API 密钥

进入“API 密钥”，选择可用分组和模型范围。一个 Key 可以调用该分组授权的多个模型。

3

填写 Base URL

大多数 OpenAI 兼容工具填写 https://www.londai.com/v1。如果客户端会自动拼接 /v1，就填写 https://www.londai.com，避免出现 /v1/v1。

通用环境变量

很多开发工具和 SDK 会读取下面两个环境变量。若客户端不识别 OPENAI_BASE_URL，请在客户端设置页手动填写 Base URL。

macOS / Linux
export OPENAI_API_KEY="sk-你的LondAIAPIKey"
export OPENAI_BASE_URL="https://www.londai.com/v1"
Windows PowerShell
$env:OPENAI_API_KEY="sk-你的LondAIAPIKey"
$env:OPENAI_BASE_URL="https://www.londai.com/v1"
不要泄露 KeyAPI Key 不要发给他人，不要写进公开 Git 仓库，也不要放在浏览器可下载的前端代码里。团队使用建议按项目创建独立 Key。

CC Switch 配置 LondAI

CC Switch 适合用来管理多个模型供应商和多个 API Key。你可以把 LondAI 配成一个 OpenAI 兼容供应商，然后在不同客户端里切换模型。

配置项填写内容说明
Provider / 供应商LondAI自定义名称，方便识别
API TypeOpenAI Compatible选择 OpenAI 兼容接口
Base URLhttps://www.londai.com/v1如果工具自动补 /v1，则改填根域名
API Key用户后台创建的 Key格式一般以 sk- 开头
Model按后台模型列表填写如 GPT、DeepSeek、Qwen、Claude 等可用模型名
配置检查清单
1. Base URL 不要重复 /v1
2. API Key 必须来自 LondAI 用户后台
3. 模型名必须属于该 Key 分组
4. 账号余额必须大于本次调用费用
5. 如果管理后台测试成功但用户失败，优先检查 Key 分组和模型范围

模型选择建议

Codex 类工具更看重长上下文、代码理解、稳定流式输出和工具调用体验。LondAI 平台支持多个上游模型，用户可以根据任务类型选择不同模型。

场景推荐方向说明
日常代码问答GPT / DeepSeek / Qwen性价比优先，适合解释代码、生成脚本、写小函数
复杂仓库理解GPT 高阶模型 / Claude 类模型更适合多文件分析、架构梳理、重构计划
中文业务系统Qwen / DeepSeek / Kimi中文上下文理解和国内业务表达更自然
代理客户售后默认分组 + 限额 Key便于控制成本，降低误调用高价模型风险

实际可用模型、价格和分组权限以 LondAI 用户后台与模型价格页为准。若模型无法调用，先确认用户 Key 是否有该模型权限。

实战工作流

新项目开发

先让 Codex 阅读需求和目录结构，再让它生成最小可运行版本，最后逐项补功能和测试。

老项目维护

先让 Codex 总结模块关系，不要一上来大改；每次只改一个功能点，改完跑测试。

代码审查

把关注点写清楚，例如安全、性能、权限、SQL、并发、兼容性，让 Codex 按严重程度列问题。

团队知识沉淀

把项目约定写进 AGENTS.md 或仓库说明里，让后续任务保持同一套工程习惯。

推荐提示词模板

代码审查提示词
请先阅读当前仓库结构，重点检查本次改动是否存在：
1. 权限绕过或鉴权缺失
2. 余额扣费、订单状态、使用记录不一致
3. API Key 泄露风险
4. 前端刷新后状态丢失
5. 缺少必要测试

请按严重程度列出问题，并给出具体文件和修复建议。

常见错误排查

现象原因处理方式
401 UnauthorizedKey 错误、没填 Authorization、Key 被禁用重新复制用户后台 API Key，确认 Header 是 Bearer 格式
404 Not FoundBase URL 拼错或重复 /v1客户端自动补 /v1 时填根域名，否则填 /v1
403 / 模型无权限Key 分组没有该模型编辑 Key 的模型范围，或创建对应分组 Key
余额不足账号余额或套餐额度不够充值后重试，或降低模型档位
管理后台测试成功，用户端失败上游账号可用，但用户 Key 权限未打通检查渠道分组、模型价格、用户 Key 模型范围三处是否一致
输出中断或超时网络波动、模型响应慢、上下文太长降低上下文长度，开启重试，必要时换模型

安全与成本规范

Codex 类工具能读取文件、改代码、执行命令。接入中转站后，还会真实消耗额度，因此要同时管住“权限”和“费用”。

Key 分项目创建 限制模型范围 设置额度预警 不要提交 .env 敏感操作先人工确认 保留使用记录
团队建议给开发、测试、代理客户分别创建不同 API Key，按用途设置模型范围和额度。不要让所有人共用一个高权限 Key。

参考资料

本页内容由 LondAI 结合平台接入经验重新整理，第三方项目只作为资料索引，不复制其原文、图片或排版。

OpenAI Codex GitHub官方 CLI 仓库 OpenAI Codex CLI 文档安装与使用入口 OpenAI Codex IDE 文档编辑器插件入口 codex-orange-book社区知识库灵感来源