IDE 集成

Cursor 允许你自带 OpenAI 兼容密钥。把 Drawbridge 添加为自定义模型,用于聊天侧栏与行内编辑。

1. 打开 Settings → Models(或 Cursor Settings → Models)。
2. 滚动到 OpenAI API Key 一节并将其开启。
3. 启用「Override OpenAI Base URL」,设为 https://api.drawbridge-tech.com/v1
4. 把你的 Drawbridge API 密钥粘贴为 OpenAI API key。
5. 在「Model Names」下添加一个 Drawbridge 模型 id——例如 claude-opus-4-8 或 smart——然后点击 Verify。
6. 在聊天输入框中选择该模型,开始对话。

注意: Cursor 的聊天侧栏与行内编辑(Cmd/Ctrl-K)开箱即用。Cursor Agent/Composer——那个自主的工具调用循环——也用同一把密钥即可运行(见下文)。

Continue 通过一个 YAML/JSON 文件配置。把 Drawbridge 添加为 OpenAI 提供商模型。它的对话与行内编辑功能与 Drawbridge 很契合。

1. 打开 Continue 配置(config.yaml——命令面板 →「Continue: Open config」)。
2. 添加一个指向 Drawbridge 的模型条目(见下文)。
3. 重新加载 Continue 面板,并从选择器中选取该模型。

models:
  - name: Drawbridge (Claude)
    provider: openai
    model: claude-opus-4-8
    apiBase: https://api.drawbridge-tech.com/v1
    apiKey: your-api-key

较新的 Copilot Chat 版本支持自带 OpenAI 兼容模型。可用于 Copilot Chat(Ask)。

1. 打开 Copilot Chat 模型选择器 →「Manage Models…」。
2. 选择 OpenAI 兼容 / 自定义提供商选项。
3. 把 base URL 设为 https://api.drawbridge-tech.com/v1,并粘贴你的 Drawbridge 密钥。
4. 添加一个模型 id(例如 smart)并在 Copilot Chat 中选中它。

注意: BYOK 的可用性因 Copilot 版本与订阅而异。Copilot Chat(Ask)用你的密钥即可;Copilot 的 agent 模式能否使用 BYOK 模型取决于你的 Copilot 版本。

Cline 及其分支 Roo Code 都提供通用的 OpenAI-Compatible 提供商。它们自主的「Act」循环会驱动原生工具调用——已包含在你的密钥中。

1. 从 VS Code Marketplace 安装 Cline(或 Roo Code)扩展。
2. 打开扩展设置(Cline 面板中的齿轮图标)。
3. 把 API Provider 设为「OpenAI Compatible」。
4. 把 Base URL 设为 https://api.drawbridge-tech.com/v1
5. 把你的 Drawbridge API 密钥粘贴为 API Key。
6. 把 Model ID 设为一个 Drawbridge 模型——例如 claude-sonnet-4-6——并保存。

注意: Cline 与 Roo Code 是 agent 优先的:每一轮都会把你的提示包进一个自主的「Act」循环来驱动工具。原生工具调用已包含在你的密钥中,该循环开箱即用——同一把密钥也能处理纯对话。

通过在 ~/.codex/config.toml 中添加一个自定义模型提供商,把 Codex CLI 指向 Drawbridge。

1. 通过 DRAWBRIDGE_API_KEY 环境变量提供你的密钥。临时(仅当前会话):运行 export DRAWBRIDGE_API_KEY=your-api-key。永久:把同一行追加到 shell 配置文件(macOS 用 ~/.zshrc,Linux 用 ~/.bashrc),再运行 source ~/.zshrc——之后新开的终端会自动加载。
2. 把下面的 provider 配置块加入 ~/.codex/config.toml。
3. 用 drawbridge 提供商/模型运行 Codex。

model = "smart"
model_provider = "drawbridge"

[model_providers.drawbridge]
name = "Drawbridge"
base_url = "https://api.drawbridge-tech.com/v1"
env_key = "DRAWBRIDGE_API_KEY"
wire_api = "responses"

注意: Codex 通过 Responses API 连接(设置 wire_api = "responses")。它自主的编码循环——通过工具调用编辑文件、执行命令——开箱即用,因为原生工具调用已包含在你的密钥中。

Claude Code 通过 Anthropic Messages API 连接。用两个环境变量把它指向 Drawbridge——在你的 shell 中或 ~/.claude/settings.json 中设置。

1. 临时(仅当前会话):export ANTHROPIC_BASE_URL=https://api.drawbridge-tech.com(不带 /v1 后缀),以及 export ANTHROPIC_AUTH_TOKEN=your-api-key。
2. 永久:把这两个变量写入 ~/.claude/settings.json(见下方),让每个 Claude Code 会话都能读到——或把这两行 export 追加到 shell 配置文件(macOS 用 ~/.zshrc,Linux 用 ~/.bashrc)。
3. 照常运行 claude——请求会经由 Drawbridge 路由。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.drawbridge-tech.com",
    "ANTHROPIC_AUTH_TOKEN": "your-api-key"
  }
}

注意: Claude Code 是一个依赖工具调用循环(读写文件、执行命令)的自主编码 agent。它通过 Anthropic Messages API 连接,该接口返回原生工具调用。原生工具调用已包含在你的密钥中,因此 Claude Code 开箱即用。