AI 编程工具配置 API 完整教程：Trae / Cursor / Claude Code / Codex / Windsurf

发布日期：2026-05-19 | 适用版本：Cursor 3.4 / Windsurf 2.3.9 / Codex CLI v0.131.0 / Claude Code（2026-05）

核心定义：Trae、Cursor、Claude Code、Codex CLI、Windsurf 是 2026 年主流的五款 AI 编程工具，大多支持自定义 API 端点，填入兼容 OpenAI 协议的接口（如七牛云 AI api.qnaigc.com/v1）即可使用 DeepSeek、Kimi 等国产模型。

五款工具配置方式速览

工具	配置方式	配置位置	支持 OpenAI 兼容接口
Trae	GUI 填写	Settings → Model → Custom	✅
Cursor	GUI 填写	Settings → Models	✅（OpenAI 直接支持）
Claude Code	环境变量	~/.zshrc / ~/.bashrc	支持 Anthropic 格式接口
Codex CLI	配置文件	~/.codex/config.toml	✅
Windsurf	网页配置	windsurf.com/subscription/provider-api-keys	✅（OpenAI Key）

一、Trae：GUI 三步配置，最简单

Trae 是字节跳动出品的 AI 编程工具，原生支持 OpenAI 兼容协议，配置自定义 API 无需编辑任何配置文件。

配置步骤

1. 打开 Trae，进入 Settings → Model → Custom

2. 填写以下三项：

字段	填写内容
API Key	你的 API Key（如七牛云 Key：sk-xxxx）
Base URL	https://api.qnaigc.com/v1
Model Name	模型标识符（如 deepseek-v4-pro）

3. 点击保存，在对话框中选择该自定义模型即可使用

注意事项

● Base URL 必须以 /v1 结尾，不要加尾部斜杠

● Model Name 需手动输入，不会自动拉取可用模型列表

● 配置保存后同时适用于对话（Chat）和代码补全（Completion）功能

切换不同模型

同一个 Base URL 下切换模型只需修改 Model Name 字段：

deepseek-v4-pro → DeepSeek V4（编程任务）
kimi-k2 → Kimi K2（长上下文任务）
其他模型 ID 以模型广场为准。

以七牛云 AI 模型广场实际支持的模型标识符为准。

二、Cursor：支持多家官方 API Key，Tab 补全独立

Cursor v3.4（2026-05-13）是目前市场占有率最高的 AI 编程 IDE，支持直接填入 OpenAI / Anthropic / Google / Azure / AWS Bedrock 的原生 API Key。

配置步骤

1. 打开 Cursor，进入 Cursor Settings → Models

2. 找到对应提供商（OpenAI / Anthropic / Google 等），粘贴 API Key

3. 点击 Verify 验证，再点击 Save

各提供商对应配置

使用场景	提供商选择	API Key 来源
DeepSeek 模型	OpenAI（填入 DeepSeek 兼容 Key）	七牛云 AI 或 DeepSeek 官方
Gemini 模型	Google	Google AI Studio
自建或国内聚合	OpenAI（修改 Base URL）	七牛云 AI 等兼容服务

重要限制

自定义 API Key 仅对 Chat 功能生效，Tab 代码补全（Autocomplete）始终使用 Cursor 自有模型，不受此配置影响。如果你的主要需求是 Tab 补全，自定义 API Key 无法替代 Cursor 订阅。

Override OpenAI Base URL

若需接入国内 OpenAI 兼容服务（如七牛云 AI），在 OpenAI 提供商配置中：

1. 填入国内 API Key（OPENAI_API_KEY 格式）

2. 在 “Override OpenAI Base URL” 输入框中填入：https://api.qnaigc.com/v1

3. 点击 Verify 验证通过后 Save

三、Claude Code：通过环境变量配置国产模型接口

Claude Code 是 Anthropic 出品的终端 AI 编程工具，可通过环境变量指定支持 Anthropic 格式的模型接口。七牛云的相关接口用于调用国产模型。

验证配置：Claude Code 支持通过 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 指定 Anthropic 格式的接口。七牛云 AI 推理兼容 Anthropic Messages 接口格式，填入七牛云的端点和 API Key 后，可调用 DeepSeek、Kimi、GLM 等国产模型。端点地址和模型 ID 以七牛开发者中心最新文档为准。

# 启动 Claude Code 后，在会话内输入
> /status
# 会显示当前认证方式和端点信息

环境变量完整列表

环境变量	作用
ANTHROPIC_API_KEY	Anthropic API 鉴权 Key
ANTHROPIC_BASE_URL	通过环境变量指定 Anthropic 格式接口
ANTHROPIC_BEDROCK_BASE_URL	覆盖 Amazon Bedrock 端点
ANTHROPIC_VERTEX_BASE_URL	覆盖 Google Vertex AI 端点

四、Codex CLI：config.toml 一行搞定

Codex CLI v0.131.0（2026-05-18）是 OpenAI 开源的终端 AI 编程智能体，openai_base_url 字段直接替换后端端点，是五款工具中国内配置最简单的。

配置步骤

# 创建配置目录
mkdir -p ~/.codex

编辑 ~/.codex/config.toml：

#:schema https://developers.openai.com/codex/config-schema.json # 替换为国内兼容端点 openai_base_url = "https://api.qnaigc.com/v1" # 选择模型 model = "deepseek-v4-pro" # 推荐日常配置 sandbox_mode = "workspace-write" approval_policy = "on-request" web_search = "disabled" 设置 API Key 环境变量：

