QCode 文档中心

Claude Code & Codex 完整文档分类索引,按主题快速找到你需要的内容

60 秒接上
  1. 1
    拿到 API Key
    在 QCode 控制台创建密钥,四个接入域共用同一把。
    打开控制台 →
  2. 2
    填对 BASE_URL
    一条命令自动写好配置;想手填就看接入点对照表(哪些工具要带 /v1)。
    一键配置 → 接入点与 API 格式 →
  3. 3
    接上你的工具
    按工具逐步配置:装什么、改哪个文件、怎么验证。

你想做什么?

4 个常见任务
推荐
🚀
5 分钟接入 QCode
第一次用?从这里开始
🧭
选对工具与 IDE
Claude Code 还是 Codex?哪个 IDE 最顺手?
💰
省钱用得久
选模型、控上下文、看账单
🛠️
排错与进阶
报错怎么查?怎么再进一步定制?

完整文档目录

71 篇
🚀

快速开始

拿到 Key、填对 BASE_URL、跑通第一条请求 9 篇
💻

接入你的工具

IDE / CLI / 桌面端 / 聊天客户端的逐步接入与兼容总览 27 篇
工具兼容总览
本站全部接入页的兼容矩阵:每个工具支持哪条协议、能不能用 Claude 模型、配置写在哪里、最后核实日期,一张表查完
CC Switch 配置
使用 CC Switch 把 QCode.cc 接入 Claude Code 和 Codex CLI:填表、多套餐切换、和官方账号并存、切换未生效与配置被覆盖后的恢复
Codex 完整教程
从安装到精通 — OpenAI Codex CLI 配合 QCode.cc 的完整使用指南
Claude Desktop 接入
在 Claude 桌面版的开发者模式中把 QCode.cc 配置为第三方推理网关,复用同一份 QCode 配额
OpenCode 集成
使用 OpenCode 开源终端 AI 编程助手搭配 QCode API
OpenClaw 接入
把 QCode.cc 配成 OpenClaw 的模型供应商:openclaw.json 的 models.providers 写法、onboard 向导 Custom Provider 路径与验证方法
Hermes Agent 接入
在 Hermes Agent(Nous Research)的 config.yaml 里把 QCode.cc 配成 custom provider:transport 三协议写法、密钥放 .env、会话内热切模型
WorkBuddy 集成
把 QCode.cc 配成腾讯 WorkBuddy 的自定义模型:图形界面填 URL / API Key / 模型名,一把 cr_ 密钥调用 GPT 与国产模型
Google Antigravity CLI 接入
用 QCode 密钥配置 Google Antigravity CLI(agy):settings.json 的 modelProvider 与两个环境变量指向 QCode Gemini 端点
CodeWhale(原 DeepSeek-TUI)集成
把 CodeWhale 接到 QCode.cc:Claude 走 anthropic provider,GPT 与国产模型走 OpenAI 兼容 provider
Zed 编辑器接入
在 Zed 编辑器中通过 ACP(Claude Agent)或 settings.json 的 Anthropic / OpenAI 兼容 provider 接入 QCode.cc
ACP 接入总览
Agent Client Protocol:一份配置在 Zed / Devin Desktop / JetBrains 等宿主里通用——把 Claude Code 当 ACP agent 跑,环境变量指向 QCode
VS Code 集成
在 VS Code 中使用 Claude Code 扩展与 GitHub Copilot 自定义端点:安装扩展、primaryApiKey 配置,以及经 chatLanguageModels.json 接入 QCode
GitHub Copilot 接入
用 GitHub Copilot 自定义端点接 QCode.cc:VS Code 的 chatLanguageModels.json 三种 apiType、Copilot CLI 的 BYOK 变量、JetBrains 支持范围
Trae 集成
在字节 Trae IDE 中使用 Claude Code 扩展(含国内 Trae CN 离线安装指南)
Cursor 编辑器接入
在 Cursor IDE 中通过自定义 Anthropic / OpenAI Base URL + API Key 接入 QCode.cc,含模型配置、自定义端点限制说明与排错
Cline 集成
在 VS Code 中通过 Cline 扩展使用 QCode.cc API
Cherry Studio 接入
在 Cherry Studio 里添加 QCode.cc 自定义服务商:设置到模型服务的路径、四种提供商类型各填什么地址、以及 Agent 功能为什么建议 Anthropic 类型
JetBrains IDE 集成
在 IntelliJ IDEA、WebStorm、PyCharm、GoLand 等 JetBrains IDE 中通过 QCode 使用 Claude Code
Devin Desktop(原 Windsurf)接入
Windsurf 已更名 Devin Desktop 并改为 ACP 架构:把 Claude Code 当 ACP agent 挂进去,环境变量指向 QCode
Gemini CLI 集成配置指南
使用 QCode.cc API 密钥配置 Google Gemini CLI
Kilo Code 接入
在 VS Code 的 Kilo Code 扩展里接 QCode.cc:Settings → Providers → Custom provider,Provider API 选 Anthropic Messages 就能用 Claude
Crush 接入
把 QCode.cc 配成 Charm Crush 的自定义 provider:crush.json 里 type=anthropic + base_url,终端里用 Claude
Droid(Factory)接入
把 QCode.cc 配成 Factory Droid CLI 的 BYOK 自定义模型:~/.factory/settings.json 里 provider=anthropic + baseUrl
Aider 集成
用 QCode.cc 配置 Aider:Claude 走 Anthropic 端点(anthropic/ 前缀),GPT 与国产模型走 OpenAI 兼容端点
SillyTavern 接入 QCode
在 SillyTavern 中用 QCode.cc 的 Claude / GPT 模型聊天;关于 gpt-image-2 出图能否接入的诚实说明与替代方案
Roo Code 接入
在 VS Code 的 Roo Code 扩展里用 QCode.cc:选 Anthropic provider + 勾选自定义 base URL,即可用 Claude
💡

