编辑器接入教程

如何将 CodingCTO 接入 AI 编程编辑器

本文档中的模型名称已通过 CodingCTO API 进行实际验证。验证时间:2026-05-10T20:50:04.855Z。 具体可用模型请以 CodingCTO 控制台展示为准。

OpenAI-compatible
https://api.codingcto.com/v1
用于 Cursor、Cline、Roo Code、Continue、Windsurf、Zed、JetBrains、Codex CLI、OpenCode。
Anthropic Messages
https://api.codingcto.com/v1/messages
主要用于 Claude Code。按工具要求填写 Base URL 或完整 Messages 地址。
验证通过模型
11 个调用通过
失败模型不会作为推荐配置写入编辑器示例。

CodingCTO 是什么

CodingCTO 提供统一的 AI 模型 API 中转能力,支持 GPT 系列模型和 Claude 系列模型。用户可以在 CodingCTO 后台生成 API Key,然后在支持 OpenAI-compatible 或 Anthropic Messages 协议的编辑器中使用这些模型。

验证通过的模型

协议/分组模型 ID验证结果
OpenAI-compatiblegpt-5.3-codex调用通过
OpenAI-compatiblegpt-5.3-codex-spark调用通过
OpenAI-compatiblegpt-5.4调用通过
OpenAI-compatiblegpt-5.4-mini调用通过
OpenAI-compatiblegpt-5.5调用通过
Claude Messagesclaude-haiku-4-5-20251001调用通过
Claude Messagesclaude-opus-4-5-20251101调用通过
Claude Messagesclaude-opus-4-6调用通过
Claude Messagesclaude-opus-4-7调用通过
Claude Messagesclaude-sonnet-4-5-20250929调用通过
Claude Messagesclaude-sonnet-4-6调用通过

推荐模型选择

模型类型模型 ID推荐用途
GPT 验证模型gpt-5.3-codex代码生成、项目理解、Agent 编程
GPT 验证模型gpt-5.3-codex-spark代码生成、项目理解、Agent 编程
GPT 验证模型gpt-5.4复杂代码生成、架构设计、项目重构
GPT 验证模型gpt-5.4-mini日常问答、简单修改、低成本任务
GPT 验证模型gpt-5.5复杂代码生成、架构设计、项目重构
Claude 验证模型claude-haiku-4-5-20251001日常问答、简单修改、低成本任务
Claude 验证模型claude-opus-4-5-20251101复杂推理、大项目分析、长上下文任务
Claude 验证模型claude-opus-4-6复杂推理、大项目分析、长上下文任务
Claude 验证模型claude-opus-4-7复杂推理、大项目分析、长上下文任务
Claude 验证模型claude-sonnet-4-5-20250929编程 Agent、代码修改、文档生成
Claude 验证模型claude-sonnet-4-6编程 Agent、代码修改、文档生成

通用接入方式

Provider

OpenAI Compatible / Custom OpenAI

Base URL

https://api.codingcto.com/v1

API Key

YOUR_CODINGCTO_API_KEY

Model ID

gpt-5.5

Model ID 请从已验证模型列表或 CodingCTO 控制台复制。Claude 模型也可以在 OpenAI-compatible 工具中使用, 前提是使用 Claude 分组 Key 和对应 Claude Model ID。

各编辑器接入教程

01
Cursor
适合在 Cursor Chat、Composer 或 Agent 中使用 CodingCTO 的已验证 GPT / Claude 模型。

Provider

OpenAI Compatible / Custom OpenAI

Base URL

https://api.codingcto.com/v1

API Key

YOUR_CODINGCTO_API_KEY

Model ID

gpt-5.5

Provider 应该选什么

OpenAI API Key / Custom OpenAI

配置步骤

  • Settings → Models → API Keys。
  • 开启 OpenAI API Key,填写 CodingCTO API Key。
  • 开启 Override OpenAI Base URL。
  • Base URL 填写 https://api.codingcto.com/v1。
  • 添加自定义模型,例如 gpt-5.5 或 claude-sonnet-4-5-20250929。

测试提示语

请读取当前项目结构,并总结这个项目的主要技术栈。

注意事项

  • Claude 模型在 Cursor 中走 OpenAI-compatible 模式,使用 Claude 分组 Key 和已验证 Claude Model ID。
02
Cline
适合 VS Code 中的 Agent 编程、文件修改和命令执行。

Provider

OpenAI Compatible / Custom OpenAI

Base URL

https://api.codingcto.com/v1

API Key

YOUR_CODINGCTO_API_KEY

Model ID

gpt-5.5

Provider 应该选什么

OpenAI Compatible

配置步骤

  • API Provider 选择 OpenAI Compatible。
  • Base URL 填写 https://api.codingcto.com/v1。
  • API Key 填 CodingCTO API Key。
  • Model ID 填 gpt-5.5 或 claude-sonnet-4-5-20250929。

测试提示语

请创建一个简单的 README 总结,并先展示你准备修改的文件。

注意事项

  • 如果只能聊天不能改文件,优先检查当前模型和接口是否支持 tool calling。
03
Roo Code
适合 Agent 编程、项目级文件修改、命令执行和多步骤任务拆解。

