如何将 CodingCTO 接入 AI 编程编辑器
本文档中的模型名称已通过 CodingCTO API 进行实际验证。验证时间:2026-05-10T20:50:04.855Z。 具体可用模型请以 CodingCTO 控制台展示为准。
CodingCTO 是什么
CodingCTO 提供统一的 AI 模型 API 中转能力,支持 GPT 系列模型和 Claude 系列模型。用户可以在 CodingCTO 后台生成 API Key,然后在支持 OpenAI-compatible 或 Anthropic Messages 协议的编辑器中使用这些模型。
模型经过调用验证
验证通过的模型
| 协议/分组 | 模型 ID | 验证结果 |
|---|---|---|
| OpenAI-compatible | gpt-5.3-codex | 调用通过 |
| OpenAI-compatible | gpt-5.3-codex-spark | 调用通过 |
| OpenAI-compatible | gpt-5.4 | 调用通过 |
| OpenAI-compatible | gpt-5.4-mini | 调用通过 |
| OpenAI-compatible | gpt-5.5 | 调用通过 |
| Claude Messages | claude-haiku-4-5-20251001 | 调用通过 |
| Claude Messages | claude-opus-4-5-20251101 | 调用通过 |
| Claude Messages | claude-opus-4-6 | 调用通过 |
| Claude Messages | claude-opus-4-7 | 调用通过 |
| Claude Messages | claude-sonnet-4-5-20250929 | 调用通过 |
| Claude Messages | claude-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。
各编辑器接入教程
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。
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。
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 直接执行高风险命令。
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 调用验证的模型。
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。
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 当前版本能力为准。
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 版本入口名称可能略有不同,核心参数保持一致。
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 写进配置文件。
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 协议。
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。完成配置后,用一条简单提示语验证聊天、文件读取和工具调用是否正常。