应天AI

Appearance

AI 应用客户端文档概述 ​

本目录用于介绍如何将应天AI接入常见的 AI 编程客户端、命令行工具和编辑器插件。你可以根据自己的使用习惯选择合适的客户端，再按照对应教程完成安装、配置和调用验证。

适合哪些场景 ​

应天AI提供兼容的模型服务，客户端负责提供具体的使用入口：

  • 在终端中阅读代码、执行任务：选择 Codex CLI 或 Claude Code。
  • 在编辑器中边写代码边使用 AI：选择 VS Code Codex 插件。
  • 使用图形化客户端完成对话和编程任务：参考 Codex + CC Switch 教程。
  • 在多个 AI 应用之间切换服务配置：先安装 CC Switch。
  • 使用支持自定义 OpenAI 兼容接口的编辑器：参考 Trae 接入教程。

文档导航 ​

文档适用对象主要内容
CC Switch 安装与首次配置需要统一管理 Provider 的用户安装 CC Switch、首次启动、导入配置和启用 Provider
Claude Code 安装与 CC Switch 接入想在终端使用 Claude Code 的用户安装 Claude Code、导入 Claude Provider、启动验证和问题排查
Codex CLI 安装与首次使用习惯终端、PowerShell 或 WSL 的用户安装 Codex CLI、验证命令、进入项目和接入 CC Switch
VS Code Codex 插件想在 VS Code 中使用 Codex 的用户安装官方插件、配置 CC Switch、打开面板和验证请求
Codex 配合 CC Switch 接入应天AI已安装 Codex 和 CC Switch 的用户导入 Codex Provider、切换配置、验证模型和查看日志
Trae 接入教程使用 Trae 编辑器的用户配置 OpenAI 兼容模型、发送测试请求和排查接口错误

各大 AI 应用下载与资源总览 ​

以下汇总各客户端的官网、下载入口和开源文档，方便在安装前确认来源。请优先从官方网站或官方仓库获取安装包，避免使用来源不明的修改版。

命令行工具 ​

应用官网下载入口开源仓库官方文档
Codex CLIchatgpt.com/codexGitHub Releasesopenai/codexCodex 文档
Claude Codeclaude.com/claude-code官方安装脚本anthropics/claude-codeClaude Code 文档

编辑器与插件 ​

应用官网下载入口开源仓库官方文档
VS Codecode.visualstudio.com下载页面microsoft/vscodeVS Code 文档
VS Code Codex 插件chatgpt.com/codex扩展市场openai/codexCodex 文档
Traetrae.ai下载页面—Trae 文档

配置管理工具 ​

应用官网下载入口开源仓库官方文档
CC Switchccswitch.ioGitHub Releasesfarion1231/cc-switchCC Switch 文档

模型服务商官网 ​

服务商官网说明
应天AIai.t1qq.com本文档使用的兼容模型服务平台
OpenAIopenai.comCodex 系列工具背后的模型厂商
Anthropicanthropic.comClaude Code 背后的模型厂商

下载地址和文档路径可能随版本更新调整。如果链接失效，请直接访问对应官网首页，从导航中查找下载或文档入口。

推荐阅读顺序 ​

第一次接入应天AI ​

  1. 阅读 API 密钥管理，了解 Token 的创建和管理。
  2. 打开目标客户端的安装教程，完成客户端安装和版本验证。
  3. 创建一枚专用 API Token，并从模型广场确认可用模型名称。
  4. 按对应教程配置客户端或通过 CC Switch 导入 Provider。
  5. 先发送只读测试请求，再查看应天AI的使用日志。

使用 Codex 或 Claude Code ​

如果使用 CC Switch 管理配置，建议按以下顺序阅读：

  1. CC Switch 安装与首次配置
  2. Codex CLI 安装与首次使用 或 Claude Code 安装与 CC Switch 接入
  3. 根据需要阅读 Codex 配合 CC Switch 接入应天AI

切换 Provider 后，应退出并重新启动 Codex CLI、Claude Code 或其他下游客户端，使新配置生效。

使用 VS Code ​

  1. 安装并启动 VS Code。
  2. 完成 CC Switch 安装与首次配置。
  3. 阅读 VS Code Codex 插件，安装 OpenAI 官方 Codex 扩展并完成配置。
  4. 从只读请求开始验证，再检查应天AI调用日志。

使用 Trae ​

直接阅读 Trae 接入教程，按文档准备 Base URL、API Key 和模型名称，然后在 Trae 中添加 OpenAI 兼容模型。

通用接入流程 ​

不同客户端的界面和配置项可能不同，但基本流程一致：

text
安装客户端
  → 创建专用 API Token
  → 选择可用模型
  → 手动填写兼容接口或通过 CC Switch 导入 Provider
  → 启用配置并重启客户端
  → 发送只读测试请求
  → 检查应天AI使用日志

使用前注意事项 ​

网络环境 ​

Codex、Claude Code 及部分客户端运行时需要访问相关服务。使用前请确保当前网络能够正常访问所需服务；如果所在网络无法直接连接，需要准备可用的网络代理或其他合规的网络访问方式。CC Switch 只负责管理和切换本机配置，不会替代网络连接能力。

Token 安全 ​

  • 为不同客户端或用途创建独立 Token。
  • 不要在截图、代码、聊天记录或公开仓库中暴露完整 Token。
  • 根据实际需要限制模型、额度、有效期和 IP 范围。
  • 发现 Token 泄露或异常消耗时，立即停用并重新创建。

首次测试 ​

首次使用建议打开测试项目，并先发送只读请求，例如：

text
请分析当前项目的目录结构，只说明主要目录的用途，不要修改文件。

如果客户端要求修改文件、运行命令、安装依赖或访问网络，请先查看具体操作内容，再决定是否批准。

如何判断接入成功 ​

不要只根据客户端是否返回文字判断配置是否完成。建议同时确认：

  • 客户端能够正常返回测试结果。
  • 使用的 Provider 和模型是目标配置。
  • 应天AI使用日志中出现对应请求。
  • 日志中的状态、模型和 Token 消耗符合预期。

相关入口 ​