Provider

OpenAI Compatible / Custom OpenAI

Base URL

https://api.codingcto.com/v1

API Key

YOUR_CODINGCTO_API_KEY

Model ID

gpt-5.5

Provider 应该选什么

OpenAI Compatible

配置步骤

  • 安装 Roo Code。
  • Provider 选择 OpenAI Compatible。
  • 填写 Base URL:https://api.codingcto.com/v1。
  • 填写 CodingCTO API Key。
  • Model ID 从已验证模型列表复制,例如 gpt-5.5。

测试提示语

请检查当前文件夹,并告诉我可以安全运行哪些测试命令。

注意事项

  • 首次使用建议开启确认步骤,避免 Agent 直接执行高风险命令。
04
Continue
适合在 VS Code 或 JetBrains 中做代码补全、聊天和项目问答。

Provider

OpenAI Compatible / Custom OpenAI

Base URL

https://api.codingcto.com/v1

API Key

YOUR_CODINGCTO_API_KEY

Model ID

gpt-5.5

Provider 应该选什么

openai

配置步骤

  • 打开 Continue 配置文件。
  • 添加 CodingCTO 模型配置。
  • apiBase 指向 https://api.codingcto.com/v1。
  • 保存后在模型下拉框中选择 CodingCTO Model。
name: CodingCTO
version: 0.0.1
schema: v1

models:
  - name: CodingCTO Model
    provider: openai
    model: gpt-5.5
    apiBase: https://api.codingcto.com/v1
    apiKey: YOUR_CODINGCTO_API_KEY

测试提示语

请解释当前打开文件的主要逻辑,并指出一个可以改进的地方。

注意事项

  • Continue 示例使用已通过 OpenAI-compatible 调用验证的模型。
05
Windsurf
适合在 Windsurf 中继续使用熟悉的 Agent 编程体验。

Provider

OpenAI Compatible / Custom OpenAI

Base URL

https://api.codingcto.com/v1

API Key

YOUR_CODINGCTO_API_KEY

Model ID

gpt-5.5

Provider 应该选什么

OpenAI Compatible via Roo Code

配置步骤

  • 如果 Windsurf 原生自定义 provider 不方便,可以安装 Roo Code 插件。
  • 在 Roo Code 设置里选择 OpenAI Compatible。
  • Base URL 填 https://api.codingcto.com/v1。
  • Model ID 使用验证通过的模型,例如 gpt-5.5。

测试提示语

请帮我定位当前项目的启动命令,并说明依据。

注意事项

  • Windsurf 的自定义 provider 入口会随版本变化;参数核心是 Base URL、API Key、Model ID。
06
Zed
适合在 Zed 中通过 OpenAI-compatible Provider 使用 CodingCTO 模型。

Provider

OpenAI Compatible / Custom OpenAI

Base URL

https://api.codingcto.com/v1

API Key

YOUR_CODINGCTO_API_KEY

Model ID

gpt-5.5

Provider 应该选什么

openai_compatible

配置步骤

  • 打开 Zed settings.json。
  • 添加 openai_compatible provider。
  • api_url 设置为 https://api.codingcto.com/v1。
  • available_models 中声明已验证通过的模型。
{
  "language_models": {
    "openai_compatible": {
      "CodingCTO": {
        "api_url": "https://api.codingcto.com/v1",
        "available_models": [
          {
            "name": "gpt-5.5",
            "display_name": "CodingCTO Verified Model",
            "max_tokens": 128000,
            "capabilities": {
              "tools": true,
              "images": false
            }
          }
        ]
      }
    }
  }
}

测试提示语

请总结当前文件,并给出一个更清晰的函数命名建议。

注意事项

  • capabilities 和 max_tokens 请以 CodingCTO 控制台及 Zed 当前版本能力为准。
07
JetBrains
适用于 IntelliJ IDEA、PyCharm、WebStorm、GoLand 等 JetBrains IDE。

Provider

OpenAI Compatible / Custom OpenAI

Base URL

https://api.codingcto.com/v1

API Key

YOUR_CODINGCTO_API_KEY

Model ID

gpt-5.5

Provider 应该选什么

OpenAI-compatible

配置步骤

  • Settings / Preferences → Tools → AI Assistant → Providers & API keys。
  • 选择 OpenAI-compatible。
  • Endpoint 填 https://api.codingcto.com/v1。
  • Model 填 gpt-5.5 或 claude-sonnet-4-5-20250929。

测试提示语

请分析当前类的职责,并建议一个小范围重构方案。

注意事项

  • 不同 IDE 版本入口名称可能略有不同,核心参数保持一致。
08
Codex CLI
适合在终端里用 CodingCTO 模型进行代码阅读、修改和命令行协作。

Provider

OpenAI Compatible / Custom OpenAI

Base URL

https://api.codingcto.com/v1

API Key

YOUR_CODINGCTO_API_KEY

Model ID

gpt-5.5

Provider 应该选什么

codingcto custom provider

配置步骤

  • 在 Codex CLI 配置中新增 codingcto provider。
  • base_url 使用 https://api.codingcto.com/v1。
  • 用环境变量 CODINGCTO_API_KEY 注入密钥。
  • model 使用验证通过的 gpt-5.5。