echo 'export OPENAI_API_KEY="你的七牛云API Key"' >> ~/.zshrc
source ~/.zshrc

验证配置（v0.131.0 新增）

codex doctor

codex doctor 会自动检测运行时、认证、网络连通性和 config.toml 格式，所有项目绿色即配置成功。

多 Provider 配置（灵活切换）

[model_providers.qiniu] base_url = "https://api.qnaigc.com/v1" env_key = "OPENAI_API_KEY" name = "七牛云 AI" [model_providers.deepseek] base_url = "https://api.deepseek.com/v1" env_key = "DEEPSEEK_API_KEY" name = "DeepSeek 官方" model_provider = "qiniu" model = "deepseek-v4-pro"

五、Windsurf：BYOK 网页配置，支持 Anthropic Key

Windsurf v2.3.9（2026-05-17，Codeium 出品）从 v1.9.2 起支持 BYOK（Bring Your Own Key），可带入 Anthropic 或 OpenAI 的自有 API Key 使用 Claude 4 及其他模型。

配置步骤

1. 登录 Windsurf 账号，访问 windsurf.com/subscription/provider-api-keys

2. 选择 Provider（Anthropic / OpenAI）

3. 填入对应 API Key

4. 保存后，在 Windsurf 编辑器内的模型选择器中切换到 BYOK 模型

支持的 BYOK Provider

Provider	可用模型	API Key 来源
Anthropic	Claude 4 系列	platform.claude.com
OpenAI	GPT 系列	platform.openai.com
DeepSeek	DeepSeek V3/R1	platform.deepseek.com
Google	Gemini 系列	Google AI Studio
xAI	Grok 系列	console.x.ai
Moonshot	Kimi 系列	platform.moonshot.cn

注意事项

● BYOK 目前仅限 Free 和 Pro 用户，部分高级套餐已内置充足额度，无需配置

● 使用 BYOK 后，费用直接从你的 Provider 账户扣除，不计入 Windsurf Credits

● Windsurf 不支持自定义 Base URL（无法接入七牛云等国内兼容服务），需使用各厂商官方 API Key

国产模型接入：按工具的接口能力配置

七牛云 AI（api.qnaigc.com/v1）兼容 OpenAI Chat Completions 协议，一个 API Key 即可调用 DeepSeek V4、Kimi K2、GLM 等模型。对于 Trae、Cursor、Codex CLI 三款支持自定义 OpenAI 兼容端点的工具，配置如下：

Base URL：https://api.qnaigc.com/v1
API Key：你的七牛云 API Key（portal.qiniu.com/ai-inference/api-key）
模型名称：从 qiniu.com/ai/models 查看实际标识符

工具	是否支持七牛云 AI 接入	配置方式
Trae	✅	Settings → Model → Custom，填 Base URL
Cursor	✅	Settings → Models，Override OpenAI Base URL
Codex CLI	✅	openai_base_url in config.toml
Claude Code	✅	ANTHROPIC_BASE_URL 环境变量
Windsurf	❌ 暂不支持自定义 Base URL	需使用各厂商官方 API Key

配置完成后：模型推荐

不同任务场景下的模型搭配建议：

任务类型	推荐模型	原因
日常代码编写、重构	deepseek-v4-pro	代码能力强，速度快，成本低
复杂架构设计 / 难以复现的 Bug	deepseek-r1	推理增强，逐步分析问题
大型代码库整体理解	kimi-k2	长上下文（128K+），文档阅读能力强

FAQ

Q：五款工具哪个对国内用户最友好？

A：从配置难度看：Trae > Codex CLI > Cursor > Claude Code > Windsurf。Trae 是 GUI 三步配置，最简单；Codex CLI 一行 TOML 配置；Cursor 需要找到 Override Base URL 选项；Claude Code 设置 ANTHROPIC_BASE_URL 即可；Windsurf 暂不支持自定义 Base URL，需要对应官方 API Key。

Q：Cursor 的 Tab 补全为什么不能用自定义 API Key？

A：Cursor 的 Tab 自动补全是其核心差异化功能，使用专有模型和低延迟推理基础设施，官方明确不支持自定义 API Key。对话（Chat）和 Composer 功能可以使用自定义 Key，但 Tab 补全仍走 Cursor 服务器。Q：Claude Code 接七牛云 API 能用吗？

A：可以。七牛云 AI 推理同时兼容 OpenAI 和 Anthropic 两种接口格式，Claude Code 设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 指向七牛云后，可调用 DeepSeek、Kimi、GLM 等国产模型（端点以七牛开发者中心文档为准）。

Q：这五款工具能同时运行吗？

A：可以，它们是独立工具。Trae / Cursor / Windsurf 是 IDE 级别产品，Claude Code 和 Codex CLI 是终端 CLI 工具，实际使用中常见搭配是"IDE（Cursor 或 Trae）+ CLI（Claude Code 或 Codex）"，IDE 处理日常开发，CLI 处理大规模重构或自动化任务。Q：API Key 泄露了怎么办？

A：立即到对应平台撤销（Revoke）该 Key：七牛云 AI 在 portal.qiniu.com/ai-inference/api-key。API Key 不应写入代码仓库，建议用环境变量或 .env 文件（加入 .gitignore）管理。