CodingCTO
编辑器接入教程

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

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

获取 API Key 查看模型列表查看价格或用量
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 个调用通过
示例配置仅使用已经通过最小调用测试的模型。

快速导航

直接跳到你正在使用的编辑器或命令行工具。

CursorClineRoo CodeContinueWindsurfZedJetBrainsCodex CLIClaude CodeOpenCode

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。

如何使用 API 密钥

在控制台创建 API Key 后，可以把密钥写入对应工具的配置文件。下面覆盖老版“使用 API 密钥”弹窗里的核心方式： Codex CLI、Codex CLI WebSocket、Claude Code 和 OpenCode。示例统一使用占位密钥，请不要把真实 API Key 提交到代码仓库。

Codex CLI
macOS / Linux 配置目录通常为 ~/.codex；Windows 通常为 %userprofile%\.codex。如果目录不存在，请先创建。

macOS / Linux

mkdir -p ~/.codex
# 保存 provider 配置到 ~/.codex/config.toml
# 保存密钥到 ~/.codex/auth.json
codex

Windows CMD

mkdir %userprofile%\.codex
REM 保存 provider 配置到 %userprofile%\.codex\config.toml
REM 保存密钥到 %userprofile%\.codex\auth.json
codex

config.toml

# ~/.codex/config.toml
# 请确保以下内容位于 config.toml 文件的开头部分
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.codingcto.com/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json

{
  "OPENAI_API_KEY": "YOUR_CODINGCTO_API_KEY"
}
Codex CLI WebSocket
如果你使用支持 Responses WebSocket 的 Codex CLI，可以在普通 Codex 配置基础上打开 WebSocket 特性。

macOS / Linux

mkdir -p ~/.codex
# 保存 provider 配置到 ~/.codex/config.toml
# 保存密钥到 ~/.codex/auth.json
codex

Windows CMD

mkdir %userprofile%\.codex
REM 保存 provider 配置到 %userprofile%\.codex\config.toml
REM 保存密钥到 %userprofile%\.codex\auth.json
codex

config.toml

# ~/.codex/config.toml
# 请确保以下内容位于 config.toml 文件的开头部分
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.codingcto.com/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = true

[features]
responses_websockets_v2 = true

auth.json

{
  "OPENAI_API_KEY": "YOUR_CODINGCTO_API_KEY"
}
Claude Code
Claude Code 走 Anthropic Messages 协议。环境变量只在当前终端会话生效；如需永久配置，请添加到 shell 配置文件或 ~/.claude/settings.json。

macOS / Linux

export ANTHROPIC_BASE_URL="https://api.codingcto.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_CODINGCTO_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

claude

Windows CMD

set ANTHROPIC_BASE_URL=https://api.codingcto.com
set ANTHROPIC_AUTH_TOKEN=YOUR_CODINGCTO_API_KEY
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

claude

PowerShell

$env:ANTHROPIC_BASE_URL="https://api.codingcto.com"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_CODINGCTO_API_KEY"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

claude

VS Code / Claude Code settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.codingcto.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_CODINGCTO_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}
OpenCode
配置文件通常为 ~/.config/opencode/opencode.json 或 opencode.jsonc。建议通过环境变量注入 API Key。

macOS / Linux

export CODINGCTO_API_KEY="YOUR_CODINGCTO_API_KEY"
# 配置文件：~/.config/opencode/opencode.json
opencode

Windows CMD

set CODINGCTO_API_KEY=YOUR_CODINGCTO_API_KEY
REM 配置文件通常位于 %APPDATA%\opencode\opencode.json，或项目内 opencode.jsonc
opencode

PowerShell

$env:CODINGCTO_API_KEY="YOUR_CODINGCTO_API_KEY"
# 配置文件通常位于 $env:APPDATA\opencode\opencode.json，或项目内 opencode.jsonc
opencode

opencode.json

{
  "$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",
          "limit": {
            "context": 1050000,
            "output": 128000
          },
          "options": {
            "store": false
          }
        }
      }
    }
  },
  "agent": {
    "build": {
      "options": {
        "store": false
      }
    },
    "plan": {
      "options": {
        "store": false
      }
    }
  }
}

各编辑器接入教程

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。完成配置后，用一条简单提示语验证聊天、文件读取和工具调用是否正常。

获取 API Key查看模型列表查看价格或用量
7×24 小时官方接入支持
需要帮助接入 CodingCTO？
如果你在配置 Cursor、Cline、Roo Code、Claude Code、OpenCode、Codex CLI 等工具时遇到问题， 可以通过 7×24 小时官方客服或开发者交流群获取帮助。
API Key 使用说明
Base URL 配置指导
模型名称更新通知
接口报错排查
编辑器接入问题处理
新功能与产品更新通知