model = "gpt-5.5"
model_provider = "codingcto"

[model_providers.codingcto]
name = "CodingCTO"
base_url = "https://api.codingcto.com/v1"
env_key = "CODINGCTO_API_KEY"

# shell
export CODINGCTO_API_KEY="YOUR_CODINGCTO_API_KEY"
codex

测试提示语

请阅读当前目录并给出你会先检查哪些文件。

注意事项

  • 不要把真实 API Key 写进配置文件。
09
Claude Code
适合在终端里使用 Claude 风格的代码 Agent 工作流。

Provider

Anthropic Messages compatible

Base URL

https://api.codingcto.com

API Key

YOUR_CODINGCTO_API_KEY

Model ID

claude-sonnet-4-5-20250929

Provider 应该选什么

Anthropic Messages compatible

配置步骤

  • 如果工具会自动拼接 /v1/messages,Base URL 填写 https://api.codingcto.com。
  • 如果工具要求填写完整 Messages 地址,填写 https://api.codingcto.com/v1/messages。
  • Model ID 使用验证通过的 Claude 模型,例如 claude-sonnet-4-5-20250929。
  • API Key 使用 CodingCTO Claude 分组生成的 Key。
export ANTHROPIC_BASE_URL="https://api.codingcto.com"
export ANTHROPIC_API_KEY="YOUR_CODINGCTO_API_KEY"

claude

测试提示语

请先概览这个项目,不要修改文件,然后告诉我主要模块。

注意事项

  • Claude Code 通常不能直接使用 /v1/chat/completions,需要走 Anthropic Messages 协议。
10
OpenCode
适合在终端里的 AI 编程 Agent 中接入 CodingCTO OpenAI-compatible 模型。

Provider

OpenAI Compatible / Custom OpenAI

Base URL

https://api.codingcto.com/v1

API Key

YOUR_CODINGCTO_API_KEY

Model ID

gpt-5.5

Provider 应该选什么

@ai-sdk/openai-compatible

配置步骤

  • 创建或编辑 opencode.json。
  • 新增 codingcto provider。
  • baseURL 设置为 https://api.codingcto.com/v1。
  • models 中声明 gpt-5.5。
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "codingcto": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CodingCTO",
      "options": {
        "baseURL": "https://api.codingcto.com/v1",
        "apiKey": "{env:CODINGCTO_API_KEY}"
      },
      "models": {
        "gpt-5.5": {
          "name": "CodingCTO Verified Model"
        }
      }
    }
  }
}

测试提示语

请检查当前项目的 package 脚本,并建议一个验证修改的命令。

注意事项

  • OpenCode 作为 Agent 工具时,同样依赖模型和接口的工具调用能力。

FAQ

Base URL 应该填什么?

Cursor、Cline、Roo Code、Continue、Windsurf、Zed、JetBrains、Codex CLI、OpenCode 填 https://api.codingcto.com/v1。Claude Code 使用 Anthropic Messages 协议,通常填写 https://api.codingcto.com,由工具请求 https://api.codingcto.com/v1/messages。

API Key 应该从哪里获取?

在 CodingCTO 控制台的 API 密钥页面创建。OpenAI-compatible 工具用 openai 分组 Key,Claude Messages 工具用 claude 分组 Key。

为什么提示 Model Not Found?

通常是模型名称写错,或 Key 所属分组没有这个模型。请从本文已验证列表或控制台复制完整 Model ID。

为什么 API Key 无效?

请确认 Key 没有多余空格、没有过期、账户余额正常,并确认使用的是对应分组生成的 CodingCTO Key。

为什么模型列表里有,但调用失败?

模型发现接口只说明模型在列表可见;编辑器接入还需要模型能通过聊天或 Messages 调用。本文示例只使用已经通过最小调用测试的模型。

为什么 Claude Code 不能直接用 OpenAI-compatible 地址?

Claude Code 通常使用 Anthropic Messages 协议,不是 /chat/completions。请按 Claude Code 小节配置 Messages 接入方式。

Claude 模型能不能在 Cursor / Cline / Roo Code 里使用?

可以。本次 Claude 分组模型也可以从 https://api.codingcto.com/v1/models 发现;在这些工具中选择 OpenAI Compatible 后填写 Claude Model ID。

为什么 Agent 工具不能正常修改文件或执行命令?

Agent 工具依赖 tool calling、权限确认和编辑器插件能力。如果当前模型或接口不支持工具调用,可能只能聊天。

如何确认当前模型是否支持 tool calling?

用 Cline、Roo Code 或 OpenCode 发一个需要读取文件的最小任务;如果工具调用不可用,通常会退化成普通聊天或报 capability 错误。

文档里的模型名称是否实时更新?

不是实时更新。本文基于 2026-05-10T20:50:04.855Z 的验证结果生成,最新可用模型仍以 CodingCTO 控制台展示为准。

开始接入 CodingCTO

先创建 API Key,再从控制台或本文验证列表复制 Model ID。完成配置后,用一条简单提示语验证聊天、文件读取和工具调用是否正常。