使用技巧

已跑通之后:选模型、省成本、管上下文、写配置文件 16 篇
模型选择指南
了解不同 AI 模型的特点和适用场景,做出最佳选择
费用优化指南
掌握 Claude Code 的费用控制技巧,用更少的 token 完成更多工作
上下文管理
理解和管理 Claude Code 的上下文窗口,有效使用 /compact、/clear 等命令
CLAUDE.md 配置指南
完整掌握 CLAUDE.md — Claude Code 的项目配置文件,包含分层配置、项目模板、团队协作和高级技巧
AGENTS.md 配置指南
Codex 的项目配置文件 AGENTS.md -- 定义 AI 编程助手的行为规范,类似 Claude Code 的 CLAUDE.md
命令行技巧
34 条实用 Claude Code CLI 技巧,助你成为高效开发者
最佳实践
Claude Code 高效使用的最佳实践,从项目初始化到团队协作的全面指南
工作流技巧
高效的 Claude Code 开发工作流程,提升团队协作效率
动态工作流(Dynamic Workflows)
用 Claude Code 的动态工作流编排数十到上百个后台子代理,做全仓评审、迁移与调研 — 通过 QCode 即可使用
输出格式:json / text / stream-json
用 claude -p 的 --output-format 在脚本与 CI 中处理 Claude Code 输出 — json 结构化解析、stream-json 实时事件流、text 默认纯文本,附 jq 与管道实战
权限配置
配置 Claude Code 的权限模式,控制哪些操作需要人工确认
Adaptive Thinking 配置指南
Claude Opus 4.8 / Sonnet 4.6 / Haiku 4.5 的自适应思考机制:thinking + effort 参数用法、与旧 budget_tokens 的差异、效果与成本权衡
国产模型接入
同一把 QCode.cc cr_ 密钥调用 GLM / Kimi / DeepSeek / Qwen:在售 id、协议路径、curl 自测和与 Claude 5 系的搭配
图像输入(视觉)
给 Claude Code 喂图:粘贴、拖拽、引用文件路径,让模型看懂截图、设计稿、架构图与图表。基于 QCode.cc 的视觉模型,所有接入域共用一份 API Key。
gpt-image-2 图像生成与编辑
OpenAI 兼容的 gpt-image-2 文生图 + 图像编辑 API:base_url 切换即用,多入口节点就近接入,与现有 QCode API Key 共享计费
9router 接入 QCode
把 QCode.cc 作为自定义 provider 接入 9router 本地多供应商路由,做多供应商兜底与统一管理

高级功能

Hooks / MCP / 子代理 / 无头自动化 / SDK 9 篇
📖

参考手册

速查、错误码、排查、计费、企业版与可用性对照 10 篇