常见 AI 编程工具接入指南

API Key / Base URL / 模型名称 / Provider

按创建令牌、填写 Base URL、选择模型和验证请求的顺序，完成工具配置并定位常见错误。

开始配置查看故障排查

配置前检查

1. 1

   确认 API 令牌已经创建，并完整复制。

2. 2

   确认 Base URL 使用服务根地址，不重复填写 /v1。

3. 3

   确认 Provider 与工具要求的接口格式一致。

4. 4

   保存配置后发起真实请求，用返回错误定位问题。

快速开始

新用户建议按以下顺序完成配置。每一步都对应一个可验证的结果。

STEP 01创建 API 令牌在控制台创建用于工具接入的 API Key。STEP 02确认 Base URL检查接口地址和 /v1 的填写规则。STEP 03选择模型和 Provider按工具要求填写模型名称和服务商类型。STEP 04验证配置结果保存后发起请求，确认配置已经生效。REFERENCE理解 API Key了解密钥填写位置、权限含义和 401 排查方向。

工具配置

先选择正在使用的工具，再按对应页面填写 API Key、Base URL、模型名称和 Provider。

推荐路径

推荐Claude CodeClaude Code 安装、环境变量和验证入口。推荐CC Switch本地路由、配置导入和故障转移。

命令行工具

CLICodexOpenAI Responses 接口和 /v1 配置。CLIOpenCode/connect 流程和 Provider 写法。CLIOpenClawopenclaw.json 和 OpenAI 兼容接口。CLIHermeshermes model 和自定义端点。

IDE 与编辑器插件

IDEClineProvider 类型、Base URL 和模型名称。IDEContinue配置文件结构和 Provider 类型。IDERoo CodeOpenAI Compatible Provider 配置。IDECursorBYOK 设置和自定义接口支持情况。IDEWindsurfAPI Key 入口和 BYOK 限制。

桌面客户端

DesktopCherry StudioProvider、接口地址和模型名称。

能力接口

Images APIimage2 图片接口生成图片、编辑图片和在线试用。该接口不用于聊天模型配置。

故障排查

根据返回错误进入对应页面，先确认 Key、Base URL、模型名称和 Provider。

FAQ常见问题集中查看 401、404、模型不存在和 Provider 错误。401API Key 无效检查 Key 是否完整、有效，并确认账号权限。404Base URL 路径错误检查 /v1 是否多写、少写或位置错误。Model模型不存在检查模型名称、账号权限和服务商支持情况。ProviderProvider 选择错误按工具页面选择对应接口格式。