配置前准备
请先准备 AIGOKEY 的 API 密钥，并确认要调用的具体模型 ID。Trae 除了需要 API 地址和密钥外，还要求填写模型 ID。
本文使用的 API 密钥为示例格式。请使用你在 AIGOKEY 控制台创建的真实密钥，不要将真实密钥发布到文章、截图、代码仓库或群聊中。
AIGOKEYOpenAI Chat Completions 格式https://llm.aigokey.cn关闭sk-你的API密钥AIGOKEY 提供的实际模型 ID关闭“完整 URL”后，Trae 会按照 OpenAI Chat Completions 格式自动在基础地址后拼接请求路径。若 AIGOKEY 后续向你提供了完整接口地址，则开启该开关并填写服务商提供的完整地址。
在 TraeCode 中配置 AIGOKEY
- 01
打开 TraeCode，进入“设置 > 模型”。
- 02
点击“添加模型”，在模型来源中选择“自定义模型”。
- 03
根据下方速查表完成基础配置。
- 04
高级配置可先保留默认值。只有在明确所用模型系列时，再选择对应的 GPT-5、DeepSeek-4 等模型系列；不要因服务商名称为 AIGOKEY 而选择某个特定系列。
- 05
点击“添加模型”。TraeCode 会验证 API 密钥和服务连接；成功后，模型将出现在模型列表中。
- 06
回到 AI 对话，在输入框右下角打开模型列表，选择 AIGOKEY。
OpenAI Chat Completions 格式https://llm.aigokey.cn关闭AIGOKEY 控制台中对应模型的实际 IDAIGOKEY你的 AIGOKEY API 密钥，例如 sk-你的API密钥TraeCode 的 Auto 模式仅支持内置模型，无法调用自定义模型。使用 AIGOKEY 时，请在模型列表中手动选择它。
在 TraeWork 中配置 AIGOKEY
- 01
打开 TraeWork 桌面版，进入“设置 > 模型”。
- 02
点击“添加模型”，选择“自定义模型”。
- 03
根据下方速查表填写配置。
- 04
根据实际模型能力设置高级配置。不确定上下文窗口、工具调用轮数、Temperature、Top P、Top K 时，建议留空并使用 TraeWork 默认配置。仅当模型本身支持视觉理解时，才开启“支持图片输入”。
- 05
点击“添加模型”。连接验证成功后，即可在 Work、Code 或 Design 模式的模型列表中选择 AIGOKEY。
OpenAI Chat Completions 格式https://llm.aigokey.cn关闭AIGOKEY 控制台中对应模型的实际 IDAIGOKEY你的 AIGOKEY API 密钥，例如 sk-你的API密钥根据 TraeWork 官方说明，添加自定义模型仅支持 TraeWork 桌面版，并且自定义模型仅可在本地环境中使用。
验证配置
添加完成后，先发送一条简单请求，再用实际任务验证模型能力。
请用一句话介绍你自己。请检查下面这段代码是否存在明显问题，并给出修改建议。模型能正常返回内容，即表示 API 地址、API 密钥和模型 ID 已正确配置。
常见问题
提示模型 ID 无效
检查模型 ID 是否从 AIGOKEY 的模型列表或控制台完整复制。AIGOKEY 只是展示名称，不能作为模型 ID 使用。
提示无法连接 API 地址
确认基础地址为 https://llm.aigokey.cn，选择 OpenAI Chat Completions 格式并关闭“完整 URL”。如果服务商提供的是完整接口地址，则开启“完整 URL”并填写该地址。
提示 API 密钥无效
确认密钥没有多余空格或换行，并在 AIGOKEY 控制台检查该密钥是否已失效、被禁用或额度不足。
添加成功但在对话中找不到模型
在模型管理页确认 AIGOKEY 已启用；在 TraeCode 中还应关闭 Auto 模式，再从模型列表手动选择 AIGOKEY。
安全建议
把 API 密钥当作账户凭证管理。
- 不要在公开内容中展示完整 API 密钥。
- 不要把 API 密钥提交到 Git 仓库或写入前端代码。
- 一旦怀疑泄露，应立即在 AIGOKEY 控制台禁用并重新创建密钥。
- 可按设备或项目分别创建密钥，便于后续排查和撤销。