AI 编程工具
API 配置与避坑指南

Codex CLI / IDE 扩展读取个人配置文件 ~/.codex/config.toml。官方支持配置模型和提供商，但需要所选服务兼容 Codex 所需的请求协议，并支持目标模型。官方配置文档 ↗

1. 安装并更新官方 Codex，确认本机可以正常运行。
2. 打开 ~/.codex/config.toml，查阅官方文档中的 model_provider、model_providers 和 wire_api 配置方式。
3. 向 API 服务商确认：是否支持 Codex 使用的 Responses 协议、模型名及认证方式。仅仅支持 OpenAI Chat Completions 并不代表一定兼容。
4. 先以小规模测试调用验证工具操作、长输出和稳定性，不要立即大额充值。

Claude Code 有独立的 Anthropic API 调用格式。官方支持通过 LLM Gateway 路由请求，但上游网关必须暴露兼容接口。官方网关文档 ↗

1. 先按官方教程安装并完成基础运行测试。
2. 询问服务商是否明确提供兼容 Anthropic Messages 的网关、工具调用、流式输出及模型 ID。
3. 如果网关确认兼容，可以参考官方示例设置如下环境变量（请使用服务商提供的真实值）：

export ANTHROPIC_BASE_URL="https://YOUR-COMPATIBLE-GATEWAY"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

注意：不要把 API Key 发布到 GitHub 或公开网页中。不同网关的认证头和路径可能不同，应以服务商与官方文档为准。

Cursor 支持在设置中配置部分模型提供商的个人 API Key，但该功能并不覆盖所有 Cursor 特性。官方 API Keys 文档 ↗

1. 打开 Cursor Settings → Models（具体菜单随版本可能变化）。
2. 确认目标提供商和模型位于官方支持范围，按页面说明添加 Key 并点击 Verify。
3. 检查是否支持你要用的自定义 Base URL；若使用第三方聚合 API，应先确认 Cursor 当前版本与该平台的兼容情况。
4. 通过实际聊天、代码编辑等任务测试。Tab Completion 等特定功能可能仍使用 Cursor 自有服务。

API 配置助手

选择工具和系统，查看需要准备什么、官方配置入口，以及可复制的安全示例。Codex 与 Claude Code 有 Ofox 官方接入指南，但本站尚未拿到有效 Key 完成实测；Cursor 官方公告标记为直接接入不兼容。

遇到报错，先检查这些