按实际用量计算
Token 模型分别计算非缓存输入、缓存输入和输出;一次任务可能包含多轮模型调用。
费用与套餐
选择团队人数和付费周期,查看订阅总费用。
每席包含月度模型额度,超出后可按需充值。
01 席位套餐
核心开发功能一致,按模型使用需要选择每月额度。
费用与可选套餐以当前后台配置为准
请输入 1–100,000 之间的整数席位数,当前仍显示上一次有效人数的预估。
正在获取当前费用信息…
以上为新订阅费用预估;增购、升级及企业专享条件,以管理后台订单确认为准。
02 模型费用
先使用套餐内额度,用完后可按需充值。不同模型分别计价。
| 模型 | 输入 非缓存 | 输出 | 缓存输入 |
|---|
公开模型价与企业实际可用范围以后台配置为准。
查看企业可用模型 ↗Token 模型分别计算非缓存输入、缓存输入和输出;一次任务可能包含多轮模型调用。
每席套餐额度优先使用,到期不结转;充值余额与套餐额度分账,按企业资金配置扣减。
每席订阅总费用
企业接入
私有化部署、模型接入与服务支持,结合企业环境、授权范围和交付要求单独报价。
确认使用范围、部署环境与需要开通的模块。
确认模型服务来源和网络;平台私有化不等于模型在本地运行。
确认接入、培训、维护与验收范围,约定各项费用。
一个授权用户占用一个席位,桌面端、IDE 插件、CLI 和多个项目共用。企业按已购席位数付费,未分配或闲置的席位仍计费。
各套餐列明每席每月包含的模型额度,已计入订阅总费用。使用时按所选模型的单价扣减额度,额度用完后可按需充值。
可以在管理后台为成员另行充值。套餐额度按席位独立使用,每个订阅月重新发放,到期不结转;年付也逐月发放。充值余额与套餐额度分账,按企业实际资金配置结算。
增购和升级沿用企业账期,按剩余实际天数补差;降级和减少席位在下次续费生效。更换席位成员不重新发放整月额度,新成员承接当前席位的剩余额度。具体补差以后台订单为准。
当前由企业手动续费,系统不自动下单或扣款。提前支付的续费在原合同到期后生效;到期未续费会停止付费功能,并清空当期套餐额度。
本页展示当前品牌可公开的模型价格,包含适用的分时与活动配置。企业专享价格、模型使用权限和具体资金规则需要登录后查看,实际调用与订单结算以服务端确认为准。
快速开始
准备账号与开发环境,选择合适的入口,完成第一项可验证的任务。
开始前,你需要一个已启用的码哥账号,以及一个有权访问的项目。团队成员可向管理员确认平台地址、所属企业和可用模型。不同交付版本的入口与菜单可能有差异,以实际安装版本为准。
第一次任务最好只涉及一个明确的问题。告诉码哥你希望得到什么、相关文件在哪里,以及怎样判断完成。先让它解释现有逻辑,再进入修改,更容易发现理解偏差。
请先阅读用户列表页面和对应接口,说明当前分页逻辑。
目标:切换筛选条件时回到第一页。
范围:只修改列表页面与必要的测试。
验收:筛选后页码为 1;清空筛选可恢复数据;现有分页行为正常。
请先给出计划,确认相关文件后再开始。左侧入口由品牌配置和租户桌面权限共同决定,未开通的功能不会显示。缺少图标时,请管理员先核对租户设置;模型使用权限另行配置。
本地项目继续使用「智能编码 / Code」。需要连接另一台电脑时,从独立的「协同」入口选择执行电脑,不必复制本地会话;两端版本、权限和连接状态需满足使用条件。
快速开始
选择对应系统的安装包,完成登录,并打开第一个本地项目。
先准备已开通的账号和一个有权访问的本地项目。下载中心从后端获取已发布的安装包;平台、芯片架构、版本、包大小和更新日志均以当前页面为准。不要仅凭电脑品牌选择安装包,也不要将其他品牌或旧渠道的包混用。
请先阅读当前项目,说明主要模块、启动入口和已有检查命令。暂不修改文件;遇到不确定的配置请列出需要我确认的地方。如果登录失败,核对账号、企业和网络;如果模型为空,先让管理员检查使用授权。如果安装后不能启动,记录安装包版本、系统与架构、完整错误信息,再反馈支持人员。不要反复覆盖安装来处理模型权限问题。
快速开始
通过 VSIX 安装,在右侧侧栏使用编码与对话、文件引用和修改审阅。
使用桌面版 VS Code,先查看「关于」中的宿主版本,再与下载中心的插件要求核对。插件包包含所支持平台的编码引擎,不需要先启动桌面客户端。请打开自己有权访问的本地项目,并确认工作区可信。
解释这段提交逻辑,确认成功后是否刷新列表。先指出原因;需要修改时只涉及当前组件,并保留现有错误提示。正式发行包可使用已配置的可信更新源;也可按管理员要求从 VSIX 更新。任务执行期间更新会延后,安装后按提示重载窗口,插件与引擎一起生效。不要将 IDEA 的 XML 仓库地址填入 VS Code 更新设置。
快速开始
从磁盘安装插件,使用代码选区动作,并按企业仓库维护更新。
先在 IDEA 的「关于」中查看宿主版本,再核对官网下载中心列出的插件适配要求。下载正式插件包并保留原始文件,不自行解压后重组。使用企业分发包的团队,还应确认品牌和更新渠道一致。
没有选区时,这组动作不会显示。选区只提供局部信息,涉及接口、调用方或项目约定时,仍需补充相关文件,不能只依据一段代码决定整个模块的行为。
给这段方法补测试,沿用项目已有测试框架。覆盖正常输入、空输入和失败分支;不改动对外接口。在码哥的「编码与对话」设置页可查看版本、渠道和企业插件仓库配置。仅在管理员提供更新源时填写无账号密码的 HTTPS updatePlugins.xml 地址;留空时使用已配置仓库或宿主市场渠道。
快速开始
核对账号与服务器,修改密码和头像,理解成员在线状态与协同连接的区别。
头像上传和读取通过现有 API 域名处理。上传失败时检查格式、大小和网络;保存成功但本机缓存更新失败时,按提示重新登录同步。
管理员能否看到在线成员、设备和版本分布,取决于配套服务端、管理端及品牌、租户和部门权限。旧版本未上报心跳时应按界面标识核对,不能直接视为成员当前离线。
| 状态 | 含义与核对方式 |
|---|---|
| 已登录 | 客户端持有当前账号的登录状态;具体操作仍需有效授权。 |
| 成员或设备在线 | 桌面端、VS Code 与 IDEA 插件登录后独立上报在线状态和真实版本,不依赖打开聊天页、配置模型或开启远程控制。 |
| 远程访问已开启 | 执行电脑允许接入,但还需要建立实际协同连接。 |
| 已连接协同服务 | 执行电脑已连接并完成账号验证,再从控制电脑刷新列表核对在线与能力。 |
开发实践
打开正确的工作目录,用文件引用和清晰的边界帮助码哥理解任务。
项目目录决定编码任务可读取的文件和执行命令的位置。桌面端的「Code / 智能编码」按项目组织本机会话;插件使用宿主当前选定的项目。需要访问其他电脑时,使用独立的「协同」入口,先选择执行电脑,再选择其工作区。名称相似时,应同时核对电脑和实际路径。
文件提供实现细节,任务描述提供目标与判断标准。先说明现象、期望结果和限制;业务规则不明确时,让码哥先提出问题。跨模块修改先要求解释现状与计划,确认后再实施。
项目:当前已打开的客户门户。
现象:提交成功后列表仍显示旧内容。
相关文件:@列表页面 @保存接口调用 @页面测试
范围:保留现有接口与分页规则,不调整权限逻辑。
验收:新增记录立即可见;失败保留输入;不会重复提交。
请先定位原因,并说明准备修改的文件。找不到文件时,先确认项目选择和目录权限,再尝试更完整的文件名。发现回复针对错误项目,停止继续修改,重新打开正确会话并补充路径。长任务更换主题时,新建会话并附上已有结论、必要文件和剩余目标,避免无关历史持续干扰。
开发实践
组织上下文、规划修改、处理工具审批,并审阅最终代码。
码哥可以在当前项目中结合文件和对话处理任务。高质量输入应同时说明目标、现状、范围和验收,而不是只写“帮我优化”。不要让它靠猜测决定重要业务规则。
目标:修复保存后列表未刷新的问题。
现象:提交成功,但必须刷新浏览器才能看到新记录。
上下文:表单组件、列表查询逻辑与保存接口。
验收:新增后列表立即显示;失败时保留输入;不重复提交。
请先定位原因,再做最小必要修改。执行工具时,界面可能要求你批准文件、命令或其他操作。授权前先看清目标、具体命令以及它会影响的范围。运行外部命令所需的环境和访问权限仍由你的项目与企业规则决定。
开发实践
查找和整理会话,区分独立排队与补充当前任务,并核对执行进度。
以下操作以桌面端侧栏为准。智能编码按项目组织会话,智能对话显示对应的会话列表。建议一项明确任务使用一个会话;同一问题的补充信息继续放在原会话中,无关任务单独开始。
名称应便于自己和接续人员识别,避免只写“测试”“问题”。标题只是查找标记,不会替代对话中的业务说明,也不会重命名磁盘中的文件或项目。
任务运行时,普通发送仍会创建按顺序执行的独立排队项。希望修改当前任务要求时,可以对尚未执行的排队项点击「引导」,或在输入框更多操作中选择「补充当前任务」。
| 状态 | 应如何判断 |
|---|---|
| 生成参数 | 模型仍在形成工具调用,命令尚未启动。 |
| 等待前序任务 | 当前调用在排队,先查看前序任务。 |
| 等待授权 | 需要处理工具审批,等待时间与命令执行时间分别记录。 |
| 准备执行 / 执行中 | 命令启动后才开始计算执行耗时;长命令可查看最近输出与静默等待状态。 |
结束但可能还需要查阅的会话优先归档。点击会话的「归档」后,可从搜索区旁的「查看已归档」进入归档列表,再通过「取消归档」恢复活跃状态。
开发实践
分别设置工具审批与全局、项目、会话沙箱,核对命令和安装授权的实际范围。
桌面端在编码输入框旁点击当前权限名称,打开「操作权限」。这里决定 AI 调用工具时如何确认,不是模型使用授权;更换权限方式不能解决账号或模型不可用问题。
| 桌面端选项 | 适用行为 |
|---|---|
| 请求批准 | 编辑文件、执行命令和访问外部资源前询问。 |
| 按需审批 | 自动接受项目内编辑,对检测到的风险操作询问。 |
| 完全访问权限 | 常规操作沿用会话授权,沙箱范围由独立设置控制;仍需确认要求单次批准的操作。 |
| 计划模式 | 分析并制定计划,不修改文件或执行命令。 |
部分请求提供「本次会话全部允许」,部分沙箱外执行只提供本次授权。以实际卡片列出的选项为准,不把一次批准理解为永久允许。跨工作区访问也可能单独请求路径授权,需要重新核对目标。
沙箱控制工具可操作的范围,审批决定操作是否需要批准,两者分别配置。全局默认开启;项目与会话可继承上级、单独开启或关闭。一般按会话、项目、全局顺序确定生效值,管理员策略可约束选择。
沙箱开启时,安装到系统或用户环境的工具需要单次人工授权。「完全访问权限」或已记住的常规会话授权不会跳过这一步。明确安装在项目内的依赖继续按原有规则处理。
反馈异常时记录执行电脑、时间、权限模式、沙箱来源、工具名、脱敏参数与错误提示。会话范围授权可从输入框上方关闭,不影响其他会话。
开发实践
检查真实文件变更和验证结果,在有可靠检查点时联动回退代码与对话。
文件编辑可能已按当前权限策略自动生效。审阅视图展示修改,不代表所有变更都还在等待点击确认。插件从「修改审阅」查看差异;桌面端结合任务中的文件编辑记录和实际文件核对结果。
差异合理与测试通过是两类证据。只看回复中的完成说明不足以验收;也不要因为构建通过,就推断业务行为和所有部署环境都正确。
回退只恢复预览列出的受控文件和相关对话、任务状态,不撤销数据库写入、远程推送或外部系统操作。确认框会说明草稿、后续队列与恢复备份的处理方式,执行前逐项阅读。
开发实践
检查文件和选中行的差异,核对提交,再处理分支、同步、冲突和恢复。
本地提交成功与推送成功分别显示。如果提示“提交已完成,推送未完成”,保留已完成的提交,处理认证或远程目标后重试推送,无需再次提交相同改动。
「分支」用于创建、检出、合并、变基及标签操作;其余入口收在「更多 Git 功能」。
| 入口 | 操作与核对重点 |
|---|---|
| 历史 | 按提交说明、哈希、作者、文件或分支定位记录,选择提交查看版本差异。 |
| 同步 | Fetch 获取引用;Pull 按 Merge 或 Rebase 策略更新当前分支;Push 发布本地提交。 |
| 远程仓库 | 维护远程名称、获取与推送地址;默认推送远程和分支上游分别核对。 |
| Stash | 暂存工作进度,恢复时区分应用并保留、应用并移除。 |
| Worktree | 为独立工作目录管理工作树,操作前确认目录和分支归属。 |
| 高级 | 按需要操作补丁、子模块、Git LFS 等;依赖当前执行环境和对应仓库权限。 |
模型与费用
区分平台模型与企业私有模型,按任务选择,并确认当前账号的实际可用范围。
打开要处理任务的项目,在输入区展开模型选择器。目录由服务端按当前登录身份返回;不同企业、部门和成员看到的模型可能不同。先核对账号和企业,再看模型来源,避免把历史选择当作当前授权。
平台模型由平台提供;企业私有模型由企业自行接入。两类模型即使名称相同,也可能使用不同的连接、权限和计费规则。切换时同时确认名称与来源,不要只凭名称判断。
先用自己的代表性任务比较,再决定常用模型。阅读已有代码、整理说明、跨文件修改和复杂问题排查,对模型的要求不同。用同一组输入和验收条件比较,可以减少由提示内容差异造成的误判。
切换模型不表示之前的文件修改已经撤销,也不代表新模型已验证旧结论。对关键业务规则、未完成步骤和验收要求仍需明确说明。桌面和 IDE 插件分别管理自身项目与会话,不应假定更换入口后会自动出现同一份本地会话。
扩展与配置
添加远程或本地 MCP 服务,检查连接与工具索引,再在任务中使用。
先确认服务提供方支持的传输方式,并准备可访问的测试服务。远程服务需要 MCP URL 与所需请求头;本地服务需要启动命令、参数及运行环境。普通网页地址不能当作 MCP 服务地址。市场提供的扩展也可从「设置 → 扩展市场 → MCP」查看说明并安装。
市场可安装提供远程 HTTP 连接或固定 npm 配置的 MCP。需要自行部署的服务会列出安装条件,不是所有市场条目都支持一键安装;访问和安装资源下载由服务端统一处理,受管理员配置的来源与下载开关控制。
| 方式 | 需要准备 |
|---|---|
| 远程 HTTP | 服务 URL、必要的 Headers;如需 OAuth,准备服务方给出的授权参数。 |
| 本地进程(stdio) | 本机命令、每行一个的参数、可选环境变量与工作目录。 |
保存后点击「刷新状态」,检查服务是否显示「已连接」以及工具数量。连接仍在建立时可稍后刷新;仅看到服务名称不代表工具已可调用。需要 OAuth 的服务可在对应服务中填写授权地址、令牌地址、客户端 ID 和权限范围,打开浏览器完成授权后再检查状态。
扩展与配置
通过扩展市场安装与管理技能,查看任务进度,理解技能检索和按需加载。
打开「设置 → 扩展市场」,选择 Skills 标签,按名称或用途搜索,并按需要筛选来源。可按当前页面切换卡片或列表视图,进入详情阅读介绍、版本、安装内容和兼容性,再决定是否安装。市场访问和安装资源下载由服务端统一处理;来源未开放或下载被停用时,需要管理员检查对应配置。
| 标签 | 用途 |
|---|---|
| Skills / MCP | 查找技能或工具服务,并查看详情和安装要求。 |
| 安装任务 | 查看后台安装的阶段、进度及失败信息。 |
| 已安装 | 管理从市场安装到当前设备的扩展。 |
本机工作区的「更多工具 → 技能」打开 Skills 文档面板。点击技能卡片可预览说明,目录按钮可打开文件所在位置。这里也提供「推荐技能库」,可以勾选需要的内置技能并安装,完成后重新扫描列表。
模型可按任务检索完整的已启用技能目录,选中后再加载技能正文。描述需要完成的工作,必要时明确技能名称,并在实际执行中核对是否采用相关方法;安装很多技能不会把所有正文同时放入每次对话。
扩展与配置
按全局、工作区和会话管理偏好与约定,让长期信息有清晰的适用范围。
记忆用于保留可反复使用的偏好、约定和事实。打开目标工作区与会话,从「更多工具 → 记忆」进入 AI 记忆面板。记忆不是项目文件的完整副本,适合记录简短、明确且相对稳定的信息;临时任务细节仍应在当前会话中说明。
| 范围 | 适合记录 |
|---|---|
| 全局 | 跨项目通用的个人偏好,如回答语言和表达习惯。 |
| 工作区 | 当前项目的技术栈、目录约定和验证方式。 |
| 会话 | 仅对当前任务有用的阶段目标或临时约束。 |
对话过程中也可能自动捕获偏好与约定。列表会区分自动和手动来源,建议定期检查内容是否准确,发现含糊或过时的条目及时编辑。
范围:工作区
分类:约定
内容:本项目的新增页面沿用 src/pages 下的结构;修改完成后运行现有类型检查,记录检查结果。点击条目的「编辑」可调整内容和分类,保存后重新核对。长期有效的条目可标星;单条删除需要确认。面板底部「清空(保留 ⭐)」会按当前范围操作,确认框会说明范围,标星条目会保留。
扩展与配置
把常用任务的目标、范围与验收要求保存成提示内容,快速开始新会话。
模板保存的是提示内容,适合固定的任务组织方式,例如代码审查、缺陷定位、测试补充和项目说明。开始前先整理共用要求,把每次都不同的项目路径、错误信息和验收条件留成容易替换的提示位置。模板不包含之前会话的全部历史,也不会自动复制附件或授予工具权限。
请先定位问题,再提出最小必要修改。
目标:[填写期望行为]
现象:[填写实际行为与复现步骤]
范围:[填写相关目录与需要保留的改动]
验收:[填写检查命令和关键操作]
请报告原因、修改内容、实际检查结果与尚未验证的部分。第一次使用时,可以先用一个范围较小的真实任务,核对模板是否给出了足够的输入和验收条件。结果缺少关键信息时,在模板中补充要求,下一次再使用。
模板能减少重复输入,任务是否完成仍取决于本次上下文、实际工具操作和验证。不同项目使用相同模板时,要重新核对路径、技术约束和检查命令,避免沿用上一项目的信息。
开发实践
配置连接与驱动,在明确的数据库执行查询,并核对 AI 只读分析的 SQL、结果与知识依据。
请基于当前数据库的真实表结构,统计上个月已完成订单的数量与金额。先核对时间字段和状态字段;口径不明确时先提问。请展示实际查询 SQL、结果和未覆盖范围。项目协作
连接自己的其他电脑,或通过邀请参与同组织成员的 Code 工作,管理执行位置与分享权限。
协同是桌面端左侧的独立入口。本机开发继续使用「Code / 智能编码」;进入「协同」后选择另一台电脑,文件、会话和任务操作会送到所选电脑执行。先请管理员确认当前账号所属租户已开通协同模块,并让两端使用支持协同的客户端。邀请分享还需要配套服务端支持。
协同沿用执行电脑的文件、工具与运行环境,不会把任务在控制电脑重新执行。模型同步针对同一远程 Code 会话,不会把所有电脑的独立会话或智能对话统一改为同一个模型。
取消或到期会阻止后续访问及受邀方的终端输入,但不等于自动停止已经发出的任务或结束已启动的 shell。需要终止执行时,由所有者核对原电脑上的任务和终端,再执行相应停止操作。
远程 Code 的文件传输、交互式终端、MCP 配置、浏览器预览等以执行电脑实际上报能力为准。协同不提供通用操作系统桌面控制,也不意味着 IDE 插件、智能对话或其他应用的历史会话自动迁移到云端。
| 现象 | 处理方式 |
|---|---|
| 没有协同入口 | 确认租户模块权限、品牌开放范围与客户端版本;本机 Code 权限和协同权限分别控制。 |
| 已开启,尚未连接 | 到执行电脑刷新状态或重试连接,检查登录与网络;服务连接错误由管理员核对协同服务及 WebSocket 转发。 |
| 离线、需要升级或连接中 | 让目标电脑上线、更新客户端,或等待能力上报后刷新。离线电脑不能实时读取或执行新操作。 |
| 部分功能可用 | 展开「查看此电脑的功能限制」,按具体原因处理,不支持的操作不会转到本机执行。 |
| 邀请失败或已过期 | 核对品牌和组织、邀请码、有效期与是否已被其他账号接受,必要时由所有者重新生成。 |
| 远端已结束,当前仍在同步 | 恢复连接后核对原会话状态与结果,记录两端版本、时间及错误;不要依据暂时的显示延迟反复提交。 |
项目协作
核对工作来源、项目和分类,填写完全人工完成的预计用时,一次确认上传并查看历史。
企业启用清单确认要求后,客户端会提示核对最近一次有工作数据且未上传的日期。完成该日期后即可继续使用;更早待核对记录保留在历史中。通过工作区工具栏的「个人工作清单」可按日历查看本人历史和月度数据。
人工预计用时指“不使用 AI、完全人工完成这项工作”需要的时间。AI 根据已保存的工作内容提供建议和依据,成员可修改。它与自动有效耗时、实际投入以及原工作预算是不同口径。
| 指标 | 核对方式 |
|---|---|
| 自动有效耗时 | 结合原始任务、活动区间及计时依据核对。 |
| 实际投入 | 确认实际花费的时间,必要时按事实修正。 |
| 每项人工预计用时 | 按完全人工完成的工作量估算,检查 AI 建议并填写或修改。 |
| 原工作预算 | 查看事前计划或原有预算,用于对照,不代替本次逐项估算。 |
本机草稿可在重启、断网后保留,但保存草稿不等于上传成功。只有明确提交成功才解除待核对状态;已经保存成功的清单不应重复上传。
项目协作
在管理平台维护项目资料,用桌面 HTML 原型设计校准页面,再交接给开发人员。
本篇中的项目管理、项目文档、我的任务与甘特计划,适用于已开通管理平台项目模块并获得相应权限的团队。仅安装客户端或 IDE 插件,不代表已经拥有这些管理入口。
桌面端另有「HTML 原型设计」工作区,用于生成、编辑、预览与导出页面,项目按账号在本地保存。它与管理平台的项目、文档和正式任务分别维护,不会因创建桌面原型而自动生成平台任务。
先描述要解决的问题,再考虑界面和实现。需求分析建议覆盖背景、目标、角色、场景、范围、约束和验收标准。使用 AI 辅助整理后,仍要由了解业务的人逐项核对。
场景:项目负责人为一项任务指定处理人。
规则:只能选择当前项目成员;普通成员不能重新指派他人任务。
异常:成员被移出项目后,应提示重新分配。
验收:合法分配成功并更新列表;无权限操作被拒绝;非法成员不能保存。生成中断时先查看已有草稿,可从保留的内容继续生成。需要精确调整时手动编辑或接管页面;继续生成时保留已接管内容,重新操作前核对未保存的修改。
将确认后的需求文档、原型文件与验收要求交接给开发人员。桌面 HTML 原型的一键开发可选择已有或新建项目目录、页面范围和技术架构,将设计快照提交到 Code 会话;该流程面向前端开发,不会自动完成管理平台正式任务的创建或分派。
质量实践
明确测试范围,审阅用例,区分配置检查、实际执行与验收结论。
先确定变更影响与测试对象,再选择验证方式。平台中的自动化测试、代码审计和本地项目检查解决不同问题:测试验证行为与断言,审计发现潜在风险,构建或类型检查验证项目的技术约束。
用例:普通成员不能修改他人任务负责人。
前置:成员 A 与成员 B 均在项目内;任务属于 B。
操作:A 尝试修改该任务负责人。
预期:界面不提供越权入口,直接请求也被拒绝。
验证:检查响应与任务数据,确认负责人未改变。记录缺陷、复现步骤、期望行为和证据。修复后保留原有断言进行回归,避免通过放宽用例或移除失败场景掩盖问题。
团队管理
理解可用模型目录、管理权限与使用授权,并按顺序排查不可用问题。
客户端从服务端读取当前账号有权使用的平台模型与企业私有模型。不同账号、部门和企业看到的列表可能不同;本机历史选择不能替代当前授权。
拥有模型菜单的查看、配置或启停权限,并不意味着可以调用模型。普通成员也不必拥有模型管理菜单,才能使用已获授权的模型。管理员身份同样不能绕过指定的使用范围。
私有模型需要明确设置使用权限。创建、启用或设置默认模型都不会自动完成使用授权;未设置时所有人不可用。部门授权采用精确选择,选择父部门不会自动授权未选中的子部门。
在「用量统计 → 用量概览」中选择时间范围,先看 Token、请求数、账号与模型趋势,再进入「日汇总」和「事件流水」。将峰值与项目发布、批量任务和模型切换对应,避免只看单次数据。
企业部署
了解部署边界、准备事项,以及上线、升级和验收的基本流程。
私有化实例使用固定品牌与固定租户。数据库、Redis 与文件卷按客户实例独立部署;实例内不提供品牌、租户创建或切换入口。部署方式、可用模块、模型网络与交付支持范围,应在实施前共同确认。
现有部署手册采用 Docker Engine 24 或更新版本与 Docker Compose V2,建议起步资源为 4 核 CPU、8 GB 内存与 50 GB 可用磁盘。该值用于基础实例准备,实际容量需结合成员数量、文件规模和并发任务评估。
验收应记录环境、版本、账号角色、操作步骤和实际结果。模型调用、企业网络和业务仓库必须在真实交付环境验证,不能用演示或本机测试代替。
模型与费用
分清订阅总费用、套餐模型额度与充值余额,用调用记录核对真实消耗。
年付也按月发放模型额度。额度代表可抵扣的模型消费金额,不是固定的请求次数;不同模型、输入输出规模及计费方式会影响可完成的任务数量。
| 项目 | 含义 |
|---|---|
| 订阅总费用 | 购买席位与套餐服务的费用,不是随调用减少的模型余额。 |
| 套餐模型额度 | 每席每个订阅月发放的模型使用额度,到期不结转。 |
| 充值余额 | 另行充值到指定账户的资金,与套餐额度分账,不能相互当作席位费抵扣。 |
套餐额度先于充值余额使用。启用部门资金后,平台模型按套餐额度、所属部门、逐级上级部门、适用企业公共额度、个人余额的顺序检查可用来源;未授权、停用、余额或限额不足的来源会被跳过,不使用兄弟部门资金。
同一次调用可能由多个来源承担。企业私有模型使用独立用量与额度规则,不扣平台充值余额;供应商侧费用仍按企业与供应商的约定处理。
调用期间可能先预占预计费用,结束后按实际结果结算并释放未用预占。因此账面余额、可动用金额与一次调用显示的预计费用可能不同,不能只用一个数判断扣费是否异常。
帮助与支持
根据具体现象检查身份、目录、执行状态和连接,并保留可用于定位的诊断材料。
| 现象 | 检查 | 恢复方式 |
|---|---|---|
| 登录失败或身份不对 | 账号、平台地址、企业归属、网络和系统时间。 | 按界面提示重新登录;仍失败时请管理员核对账号状态,记录脱敏提示。 |
| 模型目录为空 | 登录是否有效,目录请求是否失败,模型是否启用并向本人开放。 | 恢复连接后重开选择器;让管理员核对模型来源与使用范围。 |
| 能选模型但调用失败 | 当前授权、供应商 / Key、订阅、额度、余额与限额。 | 按具体提示处理对应条件,再用小任务验证;不要反复扩大权限。 |
| 现象 | 检查 | 恢复方式 |
|---|---|---|
| 等待很久没有新输出 | 是否等待工具批准、问题回复、外部命令或网络响应。 | 先处理待确认项;查看执行记录,再决定等待或停止。 |
| 点击停止后不确定是否结束 | 命令与底层工具是否仍在运行,文件是否已修改。 | 等待真实执行结束并核对现场;不要立即重复提交同一写入任务。 |
| 恢复任务时结果不一致 | 实际文件、任务记录、未保存编辑与剩余目标。 | 在当前项目说明已完成和待处理部分,再继续;回退前先预览影响。 |
安装完成与连接成功是不同状态。需要 OAuth 的服务先完成授权;分享配置前去掉令牌、密码和请求头中的凭据。
| 现象 | 检查 | 恢复方式 |
|---|---|---|
| 远程 MCP 连接失败 | 服务是否启用,URL、网络、请求头及授权是否有效。 | 在 MCP Servers 修正配置并保存,查看连接状态与工具数量。 |
| 本地 MCP 无法启动 | command、参数、工作目录、环境变量及本机依赖。 | 补齐所需环境,确认启动内容后保存,再查看运行提示。 |
| 现象 | 检查 | 恢复方式 |
|---|---|---|
| VS Code 看不到码哥 | 插件是否启用、宿主版本是否满足发布包要求、项目是否受信任。 | 运行「码哥:打开编码与对话」,查看右侧辅助侧栏;必要时重启 VS Code 并查看「输出 → 码哥」。 |
| IDEA 没有工具窗口 | 插件是否安装启用,宿主版本与安装包是否匹配。 | 完成插件安装或更新要求的 IDE 重启,再打开项目和码哥工具窗。 |
| 现象 | 检查 | 恢复方式 |
|---|---|---|
| 桌面功能图标消失 | 当前账号、租户桌面功能权限与品牌客户端配置。 | 请品牌管理员核对目标租户已开放模块,保存后在支持的客户端刷新权限。 |
| 在线用户有设备,但远程电脑不可用 | 协同权限、真实身份、执行电脑远程接入及服务连接。 | 在执行电脑确认已连接协同服务;Web IDE 处于模拟视角时先退出租户,平台管理员按需再退出品牌。 |
| 清单有草稿,团队统计没有投入 | 清单是否明确显示已核对上传,以及工作日期和筛选范围。 | 成员完成核对上传后重新查询;本机日志和待上传草稿不能代替上传成功记录。 |
诊断报告不会自动上传。提交前复核截图与日志,移除密码、API Key、访问令牌和不相关业务数据。若无法进入诊断页,仍可先提供版本、操作过程与脱敏错误信息。
问题排查
查看组件与运行状态,预览和导出脱敏报告,并核对客户端版本。
出现本机引擎无法连接、任务状态异常或组件不可用时,打开「设置 → 客户端诊断」。进入页面会自动收集一次检查,稍后也可点击「重新检查」。排查前记下发生时间、客户端版本及复现步骤,便于把报告与实际问题对应。
| 检查项 | 重点核对 |
|---|---|
| 客户端与本机引擎 | 安装包、界面、引擎发布版本和协议是否一致。 |
| 数据与任务、终端组件 | 数据库状态、运行及排队任务、原生组件是否响应。 |
| 模型配置、网络状态 | 已加载的模型数量,以及系统报告的联网状态。 |
逐项阅读状态旁的说明。正常表示该项检查已取得预期响应;需处理或异常需要按提示继续排查;需核实表示当前检查不能得出完整结论。例如系统报告在线,不代表平台、VPN 或 SSH 目标都可访问。模型配置检查不会实际调用模型,也不产生模型费用。
诊断页可点击「检查更新」,也可在「设置 → 关于」查看当前版本、软件更新和更新日志。是否有可用版本及后续操作,以更新面板和当前发布渠道返回的信息为准。升级前先完成或妥善保留正在处理的工作,升级后再运行诊断,确认组件版本与原来的异常是否恢复。
管理端入门
从登录和企业视图开始,按组织、桌面功能、角色、模型与资金的顺序完成团队准备。
在控制台使用已开通的管理账号登录,先核对页面顶部的企业名称和当前身份。普通企业成员直接在所属企业范围内工作;拥有多个管理范围的账号,应先切换到要维护的企业。品牌管理与企业管理是不同视图,企业的成员、模型和资金应在对应企业内处理。
遇到“没有菜单”“不能保存”或“模型不可用”时,记录当前企业、账号角色、具体入口与错误提示,再按相应手册核对。将配置权限临时扩大到全员或全部部门,不能代替逐项排查。
组织与权限
建立部门层级,添加成员账号,并完成角色分配与成员状态维护。
成员的管理菜单与操作由角色控制;租户桌面模块由品牌管理员配置,模型可用范围、项目成员身份和资金使用授权各有自己的配置。只给成员分配一个通用角色,并不自动完成这些授权。
| 操作 | 入口 | 核对事项 |
|---|---|---|
| 调整显示名、邮箱或部门 | 成员行 → 编辑账号 | 保存后复核部门相关的模型、资金和数据访问范围。 |
| 重置登录密码 | 成员行 → 重置密码 | 填写新密码,按需要选择强制下线,再点击确定。 |
| 发送邀请邮件 | 更多操作 → 发送邀请邮件 | 成员需已填写邮箱,操作者需有邀请权限。 |
| 停用离职或暂停使用成员 | 更多操作 → 禁用 | 先核对本人身份、项目交接及席位安排;不要误停用正在工作的成员。 |
组织与权限
分别配置菜单操作和数据范围,再把角色分配给对应成员。
授予列表查看权限,不代表同时授予新增、启停、充值或导出。在线用户查看,以及工作清单查看、效能分析和配置也有各自权限,应按岗位分别授予。模型管理和模型使用授权需要另外配置。
桌面功能由品牌管理员按租户开放。角色中的管理菜单授权不会自动显示被关闭的桌面模块,也不能绕过模块限制。
| 范围 | 适用数据 |
|---|---|
| 不授予部门数据 | 保留菜单与操作授权,不授予部门数据访问。 |
| 本人所属部门 | 仅成员当前所属部门,不含下级。 |
| 本人部门及下级 | 成员当前部门及其有效下级部门。 |
| 指定部门 | 逐个选择的部门,按精确选择生效。 |
| 租户全部部门 | 企业全部有效部门及租户公共配置,需具备相应授予资格。 |
企业设置
集中维护企业资金策略,并区分企业身份登录、应用单点接入和 API 同步。
API 应用只能维护本应用来源的数据。角色写入维护自定义角色资料,菜单权限仍由管理员配置;外部系统字段转换和定时同步任务由对接方实现。API 同步不是企业登录,二者不能互相替代。
项目与质量
在管理端建立正式项目,维护项目成员与职责,并衔接需求、任务和文档。
| 项目角色 | 界面中的职责说明 |
|---|---|
| 所有者 | 完全控制项目。 |
| PM | 管理成员与项目配置。 |
| 开发 / 测试 / 运维 | 分别承担开发、测试验收或部署运行工作。 |
| 只读 | 查看项目内容。 |
桌面客户端的本地代码目录和 HTML 原型工作区,与管理端项目分别维护。创建本地工作区或生成原型,不会自动建立管理端成员关系或正式任务。
组织与权限
由品牌管理员选择租户可用的桌面模块,核对品牌配置与客户端入口。
桌面功能权限由品牌管理员或平台管理员按租户配置。普通租户管理员可以提出开通需求,不能在租户管理视图中自行扩大桌面能力。此功能需要支持它的客户端、管理端与服务端配套更新。
| 分组 | 可配置功能 |
|---|---|
| 开发与协作 | 智能编码、协同、智能对话、企业沟通、终端。 |
| 更多功能 | 数据库工作台、HTML 原型设计、项目开发管理、批量任务、备忘录待办、工具箱。 |
| 任务与扩展 | 任务中心、应用市场。 |
例如,开放「协同」后,还需要执行电脑开启远程访问并成功连接;开放「智能编码」后,成员仍需有可用模型和相应项目访问条件。按具体提示检查对应配置。
| 配置 | 控制内容 |
|---|---|
| 租户桌面功能权限 | 整个租户可以使用哪些桌面模块。 |
| 成员角色与数据权限 | 管理端菜单、操作及获准的数据范围。 |
| 模型使用授权 | 成员可以选择和调用哪些平台模型或企业私有模型。 |
| 项目、资金与协同条件 | 对应项目访问、费用承担与执行电脑接入等条件。 |
组织与权限
按授权范围查看桌面端、VS Code 和 IDEA 的在线设备与版本分布。
支持上报的桌面端、VS Code 与 IDEA 插件在登录后独立报告设备和版本,不需要打开聊天页,也不依赖远程控制开关。在线状态表示终端仍在上报,不能据此判断成员是否正在执行任务或已完成工作。
| 页面信息 | 含义 |
|---|---|
| 在线用户 | 按成员去重,一人同时使用多台设备仍计为一位用户。 |
| 在线设备 | 最近 3 分钟内有有效心跳的终端;一名成员可以有多台。 |
| 未接入上报 | 有过登录但从未接入心跳上报的账号,当前是否在线无法确认。 |
| 最近使用版本 | 未接入上报账号的历史信息,不能据此确认当前正在使用该版本。 |
在线用户页用于查看成员和终端状态。要通过桌面协同或 Web IDE 操作执行电脑,还需开通协同权限,在执行电脑的「设置 → 远程控制」开启接入,并确认已连接协同服务。仅显示在线,或开关已开启,都不足以说明远程任务已经可用。
管理端入门
以本人身份连接执行电脑,区分管理视角、在线上报与 Code 协同权限。
任务实际在选中的电脑上执行,使用该电脑的文件、依赖和执行环境。切换查看其他电脑或会话,已有任务继续在原电脑运行。桌面端也可通过独立的「协同」入口选择执行电脑。
Web IDE 依据登录账号的真实身份访问设备。平台或品牌管理员进入他人的品牌、租户管理空间,不会因此获得其中成员的个人电脑访问权。遇到「请退出模拟管理视角」一类提示,先恢复本人身份。
本篇 Web IDE 操作按本人账号的设备说明。跨用户邀请的接受和受邀电脑操作,请使用桌面端「协同」;不要把桌面协同的共享电脑能力视为浏览器 Web IDE 已支持。
跨用户分享由电脑所有者在桌面协同中发起,接受者必须属于同一品牌、同一组织。邀请码带有效期且只允许一个账号接受;所有者可取消协同,接受者可退出,不能把他人分享的电脑再次分享。此能力需要配套客户端与服务端支持。
分享授予整台电脑的 Code 工作环境访问:可读取和修改 Code 工作区与会话,并运行任务、Git、终端和工具。操作沿用所有者电脑的账号、凭据与执行环境,可能产生由所有者承担的模型费用。系统桌面窗口不在共享范围内。
| 现象 | 检查顺序 |
|---|---|
| 在线用户里有设备,Web IDE 没有可用电脑 | 核对真实账号与租户,再检查协同权限、执行电脑远程接入和服务连接。 |
| 远程控制已开启,仍未连接 | 查看客户端连接状态和异常提示,核对网络、登录与版本。 |
| 提示模拟管理视角受限 | 退出租户;平台管理员按需再退出品牌,然后重新进入 Web IDE。 |
| 设备列表读取失败 | 先恢复请求或重试,不能仅凭读取失败判断电脑已经离线。 |
| 需要操作别人分享的电脑 | 在桌面端「协同」接受邀请并选择电脑;核对邀请有效期、双方品牌与组织、所有者连接状态。浏览器 Web IDE 不作为受邀电脑操作入口。 |
项目与质量
配置工作清单,按上传状态、成员和项目查看投入,理解计划偏差与人工基准。
客户端按有数据且尚未上报的工作日期归集清单。成员核对工作内容、分类、关联项目及每项完全人工完成的预计用时后,一次确认并上传。项目只能选择当前账号有权访问的选项,权限变化后需刷新并重新核对。
| 状态 | 管理端如何解读 |
|---|---|
| 待核对上传草稿 | 已保存采集内容,但尚未正式上传,不计入投入和计划偏差统计。 |
| 已核对上传 | 已确认并成功上传,纳入适用统计;不能再按旧的草稿或不完整标记解读。 |
| 本机历史日志 | 用于成员回看本机活动,不能代替正式上传记录。 |
统计按工作日期归属,补传日期不会改变原工作日期。清单数据受当前租户和部门权限控制,项目名称与工作内容还受项目访问权限限制。看到「受限项目」时,应核对项目授权。
AI 分类和人工预计不会替代实际活动计时。人工基准是估算的对照值,不能把差异直接视为已经证实的个人效率提升。详情中的内容、原始来源和调整原因,应与数值一起阅读。
| 指标 | 依据和用途 |
|---|---|
| 自动估算 / 自动有效耗时 | 由已保存的活动区间计算,区分等待、空档,并去除同一成员重叠计时。 |
| 实际投入 | 成员核对上传时确认的投入,可能包含人工调整;在详情保留自动计算依据与修正记录。 |
| AI 原建议 | AI 根据已保存工作内容给出的完全人工完成时间建议,供成员核对。 |
| 人工预计用时 | 成员确认或修改后的人工基准,用于回顾同一批工作在不使用 AI 时的预计用时。 |
| 原工作预算 / 事前计划 | 工作开展前的计划依据,用于符合条件工作的计划偏差比较。 |
计划偏差 = 对应总实际投入 ÷ 对应总事前计划工时 − 1
人工基准差异 = 对应总实际投入 ÷ 对应人工预计用时 − 1
两项使用各自满足条件的同一批工作,不能将不同范围的总数相除,也不能把人工预计当作事前计划。模型管理
创建供应商连接、配置模型映射,再为部门或成员设置使用授权。
连接管理、测试、启停与密钥内容维护有独立权限,还受部门操作范围限制。把模型分享给其他部门使用,不会同时授予供应商连接或密钥的管理权限。
企业管理
按模型来源配置部门与成员使用范围,区分管理操作权限和实际调用权限。
查看、创建、编辑或启停模型属于管理操作;调用模型属于使用授权。配置人员能看到模型,不代表本人一定能使用。普通成员也不必拥有模型管理菜单,才能在客户端调用获准模型。
准备配置前,先确认企业已开通对应模块、你的角色有该操作权限,并且目标部门或成员处于可管理范围。桌面入口由租户桌面功能权限与品牌客户端配置共同控制;模型授权不会打开被关闭的模块。
当前品牌已启用、已公开的平台模型,在企业未设置使用范围时,默认全部成员可用。显式停用或指定部门、用户的限制仍然生效;不能把默认规则理解为所有平台模型都无条件可用。
企业私有模型未设置使用权限时,所有人均不可用,包括租户管理员和配置人员。创建、启用、设为默认模型,都不会代替授权。私有模型的连接和价格配置也不会自动开放给成员。
目录刷新失败时先恢复连接,不要用旧列表证明当前仍有权限。发送请求时服务端会再次校验;模型在会话中途被撤权后,应重新选择当前获准模型。若目录正确但调用失败,继续检查 Key、供应商状态、额度和配额,而不是反复扩大授权。
模型管理
按成员、批量或组合规则,分别设置平台模型和私有模型消费上限。
| 额度 | 作用 |
|---|---|
| 平台模型额度 | 作为成员使用企业充值余额的个人消费上限,设置上限本身不会充值。 |
| 私有模型额度 | 独立计量企业私有模型使用,不扣减企业充值余额;仍需私有模型授权。 |
组合规则用于按条件统一更新当前命中成员,不代替日常的账号、角色或模型授权维护。部门资金预算和个人额度属于不同限制,实际调用仍需同时满足适用规则。
项目与质量
维护代码源、创建审计项目,核查执行报告并持续跟进问题治理。
报告保存本次执行的审计快照。之后更新问题治理状态,不会改写该次扫描的原始证据;审计也不能代替功能测试和人工验收。
模型与费用
了解采购、分配成员、续费和变更规则,区分席位费用与每月模型额度。
先查看页面的席位策略。若显示「无需席位控制 / 已豁免」,新增或启用成员无需采购席位,该页面不显示采购与分配功能;模型用量和费用按企业现有配置执行。以下采购、分配和续费步骤适用于已启用席位控制的企业。
企业统一采购,同一企业的已购席位使用同一种套餐。一个授权用户占一席,桌面端、IDE 插件、CLI 和多个项目共用该用户席位。费用按已购数量计算,未分配或闲置席位仍计费。
进入页面查看已购、已分配和待分配数量,再根据实际启用人数选择采购数量。成员数量是否受席位上限约束,由企业设置控制;套餐模型额度绑定具体席位,不会因豁免成员人数限制而自动发放。
每个订阅月开始发放对应席位的模型额度,到期清空、不结转。年付同样逐月发放,不会在付款时一次获得全年可自由使用的额度。各席位的套餐额度独立使用,不共享其他席位的额度。
套餐额度与充值余额分账。更换成员免费,新成员承接该席位当期剩余额度,不会重新发放整月额度;原成员的充值余额仍归原成员。更换后原成员账号立即停用并退出登录,操作前应完成交接;企业创建者不能通过更换席位成员撤销权限。
| 变更 | 生效与核算 |
|---|---|
| 增购 / 升级 | 沿用当前账期,按剩余实际天数补差;新增与升级额度按当月剩余天数补发。 |
| 降级 / 减席 | 下次续费生效;年付在年度到期时调整。 |
| 跨人数档位 | 重算全部席位剩余费用;多付部分留作席位费抵扣,不转入模型余额。 |
订阅由企业手动续费,系统不自动下单或扣款。提前支付的续费在原合同到期后生效;到期未续费会停止付费功能,并清空当期套餐额度。请在到期前核对下期人数、套餐和周期。
企业管理
为部门设置余额使用范围、成员限额和共享预算,理解账面余额与成员可用金额的区别。
进入「财务管理 → 部门资金」。若尚未启用,由有权限的管理员在企业设置开通;若没有可管理部门,先核对角色的部门数据范围。资金查看、限额配置、使用授权和充值分别授权,拥有其中一项不代表能执行其他操作。
多个授权取并集,不会重复增加余额或额度。使用余额的授权不会授予资金管理、充值或模型使用权限;成员仍须获得目标模型授权。组织或人员归属变更后,应重新核对后续调用的适用范围。
共享部门覆盖值只能选择钱包所属部门的下属部门;本部门使用成员限额。保存或调低限额会保留本周期已用与在途预占,不会重置预算。取消使用范围也不会删除原预算规则。
| 设置 | 作用 |
|---|---|
| 成员默认月限额 | 约束每名成员;人员覆盖值替代该成员默认值。 |
| 下属部门共享月限额 | 约束对应下属部门的共同消费;与成员限额同时生效。 |
| 金额为 0 | 该范围没有可消费限额。 |
| 不设限额 | 仍受真实余额、使用授权和在途预占约束。 |
充值不会自动启用已停用的钱包。已支付但入账未完成时,保留原订单并核对状态,不要重新支付或改投其他钱包。个人充值与部门充值的到账主体不同,不能只看付款人判断资金属于谁。
成员实际可用金额同时受余额、预占、使用授权、成员限额和共享预算约束,不一定等于部门账面余额。平台模型会先使用套餐额度,再按适用部门资金链检查其他来源,不使用兄弟部门余额。
费用管理
选择正确的到账账户,查询支付结果,并按消费记录对账和申请发票。
充值记录说明资金到账,消费对账说明模型调用消耗,席位订阅说明采购合同与套餐额度。三者用途不同,对账时应先确认自己核对的是哪一种费用。
| 任务 | 需要确认 |
|---|---|
| 企业或部门充值 | 到账账户的充值权限;企业充值还需管理员身份。 |
| 查看消费对账 | 用量读取权限和当前企业的数据范围。 |
| 维护发票资料与申请开票 | 抬头维护、开票申请和撤销分别授权,不应只检查菜单是否可见。 |
| 变更席位订阅 | 前往套餐订阅与席位,按采购、续费、成员更换的独立权限操作。 |
费用管理
从概览和日汇总定位异常,再按调用人、模型与结果核查单次流水。
「重算昨日」是独立的聚合维护操作,仅对获准人员显示。日常查看报表无需执行重算;不要用重算替代排查真实调用。
| 核对项 | 用途 |
|---|---|
| 平台模型 / 私有模型 | 确认调用的实际来源,避免因同名模型而核错费用。 |
| 输入、缓存输入、输出 Token | 理解不同部分的计量与缓存情况,结合适用价格检查。 |
| 成功结果与错误信息 | 区分调用失败、响应缓慢和消费异常,保留准确发生时间。 |