Codex VS Code API 密钥：使用自定义接口

你正在设置的内容

VS Code 中的编码助手通过 HTTP 与模型通信。大多数助手遵循 OpenAI API 格式，这意味着它们接受自定义 Base URL 和 API 密钥，而不是供应商的默认设置。本服务兼容 OpenAI API，因此可以即插即用接入提供该选项的任何工具。

明确另一端的情况。它是由独立提供商运行的一个开放权重模型，针对合法成人用途进行了调整，可在无内容审查的情况下回答。它不是 OpenAI 的 Codex 模型，也不是任何供应商的官方 API。它仅支持文本，上下文窗口为 100,000 token，支持函数调用和 JSON 模式。如需了解 OpenAI 风格路由的详细信息，请阅读 文档；如果只需要地址，请参阅 Codex API Base URL 页面。

以下是到处都要使用的三个值：

获取密钥并先进行测试

在 API 密钥页面 使用 Google 或邮箱密码创建账户。新用户注册后可一键领取 $0.50 试用额度，有效期 7 天，无需银行卡。然后在操作 VS Code 之前先在终端测试密钥。有效的 curl 调用可证明密钥和 URL 正确，后续错误即指向扩展问题。

Copy# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"

# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'

回复是聊天补全 JSON，响应中带有 X-Balance-USD 标头，显示你的剩余额度。将密钥保存在环境变量或扩展的密钥存储中，不要放在仓库里。

Codex 扩展和 CLI：配置文件

OpenAI 的 Codex 工具支持通过主目录中的 TOML 配置文件自定义模型提供商，且文档指出 VS Code 扩展与该 CLI 共享此配置。请根据你的版本查阅最新的 Codex 文档进行验证，因为格式已发生变化。

Copy# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"

[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"

需要检查的要点：

• base_url 以 /v1 结尾，不包含 /chat/completions。
• env_key 是环境变量的名称，而不是密钥本身。
• wire_api 选择请求格式。此服务同时接受 POST /v1/chat/completions 和 POST /v1/responses。先尝试 "chat"；如果你的 Codex 版本需要，则使用 "responses"。
• 从已设置变量的 Shell 启动 VS Code，或在将变量添加到配置文件后重启。macOS 上的 GUI 启动通常无法识别 Shell 导出。

Agent 类工具依赖函数调用。此处支持该功能，包括流式输出的函数调用，但质量因模型而异，因此请先运行一个小任务。在 Cursor 中使用 API 的相关页面介绍了另一种编辑器的类似设置。

Continue、Cline 及其他扩展

第三方扩展各有自己的界面，但模式是固定的：选择 OpenAI 或“OpenAI 兼容”提供商，然后填写 Base URL、密钥和模型。Continue 使用 YAML 配置：

Copy# Continue (config.yaml), model entry
models:
  - name: Hosted uncensored
    provider: openai
    model: uncensored
    apiBase: https://api.getcodexapi.com/v1
    apiKey: YOUR_KEY

Cline 和 Roo Code 在设置面板中提供“OpenAI Compatible”提供商，包含相同的三个字段。名称和菜单经常变化，请在扩展文档中搜索“OpenAI compatible”或“custom base URL”。如果扩展没有 base URL 字段，则无法使用此端点。

节省时间的技巧：

• 除非你希望每次暂停都发送请求，否则请禁用针对托管模型的 Tab 自动补全。聊天和编辑操作成本更低。
• 在日常编辑中设置较小的上下文。向模型发送整个仓库每次都会消耗输入 token。
• 为每个工具使用单独的密钥，以便区分哪个工具使用了你的额度。

哪些编辑器任务适合此模型

具有大上下文窗口的通用文本模型适合许多日常任务：解释陌生代码、为函数编写单元测试、在不同语言间转换脚本、撰写文档字符串和正则表达式，以及在粘贴整个文件时重写模块。100,000 token 的上下文窗口意味着几个中等大小的文件加上你的指令可以放入一个请求中，且补全可以使用剩余的上下文。

对剩余部分要现实一点。它不是带有编辑器感知训练的专用编码模型，因此大型多文件代理运行可能需要比你对专为它们构建的工具给予的更多指导和更多检查。请求差异而不是整个文件，在接受每个更改之前进行审查，并运行你的测试。如果任务需要过滤助手拒绝的内容，例如撰写成人小说框架或用于合法用途的安全研究文本，那么没有内容拒绝的接口就是使用它的原因。

编辑器中的费用

价格为每 1M 输入 token $0.15，每 1M 输出 token $0.50。编码工具发送大量上下文，因此请首先查看输入。

示例：包含 8,000 token 文件上下文的编辑请求和 600 token 的答案，成本为 8,000 x $0.15 / 1M + 600 x $0.50 / 1M = $0.0012 + $0.0003 = $0.0015。一天 150 次此类请求的成本为 150 x $0.0015 = $0.225。20 个工作日：$4.50。

读取多个文件的 Agent 每步可发送 40,000 token。在此大小下，一步的成本为 $0.006 加上输出，因此 100 步的成本约为 $0.60 加上输出。请密切关注 Agent 循环。失败或被拒绝的请求不收费，且额度永不过期。$20 至 $500 的充值可通过银行卡（Visa、Mastercard、Apple Pay、Google Pay）或加密货币支付。当前计划列在 定价页面。

故障排除

401 未授权

密钥缺失、包含多余空格，或环境变量对 VS Code 不可见。从已设置变量的终端重启编辑器。

404 或“模型未找到”

使用确切的模型 uncensored 和以 /v1 结尾的 Base URL。

429 错误

完整密钥允许 8 个并发请求和每分钟 300 个请求；试用密钥允许 2 个和每分钟 60 个。同时触发多个并发请求（如自动补全加聊天）的扩展可能会达到并发限制。错误代码为 concurrency（同时过多）和 rate_limited（每分钟限制）。Retry-After: 5 标头表示临时过载。

流式输出卡住

某些企业代理会缓冲服务器发送事件。请在不同网络上测试，或在扩展中关闭流式输出。

答案与你使用其他助手时看到的不同

这是预期的。这是具有自身优势的不同模型。提供清晰、具体的指令，并在你自己项目的代码上进行测试。

更多指南

• Python 中的 Codex API：调用编码 LLM
• Codex API 基础 URL：如何让你的客户端连接我们的服务