# 华为云码道CodeArts代码智能体 > 深入理解项目上下文的智能编码平台 ## 产品介绍 - [什么是华为云码道CodeArts代码智能体](https://support.huaweicloud.com/productdesc-codeartsagent/codeartsagent_pd_0001.md): 华为云码道CodeArts代码智能体是华为云打造的智能编码产品，深度融合IDE、自主开发模式与代码大模型能力，支持项目级代码生成、代码续写、研发知识问答、单元测试用例生成等核心功能，可高效提升开发者研发效率，带来优质的智能化编码体验。软件开发过程中，开发者面临着项目复杂度高、交付周期短、代码质量要求严苛等多重挑战。华为云码道代码智能体从以 - [产品功能](https://support.huaweicloud.com/productdesc-codeartsagent/codeartsagent_pd_0004.md): 本章节介绍了华为云码道CodeArts代码智能体的主要功能。该服务当前仅在“华北-北京四”区域可用。根据跨文件的代码上下文，支持多种主流开发语言的代码自动生成。依据行级、函数级注释，理解开发人员意图，高效补全代码片段，大幅提升编码效率，让编程过程更加流畅。更多信息请参见智能体对话。支持在编辑器中根据代码上下文预测编码意图，并触发生成代码建 - [产品规格](https://support.huaweicloud.com/productdesc-codeartsagent/codeartsagent_pd_0002.md): 建议在表1中推荐的规格下使用华为云码道代码智能体，以获得最佳的体验。 - [认证证书](https://support.huaweicloud.com/productdesc-codeartsagent/codeartsagent_pd_0003.md): 华为云服务及平台通过了多项国内外权威机构（ISO/SOC/PCI等）的安全合规认证，用户可自行申请下载合规资质证书。合规证书下载华为云还提供以下资源来帮助用户满足合规性要求，具体请查看资源中心。资源中心华为云安全服务提供了网络安全专用产品安全检测证书、软件著作权等证书，供用户下载和参考。具体请查看合规资质证书。合规资质证书 ## 计费说明 - [计费概述](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0001.md): 通过阅读本文，您可以快速了解华为云码道CodeArts代码智能体的计费项、计费模式、续费、欠费等主要计费信息。计费模式华为云码道代码智能体提供了包年/包月和按需计费两种计费模式，以满足不同场景下的用户需求。包年/包月套餐包含体验版、基础版和专业版三个版本，为预付费模式，先付费后使用，按照订单的购买周期结算，购买前需确保账户余额充足。其中， - [计费项](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0002.md): 华为云码道代码智能体的计费项如表1 华为云码道计费项所示。如您需要快速了解华为云码道代码智能体的具体价格，请参见码道代码智能体价格详情。以包年/包月计费模式为例，假设您在2026/05/30 15:50:04购买了华为云码道代码智能体，购买时长为一个月，并在到期前手动续费1个月，则：第一个计费周期为：2026/05/30 15:50:04 - [计费模式概述](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0004.md): 华为云码道代码智能体提供包年/包月和按需计费两种计费模式，以满足不同场景下的用户需求。包年/包月：一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。购买周期越长，享受的折扣越大。一般适用于设备需求量长期稳定的成熟业务。按需计费：一种后付费模式，先使用再付费，按套餐额度外实际消耗的Token用量计费，计费项为千Tokens，按小时 - [包年/包月](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0005.md): 包年/包月是一种先付费再使用的计费模式，适用于对资源需求稳定且希望降低成本的用户。通过包年/包月的计费模式，您可以预先购买华为云码道代码智能体套餐并获得一定程度的价格优惠。本文将介绍包年/包月的计费规则。包年/包月计费模式需要用户预先支付一定时长的费用，适用于长期、稳定的业务需求。以下是一些适用于包年/包月计费模式的业务场景：稳定业务需求 - [按需计费](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0006.md): 按需计费是一种先使用再付费的计费模式，适用于无需预付款、也无需长期合约承诺的用户。本文将介绍华为云码道代码智能体按需计费规则。如果您需要查看MaaS模型即服务支持的模型列表及详细计费规则，请参考文档MaaS模型服务计费项。按需计费适用于Token消耗较大，如果您已开通基础版或者专业版套餐，当套餐内Token配额不足时，具备特定权限的企业管 - [续费概述](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0008.md): 包年/包月套餐续费相关的功能如表1所示。在包年/包月套餐生命周期的不同阶段，您可以根据需要选择一种方式进行续费，具体如图1所示。包年/包月套餐从购买到期前，处于正常运行阶段，套餐状态为“正常”。到期后，套餐状态变为“已过期”，仍可使用华为云码道代码智能体。到期未续费时，仍可使用华为云码道代码智能体，并且您的资源首先会进入宽限期，宽限期到期 - [手动续费](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0009.md): 包年/包月套餐从购买到被自动删除之前，您可以随时在续费管理页面或者码道代码智能体控制台的“订阅管理”页签续费，以延长华为云码道代码智能体的使用时间。套餐到期时间延长至统一到期日，可能产生额外的续费天数，您可以通过续费页面的“续费时长”列核对该天数。可在“手动续费项”、“自动续费项”、“到期转按需项”、“到期不续费项”页签查询全部待续费资源 - [自动续费](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0010.md): 自动续费可以减少手动续费的管理成本。自动续费的规则如下所述：以华为云码道代码智能体的到期日计算第一次自动续费日期和计费周期。华为云码道代码智能体自动续费周期以您选择的续费时长为准。例如，您选择了3个月，华为云码道代码智能体即在每次到期前自动续费3个月。在华为云码道代码智能体到期前均可开通自动续费，到期前7日凌晨3:00首次尝试自动续费，如 - [费用账单](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0011.md): 您可以在“费用中心 > 账单管理”查看资源的费用账单，以了解该资源在某个时间段的使用量和计费信息。包年/包月计费模式的资源完成支付后，会实时上报一条账单到计费系统进行结算。在左侧导航栏中，选择企业管理 > 订阅管理，进入订阅管理页面。在资源列表中找到对应资源，选择目标资源，在如下图所示，复制“所属产品名称ID”列的资源ID。复制资源ID - [欠费说明](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0012.md): 用户在使用云服务时，账户的可用额度小于待结算的账单，即被判定为账户欠费，请及时充值。当使用华为云码道代码智能体套餐的同时，购买了按需计费资源，同时账户中的余额不足以抵扣产生的按需费用。自动续费情况下，可能会因持续性周期扣款而导致账户的余额不足。系统会在每个计费周期后的一段时间对按需计费资源进行扣费。当您的账户被扣为负值时，系统将通过邮件、 - [停止计费](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0013.md): 对于包年/包月计费模式的资源，例如华为云码道代码智能体的包年/包月套餐，用户在购买时会一次性付费，服务将在到期后自动停止使用。如果在计费周期内不再使用包年/包月华为云码道代码智能体，您可以执行退订操作。华为云码道代码智能体包年/包月、按需支持退订。系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户。详 - [原个人版还能继续使用吗？](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0020.md): 原个人版仍支持免费使用及续期，除表1中列出的差异功能外，其余功能与体验版保持一致。原个人版为单席位套餐。如需多人同时使用，请升级至多席位套餐。如果您的原个人版套餐即将到期，请参考手动续费操作进行手动续期。 - [如何计算即时变更的费用？](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0027.md): 即时变更费用计算公式即时变更费用=(新套餐价格-当前套餐价格)*套餐剩余时长计费示例说明假设，您于2026/05/01 00:00:00购买了码道体验版套餐（0元/月），购买时长1个月，并开通了自动续费功能。系统于2026年5月24日03:00自动完成续费操作后，您的计费周期将划分为以下两个阶段：第一个计费周期为（初始有效期）：2026/ - [原个人版可以变更到体验版吗](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0023.md): 答：不支持将原个人版变更到体验版，原个人版即体验版，您可以从原个人版变更到基础版或者专业版。 - [为什么变更套餐后没有立即生效？](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_00115.md): 问：在码道代码智能体控制台提交套餐变更后，新套餐没有立即生效？答：套餐变更分为即时变更和续费变更两种方式（如表1）。如果您在变更套餐时，变更类型选择了续费变更，则需等到当前套餐到期后，新套餐才会生效。 - [提交套餐变更申请时，提示“资源已在流程中”？](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0017.md): 问：在码道代码智能体控制台提交套餐变更申请时，提示资源已在流程中（订单续费中，订单未支付等），请至费用中心-订单管理-我的订单中查看详情。答：订单续费等操作尚未完成支付或存在暂未生效的订单。请按照以下步骤排查并解决。进入待支付订单页面，检查是否存在未支付的订单。如果存在，请完成支付再重新提交套餐变更申请。如果仍然报错，请执行2。如果不存在 - [套餐未到期，Token额度不足还能继续使用吗](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0019.md): 问：套餐没到期，但是套餐额度已用完，还能继续使用华为云码道代码智能体吗？答：原个人版或体验版套餐的Token额度耗尽时，用户可继续使用华为云码道代码智能体，但是会降低排队优先级，建议您升级套餐；对于基础版或专业版用户，如果套餐内Token额度已耗尽，并且没有开通按需计费，您仍然可以继续使用华为云码道代码智能体，但排队优先级会降低。如果需要 - [同时开通包年/包月套餐和按需，Token如何抵扣消耗](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0021.md): 问：如果用户同时开通包年/包月套餐和按需，Token如何抵扣消耗？答：系统将优先扣减包年/包月套餐的Token额度，套餐额度全部消耗完毕后，后续调用产生的Token消耗统一采用按需计费方式核算。 - [席位自带Token是否单独扣费出账](https://support.huaweicloud.com/price-codeartsagent/codeartsagent_billing_0022.md): 问：基础版、专业版套餐自带的配套Token额度，出账时是否单独计费并列入账单？答：席位自带的Token费用不单独出账，账单仅体现席位费用。 ## 快速入门 - [IDE](https://support.huaweicloud.com/qs-codeartsagent/codeartsagent_qs_0001.md): 华为云码道代码智能体IDE，把AI深度融入你的开发环境。有这位智能伙伴全程相伴，你的编程体验将变得无比流畅与高效。本视频演示华为云码道代码智能体IDE的安装部署、开发调试及效果验证。因产品功能演进，操作界面可能存在差异，相关视频仅供参考，具体以实际环境为准。你可参考文档注册华为账号并开通华为云，进入华为云官网注册华为账号。运行环境：Win - [Visual Studio Code](https://support.huaweicloud.com/qs-codeartsagent/codeartsagent_qs_0002.md): 你可参考文档注册华为账号并开通华为云，进入华为云官网注册华为账号。下载并安装Visual Studio Code，版本需为1.95.3（2024年11月13日）及以上。运行环境：Windows 10 (x64，2019 及以上版本) / Windows 11 (x64)。运行环境：Windows 10 (x64，2019 及以上版本) / - [IntelliJ IDEA](https://support.huaweicloud.com/qs-codeartsagent/codeartsagent_qs_0003.md): 你可参考文档注册华为账号并开通华为云，进入华为云官网注册华为账号。下载并安装IntelliJ IDEA（版本需为2022.3~2026.1）。运行环境：Windows 10 (x64，2019 及以上版本) / Windows 11 (x64)。在IntelliJ IDEA侧边栏中可查看到图标 ，说明插件安装成功。如果你的账号未开通套餐， - [码道CLI](https://support.huaweicloud.com/qs-codeartsagent/codeartsagent_qs_0004.md): 你可参考文档注册华为账号并开通华为云，进入华为云官网注册华为账号。运行环境：Windows 10 (x64，2019 及以上版本) / Windows 11 (x64)。未登录状态下，系统会自动跳转至外部浏览器的华为云登录页，你输入账号信息完成授权，即可登录码道CLI。浏览器授权仅对此次窗口生效。浏览器未自动打开时，你需要关闭弹窗拦截，或 ## 用户指南（IDE） - [什么是华为云码道代码智能体IDE](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0101.md): 华为云码道代码智能体IDE是华为云CodeArts系列中的AI编程环境，深度融合AI能力至开发工具链中，为开发者提供智能化、高效化的编程体验。为确保最佳兼容性与性能表现，推荐使用以下系统配置：Windows操作系统：推荐使用Windows 11 (x64)；如果使用Windows 10 (x64)，系统版本需为2019年及以上，建议升级至 - [快速启动](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0002.md): 介绍华为云码道代码智能体IDE的安装过程，助力用户快速开启智能编码体验。在使用华为云码道代码智能体IDE进行编码前，需要参考如下内容，提前申请华为账号并购买套餐。进入华为云官网，单击页面右上角的“注册”。参考注册华为账号并开通华为云中操作，完成注册。（可选）注册成功后，进行实名认证。如果您需要购买基础版或专业版套餐，请在购买前完成实名认证 - [内置智能体](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0052.md): 智能体（Agent）是面向多样化开发场景的编程助手。华为云码道代码智能体内置了多款开箱即用的智能体，这些智能体无需手动创建，即拿即用，旨在为多种开发场景提供高效的编程辅助。内置主智能体包括系统内置和码道内置两类，二者均为华为云码道代码智能体内置的主智能体，不支持用户删除，具体区别如表2所示。在华为云码道代码智能体中，子智能体是主智能体的A - [自定义智能体](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0051.md): 智能体（Agent）是面向多样化开发场景的编程助手。华为云码道代码智能体不仅内置了多种智能体，还支持自定义智能体功能。在自定义智能体中，通过灵活配置提示词（Prompt）、技能（Skill）及工具集，您可以打造专属助手，从而更高效地应对复杂开发任务。仅基础版和专业版套餐支持创建云端智能体。自定义智能体按创建方式分为本地和云端两类，按作用范 - [智能体对话](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0005.md): 智能体模式是华为云码道代码智能体核心功能，主要用于理解开发者复杂需求并自主规划执行路径，帮助研发人员在端到端开发任务场景下，实现从需求分析到代码落地的全流程自动化，显著提升开发效率。智能体具备多种核心能力，覆盖需求理解、任务规划、代码实现、工具调用的全流程，具体包括：复杂任务规划与管理：可将自然语言需求转化为结构化的执行步骤，根据执行进度 - [沙箱](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0045.md): 沙箱（Sandbox）为智能体生成的指令提供隔离且受限的执行空间。通过严格的权限管控，确保命令在安全隔离的环境内运行，有效阻断对未经授权资源（文件、网络等）的访问或者高风险命令（权限修改等）的执行。对于被拦截的命令，智能体会在对话流中发出风险提示，经由用户二次确认后，命令才会在沙箱外被执行。使用沙箱具备如下优势：构建数据泄露防线：基于沙箱 - [多会话管理](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0034.md): 传统模式下，单个项目中任务采用串行执行方式，同一时间仅可执行单个任务，执行效率较低。多会话管理功能可突破上述限制，同一时间支持多任务并行执行，有效提升整体开发效率。如果没有正常显示华为云码道代码智能体的聊天窗口，请在顶部菜单栏的右上方，单击展开AI侧栏图标 ，即可打开华为云码道代码智能体。在对话框输入您想要完成的任务，单击发送图标 或使用 - [检查点](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0040.md): 检查点（Checkpoint）是华为云码道代码智能体内置的代码状态自动快照与回退机制。系统会自动跟踪智能体运行期间的文件编辑操作，在每次AI编辑前自动保存当前代码与对话状态，用于快速撤销、回退和历史版本恢复。此功能适用于需要快速试错、安全编辑和一键回退的AI辅助开发场景。华为云码道代码智能体的自动跟踪功能如下：跟踪所有编辑：自动跟踪AI文 - [Diff视图](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0023.md): 在华为云码道代码智能体中，无论是创建新文件还是编辑现有文件，所有代码更改都会在代码编辑区以清晰直观的Diff视图展示。这使得您在应用更改前后可以轻松审查每个修改细节，确保每一次调整都能全面可见与掌控。仅支持在智能体、自定义智能体模式下使用。新增行以绿色背景显示。删除行以红色背景显示。在智能体中，通过Diff视图展示上下文变更，使变更内容更 - [LSP](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0003.md): 语言服务器协议（Language Server Protocol，简称LSP）是一种用于提供语言服务的标准化协议。LSP将语言服务与IDE进行了解耦，由独立的语言服务器进程来提供代码分析、快速导航及符号查询等核心能力。华为云码道代码智能体已预置本地LSP功能。开启该功能后，智能体可基于语言服务提供代码分析结果、代码跳转及符号信息，实现更精 - [模型](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0053.md): 企业成员支持在华为云码道代码智能体客户端添加第三方大语言模型。若您已购买华为云码道代码智能体专业版套餐，同时支持在控制台添加第三方大语言模型，具体请参见配置企业自定义模型。已将账号添加至企业成员中，并启用席位。若您已购买华为云码道代码智能体专业版套餐，请确保企业管理员已在控制台开启成员自定义模型权限，具体操作请参考配置企业自定义模型。若您 - [代码续写](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0007.md): 华为云码道代码智能体支持在编辑器中根据代码上下文触发生成代码建议，支持自动触发续写和快捷键触发续写。代码补全功能为降低推理延迟，采用专属内置模型提供服务，不支持自定义模型。代码续写支持单行智能补全剩余代码、多行批量生成完整代码块。智能补全当前单行剩余代码，适用于写简单赋值、单步函数调用等单行代码场景。批量生成后续多行完整代码块，适用于写函 - [智能问答](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0008.md): 在代码开发过程中，您可以随时向华为云码道代码智能体提问，它将快速检索研发知识并精准返回答案，助您高效解决开发难题。在编码过程中遇到问题时，您都可以通过侧边对话框与华为云码道代码智能体进行对话，快速获取解决思路。参考快速启动操作，登录华为云码道代码智能体IDE。在聊天界面的输入框下方选择内置 > 智能问答，切换到智能问答模式。右侧显示当前选 - [定时任务](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0049.md): 通过创建定时任务，让系统按照设定时间或频率自动执行预设操作并输出执行结果，全程无需人工干预，助您轻松解放双手。定时任务默认处于启用状态，即状态为“生效中”。 - [添加上下文](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0009.md): 华为云码道代码智能体支持通过引入上下文信息来提升问答准确性。上下文能帮助智能体更准确地理解您的问题背景与意图，从而提供更贴合实际、更具价值的解答。当前支持多种上下文类型，包括File（文件）、Folder（文件夹）、Symbol、Git、Terminal（终端）、Problems（报错信息）和Knowledge Bases（知识库）等。所 - [规则](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0019.md): 通过自定义规则（Rule）对智能体行为进行约束，使其更准确地理解并严格遵循相关规范。规则按创建方式可分为本地与云端，按作用范围可分为企业级、团队级、项目级和个人级。用户可根据具体开发场景与协作需求，选择最适合的规则进行设置，实现灵活高效的代码管理。若存在名称相同的规则，规则调用优先级为：云端企业级 > 云端团队级 > 本地项目级 > 本地 - [知识库](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0013.md): 华为云码道代码智能体具备基于知识库的问答增强能力，支持开发者将企业内部文档、技术资料等知识内容上传至知识库，并作为上下文参考进行智能问答。通过融合企业专属知识，AI生成的回答更精准、更贴合实际业务场景，显著提升开发效率与技术决策的准确性。知识库主要应用于华为云码道代码智能体插件的单元测试生成、代码续写和研发知识问答等场景，可显著提升智能体 - [多模态输入](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0026.md): 华为云码道代码智能体支持上传图像及附件，可将其作为对话上下文融入会话。您可以直接上传或拖拽报错截图、代码截图、技术文档等素材至聊天输入框中，省去冗长文字描述，即可完整清晰的还原问题场景，实现精准高效的需求沟通。下面以在智能体中上传代码片段截图为例，详细说明如何识别图片中的内容。参考快速启动操作，登录华为云码道代码智能体IDE。在聊天界面的 - [记忆](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0039.md): 记忆功能是华为云码道代码智能体为您提供的一项个性化设置，用于记录您在使用过程中形成的习惯与偏好，如您偏好的回答风格、常用语言等。开启后，AI将会从您的历史会话中提取您的个性化偏好信息，并在后续的对话中自动应用这些设置，从而为您提供更贴合需求的服务体验。启用记忆功能，具备如下优势：个性化代码补全AI不仅可以预测代码中下一行内容，还可以根据您 - [代码库索引](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0001.md): 你可以为项目构建索引，来提升AI在代码库中的检索速度与准确度，使结果更贴合你的需求。本地索引与代码库索引的核心能力差异如下：你可以通过本地索引构建图谱索引，解析本地项目代码文件，精准检索函数、类、文件之间的调用、依赖与继承关系。输入你需要查找的函数名、变量名、文件路径等精确内容。系统将调用GraphExplore工具，基于代码知识图谱进行 - [MCP](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0010.md): 华为云码道代码智能体可依托模型上下文协议（MCP）与MCP服务器通信，借助服务器提供的额外工具和资源实现功能扩展。模型上下文协议（Model Context Protocol，简称MCP）是一种开放协议，定义应用程序与大语言模型（LLM）之间的上下文提供规范，为LLM连接外部数据源、工具系统提供统一的交互标准。MCP服务器的核心功能是允许 - [技能](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0024.md): 技能（Skill）是一种能力封装机制，用于将专业知识（如编码经验、常见问题、解决方案等）组织为可复用的模块。技能本质上是由指令、脚本和资源构成的集合，智能体可按需动态加载这些专业化的“技能包”，从而提升特定任务的执行能力与执行效率。技能是一个包含必需的SKILL.md文件和其他可选的捆绑资源的结构化目录，打包完成特定任务所需的知识和工具。 - [页面预览](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0021.md): 华为云码道代码智能体IDE集成了浏览器功能，您可直接在华为云码道代码智能体IDE中查看Web应用的运行效果，并执行以下操作：外部网址即时预览：在浏览器地址栏中输入外部网址，即可预览对应网站。选中内容一键导入对话：支持选择一个或多个元素，可将浏览器中选中的内容添加到对话窗口中。元素直连智能体交互：选中元素即可一键发送至会话，直接与智能体对话 - [SSH开发](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0030.md): 华为云码道代码智能体IDE的远程资源管理功能（Remote SSH）支持用户通过本地PC直接访问和操作远程主机上的文件，无需下载至本地，即可实现高效的远程开发与维护。借助该功能，您可以在IDE中直接使用完整的开发工具链，包括代码补全、调试、AI辅助等，大幅提升远程工作的便捷性与效率。您也可以直接单击“将当前窗口连接到主机”或“将新窗口连接 - [WSL发行版](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0029.md): 华为云码道代码智能体IDE支持远程连接WSL（Windows Subsystem for Linux）。该功能将本地WSL环境作为远程开发后端，使用户能够在Windows系统上，以连接远程服务器的方式，在本地WSL环境中进行全链路的代码编写、调试与运行。等待连接完成，如果没有出现任何报错提示，且左下角状态栏已显示连接信息，表示连接成功。 - [本地Docker容器](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0031.md): 华为云码道代码智能体IDE支持本地Docker容器连接。该功能将本地运行的Docker容器作为开发环境后端，使用户能够在统一的IDE界面中，以“远程连接”的方式高效编写、调试并在容器中运行代码。通过该功能，用户无需频繁切换终端或手动进入容器内部操作，即可实现对容器内代码的全流程管理与开发。执行连接操作前，请确保Docker容器已启用。如果 - [历史会话](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0033.md): 历史会话是华为云码道代码智能体对过往交互内容的记忆，记录了用户和AI之间的对话过程，包括之前的提问、回答和上下文信息。如果没有正常显示华为云码道代码智能体的聊天窗口，请在顶部菜单栏的右上方，单击展开AI侧栏图标 ，即可打开华为云码道代码智能体。修改项目名称会导致该项目的历史会话无法在华为云码道代码智能体IDE中查看。如果需要恢复历史会话记 - [Hooks](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0036.md): 通过Hook（钩子），您可以在华为云码道代码智能体IDE及插件的关键生命周期节点中插入自定义逻辑，实现功能扩展，而无需更改任何现有代码。与依赖模型理解的Prompt指令不同，Hooks的执行是确定性的，即一旦事件被触发，绑定的脚本将稳定、可靠地执行，不受模型理解偏差的影响。插件是一个JavaScript/TypeScript模块，通过导出 - [斜杠命令](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0038.md): 斜杠命令（Slash Command）作为一种高效的交互方式，允许用户在对话中快速执行常用任务。华为云码道代码智能体已为您预置了一些常用的命令，您也可以根据实际需求自定义命令。通过自定义命令，您可以将频繁使用的操作或复杂的指令封装为简单的指令，从而简化工作流程，提升与AI协作的效率。在华为云码道代码智能体中，使用自定义斜杠命令具备如下优势 - [代码审查](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0047.md): 华为云码道代码智能体IDE提供了自动化代码审查能力，通过/review-rules-generator与/review两大核心指令的高效协同，为您提供精准、专业的代码质量把控能力。以下为您详细介绍/review和/review-rules-generator这两个核心命令的具体用法。命令功能：启动代码审查流程，对当前修改或指定commit - [代码修复](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0054.md): 华为云码道代码智能体IDE提供了强大的自动修复问题能力，覆盖人工提交、AI审查及工具告警等多源场景。支持单条与批量处理，实现从问题发现到修复的高效闭环，显著提升代码质量与开发效率。以下为您详细介绍四大核心命令的具体用法。命令功能：根据用户提交的问题单描述，自动调用修复专家智能体进行代码问题修复。语法格式：使用示例：命令功能：针对单条代码检 - [IDE工具面板](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0012.md): 华为云码道代码智能体IDE集成了华为云码道代码智能体插件，帮助您高效开发并灵活扩展功能，让编程更智能、更得心应手。 - [IDE全局设置](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0027.md): 单击华为云码道代码智能体IDE工具右上角的设置图标 ，进入华为云码道代码智能体IDE全局设置页面。在全局设置页面中，您可以按照自己的编码和使用习惯进行个性化配置。查看当前登录账号的信息。如果您是未登录状态，单击“登录”，会自动跳转到对应的登录页面。如果您是已登录状态，此处会显示您当前已登录的账号名称和账号ID。单击“退出登录”，您可以退出 - [进程资源管理器](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0014.md): 进程资源管理器用于实时监控华为云码道代码智能体IDE的资源使用情况，灵活管理进程资源，有效保障华为云码道代码智能体IDE的稳定运行与高效性能。在华为云码道代码智能体IDE工具的左下方，单击打开资源管理器图标 （正常状态），即可打开进程资源管理器。若打开资源管理器图标显示其他状态，含义如下：：网络延迟过高：网络连接中断：内存/CPU等占用率 - [网络代理](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0018.md): 如果您的网络为公司网络，可能会遇到“模型未加载成功，无法使用”的提示。遇到该问题，您可参考本章节配置网络代理，重启后再使用华为云码道代码智能体IDE。当第5步连接成功后，再继续进行后面步骤的操作。如果您的Proxy User Password中包含@、%等特殊字符，请务必先进行转义再填写，否则会导致代理配置无效。 - [隐私模式](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0048.md): 对于使用华为云码道代码智能体原个人版或体验版且未完成企业认证的用户，您的对话内容、代码片段及AI生成结果等数据，可能会被用于数据分析、产品改进及模型训练。如果您不希望数据被用于上述用途，可参照本章节操作开启隐私模式。仅适用于购买原个人版或体验版且未通过企业认证的用户。企业认证、基础版和专业版用户不涉及数据收集，故本产品不提供相应功能开关。 - [Space模式概述](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0006.md): Space模式（码道Agent Space）是华为云码道代码智能体推出的全新交互体验，以智能体为交互核心，实现多个智能体相互配合协同开发。Windows操作系统：推荐使用Windows 11 (x64)；如果使用Windows 10 (x64)，系统版本需为2019年及以上，建议升级至最新稳定版本。macOS操作系统：macOS 11及以 - [沙箱](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0011.md): 沙箱（Sandbox）为智能体生成的指令提供隔离且受限的执行空间。通过严格的权限管控，确保命令在安全隔离的环境内运行，有效阻断对未经授权资源（文件、网络等）的访问或者高风险命令（权限修改等）的执行。对于被拦截的命令，智能体会在对话流中发出风险提示，经由用户二次确认后，命令才会在沙箱外被执行。使用沙箱具备如下优势：构建数据泄露防线：基于沙箱 - [研发办公](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0015.md): 研发办公功能聚焦于研发人员的日常非编码场景。借助码道Agent Space的智能对话模式，您可以轻松完成文档编写、需求梳理、业务分析、工作汇报及团队协同等任务，显著提升办公效率。智能技术文档生成：基于代码上下文与对话指令，自动梳理逻辑、生成结构清晰的技术文档，告别繁琐的手动排版。研发数据深度洞察：自动采集并分析研发过程数据，生成可视化报表 - [多会话并行](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0017.md): 传统模式下，单个项目中会话采用串行执行方式，同一时间仅可执行单个会话，执行效率较低。多会话并行功能可突破上述限制，同一时间支持多会话并行执行，有效提升整体开发效率。多会话并行主要用于以下场景：并行执行多个开发任务：可在同一项目下创建多个独立会话，分别用于不同功能模块的开发（如前端与后端），实现多会话并行推进。同步进行问答开发：可以在不同会 - [多任务并行](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0022.md): Agent Team（多智能体团队）是码道Agent Space的多智能体协作引擎。采用“Leader智能编排 + Teammate自主执行”的架构，将复杂开发任务拆解为可并行推进的子任务，由多个专业Agent像真实开发团队一样分工协作，自主完成从需求分析到代码交付的整条工作流。整个过程由事件驱动、全程可视，无需人工干预。多角色协同：多个 - [定时任务](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0035.md): 通过创建定时任务，让系统按照设定时间或频率自动执行预设操作并输出执行结果，全程无需人工干预，助您轻松解放双手。定时任务默认处于启用状态，即状态为“生效中”。 - [隐私模式](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0068.md): 对于使用华为云码道代码智能体原个人版或体验版且未完成企业认证的用户，您的对话内容、代码片段及AI生成结果等数据，可能会被用于数据分析、产品改进及模型训练。如果您不希望数据被用于上述用途，可参照本章节操作开启隐私模式。仅适用于购买原个人版或体验版且未通过企业认证的用户。企业认证、基础版和专业版用户不涉及数据收集，故本产品不提供相应功能开关。 - [代码审查](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0044.md): 码道Agent Space提供了自动化代码审查功能，协助您实现对代码质量的精准把控与专业化管理。参考开启Space模式操作，进入码道Agent Space。单击代码开发，切换到代码开发页签。在聊天界面的输入框下方选择AgentTeam，切换到AgentTeam模式。右侧显示当前选用的模型，您可在下拉框中切换不同大语言模型。以下为两个典型使 - [工具面板](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0043.md): 码道Agent Space内置了多种核心工具，如编辑器、文档、终端和浏览器等。您可以根据需求灵活调用这些工具，来扩展更多能力。单击码道Agent Space界面右上角的切换工具可见性图标 ，即可打开工具面板。在码道Agent Space的任务分析与执行阶段，各工具分工明确，协同支撑全流程运作。用于查看或编辑码道Agent Space生成的 - [码道Agent Space设置](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0067.md): 单击码道Agent Space界面右上角的设置图标 ，进入码道Agent Space设置页面。在设置页面中，您可以按照自己的编码和使用习惯进行个性化配置。查看当前登录账号的信息。如果您是未登录状态，单击“登录”，会自动跳转到对应的登录页面。如果您是已登录状态，此处会显示您当前已登录的账号名称和账号ID。单击“退出登录”，您可以退出当前账号 - [钉钉机器人集成](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0060.md): 码道Agent Space具备多端IM接入能力，支持将码道Agent Space的Agent能力复用于多个IM平台，并提供统一的配置管理。本章节将详细介绍如何将码道Agent Space接入钉钉，助您快速实现功能集成与流程协同。登录钉钉开发者后台，参考创建应用中操作，创建一个钉钉企业内部应用。参考添加应用能力中操作，为已创建的应用添加机器 - [飞书集成](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0056.md): 码道Agent Space具备多端IM接入能力，支持将码道Agent Space的Agent能力复用于多个IM平台，并提供统一的配置管理。本章节将详细介绍如何将码道Agent Space接入飞书，助您快速实现功能集成与流程协同。登录飞书开放平台，单击右上角的开发者后台，在企业自建应用页签中，单击创建企业自建应用，创建一个企业自建应用。进入 - [企业微信机器人集成](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0058.md): 码道Agent Space具备多端IM接入能力，支持将码道Agent Space的Agent能力复用于多个IM平台，并提供统一的配置管理。本章节将详细介绍如何将码道Agent Space接入企业微信，助您快速实现功能集成与流程协同。创建API模式机器人并获取Bot ID和Secret：登录企业微信管理后台，参考通过长连接配置智能机器人中操 - [获取日志](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0032.md): 为保障系统的正常运行，提升异常排查效率，及时完成问题定位与分析，您可以按照本章节进行操作，获取和查阅华为云码道代码智能体的日志信息。日志的严重性从低到高依次为：Debug（调试） < Info（信息） < Warn（警告） < Error（错误）。Debug（调试）：用于记录程序运行过程中的详细内部信息，如请求详情、流程步骤等，主要用于开 - [问题反馈](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0020.md): 华为云码道代码智能体支持快速反馈用户在使用过程中遇到的问题和建议，助力产品持续优化，还能有效连接开发者，促进交流与合作。如果您使用的是华为云码道代码智能体IDE，直接在IDE内提交问题即可，高效又顺手。您也可以单击华为云码道代码智能体IDE工具右上角的设置图标 ，进入全局设置页面。在关于CodeArts Agent中，单击反馈建议，打开反 ## 用户指南（控制台） - [什么是华为云码道代码智能体控制台](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0000.md): 华为云码道代码智能体控制台提供套餐订阅管理、成员权限管控、用量数据分析及模型配置管理等能力，助力企业实现团队精细化运营、模型策略统一管控。华为云码道代码智能体控制台支持的功能如表1所示。华为云码道代码智能体三个版本所支持的控制台功能存在差异，具体如表2所示。企业管理员、团队管理员和成员对于华为云码道代码智能体控制台的操作权限所有不同，以华 - [权限概述](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0023.md): 购买华为云码道代码智能体套餐的账号默认拥有企业管理员权限，其他账号需要企业管理员将其添加为企业成员后，方可访问华为云码道代码智能体控制台。华为云码道代码智能体支持华为账号、IAM用户及企业联邦用户三种登录方式，若使用后两种登录，需具备企业管理员角色和对应的IAM细粒度权限方可执行计费相关操作，具体请参见IAM细粒度权限说明。华为账号：当您 - [订阅管理](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0001.md): 华为账号及具备表1中细粒度权限的IAM用户或企业联邦用户，均可购买华为云码道代码智能体套餐。购买套餐前，可查看各版本套餐的差异，具体请参考华为云码道套餐的特性差异。购买套餐后，您可在“订阅管理”页面执行变更套餐、续费及退订套餐等操作。操作该页面需具备以下任意一种权限：华为账号：已被添加为企业管理员。IAM用户或企业联邦用户：已被添加为企业 - [配置账号30天免登录](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0013.md): 华为云码道代码智能体客户端支持账号30天免登录功能。账号登录客户端后，若30天内再次打开客户端且网络正常，客户端将自动保持登录状态。IAM用户免登录有效时长为24小时。华为云码道代码智能体客户端默认登录有效期随版本不同而有所区别，具体如表1所示。IAM用户如需获得30天免登录权限，应由华为账号为其配置身份策略，未配置时登录页面将显示相应提 - [成员介绍](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0003.md): 为满足企业对不同员工实施精细化权限管理的需求，华为云码道代码智能体提供以下成员角色类型。 - [添加与管理企业成员及团队成员](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0004.md): 购买华为云码道代码智能体套餐的账号默认拥有企业管理员权限，其他账号需要企业管理员将其添加为企业成员后，方可访问华为云码道代码智能体控制台。本章节介绍企业管理员如何通过手动添加或批量导入的方式，将IAM用户和企业联邦用户添加为本企业成员，同时可直接将其加入指定团队。若添加企业成员时未分配团队，企业管理员和团队管理员后续可单独将用户加入指定团 - [配置席位](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0006.md): 席位管理功能用于企业管理员给指定成员开通华为云码道代码智能体的AI使用权限。已添加IAM用户和企业联邦用户至企业成员列表中，具体操作请参考添加与管理企业成员及团队成员。在页面顶部可查看当前套餐的总席位数和席位使用率。若当前套餐已无可用席位，建议变更套餐开通更多席位。在“席位管理”页面，查看目标成员的“席位状态”变为“已启用”，说明启用席位 - [数据分析](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0007.md): 华为云码道代码智能体提供面向团队的企业数据分析能力，全面洞察团队使用情况，展示团队活跃、资源消耗等统计信息。企业管理员可在“数据分析”页面查看团队的详细数据。如您需查看个人使用情况，详细请参考个人用量。数据分析页面每小时自动更新一次数据。该页面数据每小时自动更新一次。例如：新创建的团队无法立即在团队名称列表中查看，将在下次自动更新数据后正 - [配置系统内置模型](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0026.md): 系统内置模型为华为云码道代码智能体预先集成的模型。企业管理员通过开启或关闭模型，来管控企业员工使用的模型范围。已购买华为云码道代码智能体专业版套餐。所有系统内置模型默认为开启状态。关闭模型后，在华为云码道代码智能体客户端将不展示此模型。 - [配置企业自定义模型](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0009.md): 华为云码道代码智能体支持企业接入第三方大语言模型，可根据业务场景灵活定制，并满足企业私有化部署、数据安全与合规管控要求，实现模型能力与业务深度适配。华为云码道代码智能体专业版套餐支持通过控制台和客户端配置自定义模型，基础版套餐和体验版套餐仅支持在客户端配置自定义模型。控制台：仅企业管理员可配置自定义模型，并可管控企业成员在客户端配置自定义 - [设置Token用量](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0010.md): 企业管理员可在“用量设置”页面为各模型设置月度Token限额（含输入和输出Token），以管控企业Token消耗，优化模型使用成本。针对系统内置模型，可在按需计费模式下对其月度Token使用量进行管控。月度Token用量的计算周期为开通华为云码道代码智能体套餐当天到次月同一天，例如套餐开通日期为2026-05-22，月度Token用量周期 - [添加安全隔离代码仓](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0017.md): 企业管理员可将核心代码、涉密数据及需严格权限管控的代码仓添加至安全隔离代码仓，限制华为云码道代码智能体的AI功能（如AI对话、代码续写、单元测试等功能）对其进行访问或使用，保障企业数据安全。已购买华为云码道代码智能体专业版套餐。已获取代码仓地址。在“安全隔离代码仓”页签，查看新添加的代码仓。在华为云码道代码智能体客户端使用AI功能访问安全 - [添加IP白名单](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0018.md): 企业管理员可在华为云码道代码智能体控制台添加公网IP白名单，对访问来源进行精准管控，有效防范非法访问，保障企业数据安全。华为云码道代码智能体控制台最多可添加200个IP白名单，一次最多可添加20个IP白名单。未开启访问控制时，所有公网IP地址均可访问华为云码道代码智能体。开启访问控制后，仅白名单中的IP地址具备访问权限。企业管理员和团队管 - [配置SSO登录](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0019.md): 单点登录（Single Sign-On，简称SSO）是指用户在身份提供商系统登录后，可通过跳转链接访问已建立互信关系的服务提供商系统。例如：企业管理系统与华为云建立互信关系后，企业管理系统中的用户通过华为云提供的登录入口，使用已有的账号密码在企业管理系统中登录后，即可跳转访问华为云码道代码智能体，该类用户即为企业联邦用户。华为云码道代码智 - [查看操作日志](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0011.md): 在使用华为云码道代码智能体过程中，系统会自动记录用户在团队及成员管理、席位管理、订阅管理等模块的全量操作日志。当系统出现报错、功能异常或使用问题时，企业管理员可通过操作日志快速回溯操作过程，精准完成问题定位、原因分析与故障恢复，提升问题处理效率。已购买华为云码道代码智能体专业版套餐。 - [智能体设置](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0015.md): 华为云码道代码智能体提供统一的智能体设置平台，用于在云端管理智能体相关资源，包含智能体、技能、规则、知识空间和代码库索引。您可以在控制台统一管理这些云端资源，创建后的资源可在华为云码道代码智能体客户端中使用。仅华为云码道代码智能体基础版和专业版套餐支持创建云端智能体、技能和规则。智能体中心用于统一管理云端自定义智能体。您可在控制台对云端智 - [个人用量](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0012.md): 华为云码道代码智能体提供面向用户的用量分析能力，清晰展示个人活跃、资源消耗等统计信息，帮助用户全面了解个人使用情况。如您需查看团队使用情况，详细请参考数据分析。个人用量页面每小时自动更新一次数据。 - [客户端会话管理](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0020.md): 在华为云码道代码智能体控制台，您可查看当前账号的登录详情，包括登录该账号的客户端、IP地址、最后活跃时间等。若发现陌生客户端或可疑登录行为，可删除对应的客户端会话，并修改账号密码。客户端会话被删除后，该客户端需重新登录，方可继续使用华为云码道代码智能体。当会话数量较多时，可在搜索框中通过客户端名称或IP地址快速检索目标会话。会话信息参数说 - [开启隐私模式](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0022.md): 非企业认证的用户使用华为云码道代码智能体体验版时，华为云码道代码智能体将采集用户的相关信息（如您的聊天互动，包括相关代码片段和AI生成的输出）用于数据分析、产品改进和模型训练。开启隐私模式后，华为云码道代码智能体将不再采集上述信息。您可在华为云码道代码智能体控制台开启隐私模式，也可在客户端开启，本章节介绍在控制台开启的步骤。仅非企业认证的 - [心愿墙管理](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0024.md): 心愿墙用于展示用户对产品的功能需求与改进建议。您可在此发布心愿、为他人心愿助力，让真实用户需求被产品团队看见，共同推动产品持续优化迭代。华为云码道代码智能体运维人员将对用户心愿进行审核并回复，优质心愿有机会纳入产品规划，助力值较高的心愿可在需求排期中获得更高优先级。仅“已驳回”状态的心愿支持修改。心愿从发布到下架包含多个状态，具体如表1所 - [问题反馈](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0014.md): 华为云码道代码智能体控制台支持快速反馈用户在使用过程中遇到的问题和建议，助力产品持续优化，同时有效连接开发者，促进交流与合作。 ## 用户指南（码道CLI） - [什么是码道CLI](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0001.md): 华为云码道CodeArts代码智能体CLI（CodeArts Agent CLI，简称码道CLI）是面向开发者的智能编码助手，具备代码编写、代码分析、代码优化等全链路智能化能力。码道CLI提供了终端交互界面（TUI）与命令行模式（CLI）双形态，无缝融入研发工作流并适配多样场景。在无桌面环境中，TUI以可视化交互简化代码编写与调试，CLI - [前提条件](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0004.md): 为确保最佳兼容性与性能表现，推荐使用以下系统配置：Windows操作系统：推荐使用Windows 11 (x64)；如果使用Windows 10 (x64)，系统版本需为2019年及以上，建议升级至最新稳定版本。macOS操作系统：macOS 11及以上版本，兼容ARM64（Apple Silicon）架构。Linux：Huawei Cl - [安装](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0005.md): 本章节介绍如何在Windows、macOS和Linux操作系统中首次安装码道CLI。Windows系统仅支持通过PowerShell执行安装命令。安装完成后，正常回显码道CLI的版本号，表明安装成功。介绍在macOS和Linux系统中安装码道CLI的方法。为了便于演示，下面将以Linux操作系统为例进行说明。安装完成后，正常回显码道CLI - [授权](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0026.md): 码道CLI基于华为云AK/SK实现身份鉴权，提供两种授权模式以灵活适配不同场景：进程级临时授权：仅在当前终端会话内生效，窗口关闭后自动失效。无需持久化存储密钥，特别适合临时调试或在公共机器上进行测试，安全便捷。系统环境变量永久授权：将鉴权信息写入系统Shell或Windows环境变量。新开终端或重启设备后依然有效，适合个人本地长期开发使用 - [升级](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0025.md): 当前码道CLI支持两种升级方式：自动升级和手动升级。当您启动码道CLI，当前版本不是最新版本，码道CLI会提示您是否自动升级。本文截图均以CMD界面为示例。提示Installation Successful，表示成功升级码道CLI。如下图所示，您执行codearts upgrade命令，回显中出现Done，表示您成功完成手动升级。 - [权限](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0006.md): 码道CLI可通过配置“permission”文件，管控码道CLI的执行权限，支持自动运行、提示用户审批以及禁止运行。权限文件的配置路径：~/.codeartsdoer/cli-data/storage/permission/global.json权限配置格式如下所示。其中，“权限名称”请参考表1，“权限策略”请参考表2。在TUI开发模式下 - [自定义命令](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0010.md): 除了内置的斜杠命令、文件引用与Bash命令，还支持通过在.jsonc文件自定义命令或者自定义.md文件来添加自定义命令。码道CLI支持通过在“codearts_cli.json”或者“codearts_cli.jsonc”（带注释的JSON文件）配置自定义命令。支持配置个人级和项目级路径，详细路径信息可查看表1。使用前需您自行手动创建文件 - [沙箱](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0007.md): 沙箱（Sandbox）为智能体生成的指令提供隔离且受限的执行空间。通过严格的权限管控，确保命令在安全隔离的环境内运行，有效阻断对未经授权资源（文件、网络等）的访问或者高风险命令（权限修改等）。对于被拦截的命令，智能体会在对话流中发出风险提示，经由用户二次确认后，命令才会在沙箱外被执行。启用沙箱后，码道CLI对文件目录的访问权限配置如下。您 - [智能体](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0031.md): 智能体（Agent）是面向多样化开发场景的编程助手。码道CLI内置了多款开箱即用的智能体，这些智能体无需手动创建，即拿即用，旨在为多种开发场景提供高效的编程辅助。除了内置智能体，还支持自定义智能体功能。内置智能体分为主智能体和子智能体两大类。主智能体是您的主要对话助手，支持通过Tab键快速切换；子智能体则是主智能体可调用或您通过@符号手动 - [技能](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0019.md): 技能按作用范围可分为项目级和个人级。若存在名称相同的技能，技能调用优先级为：项目级 > 个人级。技能是一个包含必需的SKILL.md文件和其他可选的捆绑资源的结构化目录，打包完成特定任务所需的知识和工具。skill-name/ ├── SKILL.md (必填) │ ├── YAML frontmatter 元数据 (必填) │ - [Hooks](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0018.md): Hooks（钩子）是码道CLI插件系统的核心机制，允许开发者在工具执行、消息处理、权限控制等关键节点注入自定义逻辑。插件通过返回一个Hooks对象来声明自己关注的生命周期事件，当对应事件触发时，插件的自定义函数将被调用。插件是一个JavaScript/TypeScript模块，通过导出插件函数来工作。每个函数接收一个上下文对象，并返回对应 - [代码库索引](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0002.md): 在码道CLI中，你可以为项目构建索引，来提升AI在代码库中的检索速度与准确度，使结果更贴合你的需求。你可以通过本地索引构建知识图谱索引，解析本地项目代码文件，精准检索函数、类、文件之间的调用、依赖与继承关系。下面以TUI开发环境为例。本地索引仅支持在Windows、Linux系统下创建。本地索引文件将自动存储在当前项目根目录的.codeg - [LSP](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_00019.md): 语言服务器协议（Language Server Protocol，简称LSP）是一种用于提供语言服务的标准化协议。LSP将语言服务与码道CLI进行了解耦，由独立的语言服务器进程来提供代码分析、快速导航及符号查询等核心能力。码道CLI已预置了本地LSP功能。开启该功能后，智能体可基于语言服务提供代码分析结果、代码跳转及符号信息，实现更精准的 - [定时任务](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_00021.md): 在码道CLI中，您可以通过命令或自然语言创建和管理定时任务，包括周期性任务（如每日代码检查）和一次性任务（如明日提交提醒），实现灵活的任务调度与高效管理。在码道CLI中运行定时任务依赖以下文件，其中的数据均由系统自动生成。在TUI开发环境中，您可以使用命令或自然语言两种方式来创建定时任务。需要注意的是，通过命令创建的定时任务会立即执行，而 - [自定义模型](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_00022.md): 码道CLI新增对接第三方大语言模型的能力。若您已购买华为云码道代码智能体专业版套餐，同时支持在控制台添加第三方大语言模型，具体请参见配置企业自定义模型。已将账号添加至企业成员中，并启用席位。若您已购买华为云码道代码智能体专业版套餐，请确保企业管理员已在控制台开启成员自定义模型权限，具体操作请参考配置企业自定义模型。在码道CLI中，通过配置 - [MCP](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0035.md): 码道CLI可依托模型上下文协议（MCP）与MCP服务器通信，借助服务器提供的额外工具和资源实现功能扩展。MCP Server由第三方开发者或组织构建、发布和维护。华为云码道代码智能体（CodeArts Agent）不对第三方MCP Server的代码实现、安全性、稳定性、数据处理行为及服务质量进行审查、验证或背书。在使用第三方MCP Se - [斜杠命令](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0014.md): 您可在CMD、PowerShell或者终端，输入“codearts”并回车，进入TUI开发模式。在TUI开发模式下，您可以输入“/”后跟命令名称来快速执行操作，当前支持如下命令。 - [快捷键](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0016.md): 上一章节列举了一些斜杠命令的对应的快捷键。除此之外，TUI开发环境中还支持提示词输入快捷键，这些快捷键是内置功能，支持对对话框的输入信息进行便捷操作。 - [SDD](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0009.md): SDD（Specification-Driven Development）是一种规格驱动开发模式，严格通过“需求规格、技术设计、任务规划、编码实现”四个阶段推进工作。这种结构化流程旨在保障每一步开发均有据可依，实现过程可控与历史可查。产物文件夹名由模型自主生成。受生成随机性影响，即使输入相同的需求描述，输出的产物文件夹名也可能存在差异。打 - [命令](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0034.md): 打开CMD、Powershell或者终端，执行命令“codearts [command]”，即可进入码道代码智能体的CLI开发模式。 - [MCP命令](https://support.huaweicloud.com/usermanual-cli/codeartsagent_cli_0028.md): codearts mcp命令用于管理MCP服务器，支持添加、列出、认证和调试MCP服务器。执行该命令可新增一个MCP服务器。本示例以Windows系统的项目级配置为例：Location参数的填写指导请参考表1。Location参数说明参数解释Current project将MCP配置到当前项目下：项目根目录/.codeartsdoer/c ## 用户指南（插件） - [什么是华为云码道代码智能体插件](https://support.huaweicloud.com/usermanual-plugin/codeartsagent_plugin_0000.md): 华为云码道代码智能体插件（CodeArts Agent）支持安装在Visual Studio Code和JetBrains系列IDE中，提供代码生成、代码续写、研发知识问答、单元测试用例生成等核心功能，可高效提升开发者研发效率，带来优质的智能化编码体验。新项目快速开发依托智能编码能力，快速生成项目框架、业务代码与原型，缩短项目启动和交付周 - [Visual Studio Code](https://support.huaweicloud.com/usermanual-plugin/codeartsagent_plugin_0002.md): 仅支持Windows操作系统，推荐你使用Windows 11 (x64)。如果使用Windows 10 (x64)，系统版本需为2019版及以上，建议升级至最新稳定版本。已下载并安装Visual Studio Code。在使用华为云码道代码智能体进行编码前，需要参考如下内容，提前申请华为账号。进入华为云官网，单击页面右上角的“注册”。参考 - [JetBrains](https://support.huaweicloud.com/usermanual-plugin/codeartsagent_plugin_0003.md): 华为云码道代码智能体深度集成了JetBrains系列主流IDE，当前已全面支持PyCharm、IntelliJ IDEA、WebStorm和CLion四大核心工具，为开发者提供无缝的云端编程体验。本节以IntelliJ IDEA为例，介绍华为云码道代码智能体在JetBrains平台的安装流程。仅支持Windows操作系统，推荐你使用Win - [单元测试（智能体）](https://support.huaweicloud.com/usermanual-plugin/codeartsagent_plugin_0005.md): 单元测试（智能体）是一款端到端的测试用例生成智能体，具备测试设计、用例生成和用例智能修复全流程核心能力。该功能可准确生成符合代码逻辑的测试用例，同时可自动识别生成用例的编译错误，对存在编译问题的用例进行智能修复，有效提升测试用例的开发效率与质量。智能体（Agent）是面向多样化开发场景的编程助手。华为云码道代码智能体内置了多款开箱即用的智 - [获取日志](https://support.huaweicloud.com/usermanual-plugin/codeartsagent_plugin_0009.md): 为保障系统的正常运行，提升异常排查效率，及时完成问题定位与分析，您可以按照本章节进行操作，获取和查阅华为云码道代码智能体的日志信息。日志的严重性从低到高依次为：Debug（调试） < Info（信息） < Warn（警告） < Error（错误）。Debug（调试）：用于记录程序运行过程中的详细内部信息，如请求详情、流程步骤等，主要用于开 - [基础设置](https://support.huaweicloud.com/usermanual-plugin/codeartsdoer_ug_0015.md): 单击华为云码道代码智能体聊天界面右上角的设置图标 ，进入华为云码道代码智能体设置页面。不同的工具配置项有所不同，本文以Visual Studio Code为例进行说明。智能体（Agent）是面向多样化开发场景的编程助手。华为云码道代码智能体不仅内置了多种智能体，还支持自定义智能体功能。在自定义智能体中，通过灵活配置提示词（Prompt）、 - [语言设置](https://support.huaweicloud.com/usermanual-plugin/codeartsagent_plugin_0007.md): 华为云码道代码智能体首次安装后，插件的语言默认是英文。如果您想要配置华为云码道代码智能体的显示语言，可以参考本章节配置。您可以通过如下两种方式，修改华为云码道代码智能体默认的语言。方式一：在IntelliJ IDEA工具设置页面修改在IntelliJ IDEA工具中，单击左上角的主菜单图标 ，选择文件 > 设置(T)...，进入Intel - [网络代理](https://support.huaweicloud.com/usermanual-plugin/codeartsagent_plugin_0012.md): 如果您的网络为公司网络，可能出现报错“模型未加载成功，无法使用”。遇到该问题，您可参考本章节配置网络代理，重启后再使用华为云码道代码智能体插件。如果您的密码中包含@、%等特殊字符，请务必先进行转义再填写，否则会导致代理配置无效。当弹出框提示代理连接成功时，表示当前代理配置已生效。 - [问题反馈](https://support.huaweicloud.com/usermanual-plugin/codeartsagent_plugin_0006.md): 华为云码道代码智能体支持快速反馈用户在使用过程中遇到的问题和建议，助力产品持续优化，还能有效连接开发者，促进交流与合作。如果您使用的是Visual Studio Code或JetBrains系列开发工具（PyCharm、IntelliJ IDEA、WebStorm及CLion），可直接在华为云码道代码智能体内提交问题，体验更流畅的开发支持 ## 用户指南（码道Space） - [什么是码道Space](https://support.huaweicloud.com/usermanual-codeartsspace/space_0001.md): 码道Space是一款面向各类办公及研发用户的独立桌面AI工作台，让不同群体用户都能够把业务需求、现有资料和工作经验转化为可以使用的软件、工具、自动化和数字成果。为确保最佳兼容性与性能表现，推荐使用以下系统配置：Windows：推荐使用Windows 11 (x64)；如果使用Windows 10 (x64)，系统版本需为2019年及以上， - [快速启动](https://support.huaweicloud.com/usermanual-codeartsspace/space_0002.md): 介绍码道Space桌面客户端，演示从首次新建任务到完成简单开发任务的操作流程，帮助您快速上手智能编码体验。在使用码道Space进行编码前，需要参考如下内容，提前申请华为账号并购买套餐。进入华为云官网，单击页面右上角的“注册”。参考注册华为账号并开通华为云中操作，完成注册。（可选）注册成功后，进行实名认证。如果您需要购买基础版或专业版套餐， - [自然语言发起任务](https://support.huaweicloud.com/usermanual-codeartsspace/space_0004.md): 接下来开始你的第一次AI办公，码道Space是一名驻扎在你电脑里的AI数字同事。通过创建任务到自然语言发起任务，码道Space规格与执行，最终交付结果。单击输入框下方的“选择工作空间”，您可以选择“新建工作空间”或“打开本地文件夹”。为了确保代码执行的安全性与灵活性，码道Space为您提供了沙箱运行、自动执行和手动审批三种运行策略。您可以 - [调度领域专家完成任务](https://support.huaweicloud.com/usermanual-codeartsspace/space_0005.md): 码道Space面向多样化开发场景内置AI专家角色和专家团，集结各领域资深专家，覆盖问题诊断、方案设计与落地推演，为复杂业务问题提供体系化的专业解答。专家与专家团适用场景区别：任务边界清晰、仅涉及单一领域，建议选用专家；任务跨多领域且业务环节关联，建议选用专家团。下面按职能领域分组，针对不同的专家类型，根据典型适用场景与选型建议。以下内容仅 - [通过项目调度多任务](https://support.huaweicloud.com/usermanual-codeartsspace/space_0006.md): 通过设定项目蓝图，驱动多任务有序推进。用户可针对不同业务场景独立创建项目，以项目为核心维度统一管理各类开发任务、资源文件、Agent会话与任务结果。通过项目实现业务逻辑隔离，任务之间权责清晰、进度可追溯，便于复杂业务下批量任务的统筹规划，实现开发工作的体系化管理。支持手动创建、在对话框中创建项目。码道Space内置了常用的项目模板，每一个 - [沙箱](https://support.huaweicloud.com/usermanual-codeartsspace/space_0007.md): 沙箱（Sandbox）为智能体生成的指令提供隔离且受限的执行空间。通过严格的权限管控，确保命令在安全隔离的环境内运行，有效阻断对未经授权资源（文件、网络等）的访问或者高风险命令（权限修改等）的执行。对于被拦截的命令，智能体会在对话流中发出风险提示，经由用户二次确认后，命令才会在沙箱外被执行。使用沙箱具备如下优势：构建数据泄露防线：基于沙箱 - [模型](https://support.huaweicloud.com/usermanual-codeartsspace/space_0008.md): 支持在码道Space客户端添加第三方大语言模型。已将账号添加至企业成员中，并启用席位。若您已购买华为云码道代码智能体专业版套餐，请确保企业管理员已在控制台开启成员自定义模型权限，具体操作请参考配置企业自定义模型。码道Space支持两种添加自定义模型方式：一是通过模型提供商快速添加，二是通过自定义配置进行添加。通过模型提供商添加模型：码道S - [技能](https://support.huaweicloud.com/usermanual-codeartsspace/space_0010.md): 技能（Skill）是一种能力封装机制，用于将专业知识（如编码经验、常见问题、解决方案等）组织为可复用的模块。技能本质上是由指令、脚本和资源构成的集合，智能体可按需动态加载这些专业化的“技能包”，从而提升特定任务的执行能力与执行效率。码道Space为不同使用场景提供了多种技能，涵盖办公文档、代码开发、开发工具等领域。你可以直接安装所需技能。 - [连接器](https://support.huaweicloud.com/usermanual-codeartsspace/space_0011.md): 码道Space提供的连接器可依托模型上下文协议（MCP）与MCP服务器通信，借助服务器提供的额外工具和资源实现功能扩展。模型上下文协议（Model Context Protocol，简称MCP）是一种开放协议，定义应用程序与大语言模型（LLM）之间的上下文提供规范，为LLM连接外部数据源、工具系统提供统一的交互标准。MCP服务器的核心功能 - [自动化任务](https://support.huaweicloud.com/usermanual-codeartsspace/space_0012.md): 通过自动化任务，让系统按照设定时间或频率自动执行预设操作并输出执行结果，全程无需人工干预，助您轻松解放双手。支持手动创建、在对话框中创建、从模板创建自动化任务。码道Space内置了常用的任务模板，每一个模板都预设了完整的任务配置。 - [用量统计](https://support.huaweicloud.com/usermanual-codeartsspace/space_0013.md): 支持查看用户的套餐额度，也可以通过华为云码道代码智能体控制台查看个人活跃、资源消耗等统计信息，全面了解个人使用情况。若需要升级套餐，单击“升级权益”跳转到华为云码道代码智能体控制台。详细操作请参考订阅管理。 - [系统设置](https://support.huaweicloud.com/usermanual-codeartsspace/space_0014.md): 单击码道Space客户端左下角的个人头像 ，在弹出的页面中，您可以按照自己的编码和使用习惯进行配置。查看用户的套餐额度，单击“更多”通过华为云码道代码智能体控制台查看个人活跃、资源消耗等统计信息，全面了解个人使用情况。设置界面中按钮标签及应用内其他文本的显示语言，支持简体中文和英文，可根据需要自由切换，提升使用体验。单击码道Space客户 - [问题反馈](https://support.huaweicloud.com/usermanual-codeartsspace/space_0015.md): 码道Space支持快速反馈用户在使用过程中遇到的问题和建议，助力产品持续优化，还能有效连接开发者，促进交流与合作。提交BUG：用于反馈软件中发现的问题，包括界面错误、功能异常、操作卡顿等。我有建议：用于收集您对产品功能的创新想法或改进建议。请尽可能详细地描述您的需求，我们将评估可行性并优先考虑纳入开发计划。如果您在码道Space使用的过程 ## 最佳实践 - [基于自定义规则的AI绘图逻辑构建实践](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0006.md): 在AI辅助绘图的实际应用中，由于缺乏统一的规则约束，AI在理解用户提示词、构建画面结构以及处理元素之间逻辑关系方面仍存在较大的不确定性。这种随机性通常会导致生成结果与用户预期存在偏差，影响使用效率和创作精度。因此，通常需要用户不断优化提示词，并通过多轮迭代调整，才能逐步接近目标效果，提升AI绘图在实际场景中的可用性与可靠性。本实践以华为云 - [使用技能创建器生成PDF按章节拆分Skill](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0008.md): 日常办公中，手册、报告、论文、标书等长PDF文档处理较为常见，人工拆分章节、逐一对文件重命名不仅耗时，也影响文档处理效率。为了解决这一痛点，您可以通过华为云码道CodeArts代码智能体，使用技能市场中提供的技能创建器（Skill Creator），快速生成专属的PDF拆分Skill。您可以在市场中找到技能创建器，完成安装后进行使用。当您 - [检查点会话回退最佳实践](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0007.md): 软件系统完成基础核心版本开发后，通常会在迭代中持续新增各类扩展功能，以不断丰富产品能力、满足多样化业务场景。但部分非核心扩展功能在实际验证后，会出现与业务需求不匹配、增加系统性能损耗、导致交互冗余复杂等问题，影响整体稳定性与使用体验。在不破坏核心业务、不残留冗余代码与配置的前提下，通过会话级检查点机制实现系统状态自动存档与精准回滚，可一键 - [井字棋游戏本地开发及静态产物验证实践](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0009.md): 前端开发中，会面临TypeScript类型不规范、界面样式调试耗时、工程配置易出错等问题。本实践以Next.js+React+TypeScript井字棋单页应用本地开发场景为例，帮助开发者依托华为云码道代码智能体完成项目初始化、代码生成、本地功能全量验证，提升前端研发效率与代码质量。在使用华为云码道代码智能体前，您需要先创建一个项目，用于 - [SDD开发模式标准工作流与斜杠命令实践](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0011.md): 华为云码道代码智能体的规范驱动开发模式（SDD）是一种以规格说明为核心的软件开发方法。开发者提供需求描述后，智能体依次生成规格说明、设计方案与任务规划，让开发者和智能体在编码前就任务目标及实施方案达成共识，最终产出高质量代码。华为云码道代码智能体的SDD开发模式采用如图1所示的四阶段递进式流程。在此基础上，华为云码道代码智能体提供了两种使 - [前提条件](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0013.md): 在执行本实践前，请先开通华为云码道（CodeArts）套餐、为各个角色配置权限。本实践以Windows操作系统为例。华为账号完成体验版套餐购买后，请继续新建CodeArts项目和代码检查规则。 - [新建CodeArts项目和代码检查规则](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0014.md): 如果您的账号下已有存量项目，请单击“新建 > 新建项目”，进入项目的新建页面。如果您的账号下没有项目，请执行4。新建项目成功，将自动跳转至需求管理的“工作项”页面。项目的创建者默认为项目经理。新建代码仓库成功，页面将自动跳转至仓库的“代码”页面。页面提示操作成功，将自动跳转至“文件”页面，页面中显示分支“develop-dev”。新建分支 - [开发二叉树最大路径和代码](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0015.md): 开发人员需要基于“develop-dev”分支开发新需求的代码。其中，分支名表示需要克隆的分支名称，https://example.com表示代码仓的HTTPS地址。出现如下回显，表示成功克隆代码仓repo-demo的develop-dev分支到本地。$ git clone -b develop-dev https://test.com/ - [使用CodeArts Check MCP检查分支代码](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0016.md): 出现下述回显，表当前分支正确。* develop-dev出现下述回显，红色代表未保存的修改文件，确认需要提交的代码。On branch develop-dev Your branch is up to date with 'origin/develop-dev'. Untracked files: (use "git add 代码托管”，进入代码托管首页，单击代码仓库名称“re - [相关文档](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0020.md): 问题现象用户在获取扫描报告时，IDE返回报错信息“代码检查任务已提交，但在执行阶段因IAM认证信息无效而失败”。解决方案这是由于mcp_settings.json文件的environment.ak和environment.sk值不准确。如果修改mcp_settings.json文件的environment.ak和environment.s - [环境准备](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0043.md): 单击华为云码道代码智能体IDE右上角的设置图标 ，进入全局设置页面。在对话流 > 智能体 > 终端命令运行模式中，选择智能体执行终端命令的运行策略，本实践使用默认运行策略，即沙箱运行。在“对话流 > 智能体 > 自动批准”中，单击 以开启所需的自动批准项目。授权自动化操作后，复杂工程级代码生成流程中的各项任务可自动执行。如果您未开启自动化 - [JIRA](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0023.md): 账号注册完成后，将自动跳转至JIRA首页。等待Jira Product Discovery完成添加后，将自动跳转到All ideas页面。等待Confluence开通后，将自动跳转至Confluence首页。 - [TestRail](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0024.md): 等待初始化成功后，将自动跳转至实例首页。填写实例配置参数实例配置完成后，请记住您的访问地址。例如，本案例的访问地址为“chan.testrail.io”。 - [SonarQube](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0025.md): 授权成功后，将自动跳转至“Create an organization”页面。选择需要检查的代码仓 - [新建GitHub代码仓库](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0027.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。 - [在GitHub新建Token](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0028.md): 新建Token成功后，将自动跳转到新建的Token页面。由于该Token是临时生成的，请用户复制并保存该Token。填写Token配置信息 - [在SonarQube创建代码自动检查](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0029.md): 其中，需要注意的是，本案例基于develop分支进行开发，期望在develop推送时也扫描代码，因此在branches下增加“- develop”值。新建“sonar-project.properties” - [克隆GitHub代码仓到本地](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0030.md): 如果您处于外网，请执行如下命令：git clone -b develop https://github.com/GitHub用户名/仓库名.git如果您处于内网，请执行如下命令：git clone -b develop \ -c http.proxy="http://:@和可参考6~8获取 - [安装TestRail-MCP](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0035.md): 安装完成后，在已安装页签，可查看到已安装的“TestRail-MCP”MCP服务。其中，<实例访问地址>通过TestRail配置获取；TestRail Full Name为2注册时所填写，例如，本案例的TestRail Full Name为Jaon Chan；通过1~5获取。保存配置后，在已安装页签，单 - [与JIRA平台集成](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0036.md): 根据AI的答复，您可进入生成路径下检视spec.md文件，确认生成内容是否满足您的要求，如果需要AI继续优化该需求文档，您可在聊天界面继续与AI进行对话交互。待AI优化后，可重新查看spec.md文件：若想手动修改，用户可在spec.md文件手动修改完成后，在聊天界面单击“全部接受”。若想使用AI继续优化，可单击“全部接受”后，继续与AI - [在CodeArts Agent完成智能代码开发](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0037.md): 如果测试用例全部可执行通过，表示代码可执行。请根据AI答复，确认URL爬取的准确性，如果拉取不正确，请可继续与AI对话。包含如下回显，您便可以根据返回结果，打开拼接后的链接，验证URL爬取正确性。例如，在浏览器中打开链接https://support.huaweicloud.com//zh-cn/price-codeartsagent/c - [推送代码到GitHub](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0038.md): 无任何回显，表示成功将修改文件都提交至暂存区。绿色表示校验通过，红色表示任务中途报错终止。如果任务执行失败，请参考GitHub自动触发的CI自动化构建任务执行失败解决，如果仍未解决问题，您可以通过华为云工单系统提交工单获取华为云的客户服务支持。查看Actions流水线运行记录 - [新建合并请求](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0039.md): Actions校验通过后，可新建合并请求。AI通过问题定位，给出如下修复建议：例如，在聊天界面的输入框中，输入如下指令，单击发送图标 。第1条修复建议在哪里修改配置AI将给出详细的修复方法，您可以根据AI提供的修复方法进行操作，也可让AI尝试修复。如果构建流水线已通过，且代码意见已修改完成，即可合入合并请求。 - [GitHub自动触发的CI自动化构建任务执行失败](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0041.md): 用户从本地推送代码到云端仓库，CI自动执行失败。AI将找到失败的Action运动，获取job日志并尝试解决问题。 - [Atlassian-MCP连接失败](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0042.md): 如果您的Atlassian-MCP连接失败，并返回如下报错信息：以下任一原因都会导致您的Atlassian-MCP连接失败：Atlassian官方远程MCP接入地址：https://mcp.atlassian.com/v1/mcp/authv2，支持OAuth网页登录授权，您可能没有及时在弹出的网页确认授权。您可能之前登录过其他Atlas - [生成通用逻辑代码](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0001.md): 一些常见的算法，比如正则表达式、时间处理函数等算法，具有业务逻辑简单但是研发人员编写较为复杂的特性（通常是因为复杂的编码规则，需要人员查阅对应的资料）。可以使用代码生成，快速生成常见的基础算法，让开发人员专注于处理复杂逻辑。此案例函数逻辑清晰，但是正则的编写对研发人员来说往往需要翻阅资料，较为耗时。如果首次生成的代码不完整，可以先按Tab - [快速进行仿写](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0002.md): API Controller层的开发基本上和复杂业务逻辑进行了解耦。同时一个业务内的API相似度很高，可以直接使用代码生成，依赖现有的接口去扩展业务接口。相似结构的接口实现代码：注释内容：根据上述注释生成的代码：上述项目文件中，已经有结构清晰的上文代码，研发人员在续写的时候，可以通过注释的方式，生成类似结构的代码。 - [编写数据库接口](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0003.md): MyBatis作为常见的数据库框架，经常涉及到大量的接口类生成，并且很多情况下这些接口类都具有类似的格式，因此在上文的基础上生成新的业务接口也是比较常见的代码生成场景。对于类似的业务逻辑，可以直接生成对应的接口。可以通过代码生成能力，快速学习到已有代码的行文风格，并在此基础上快速扩展代码，提升编码效率。 - [查询未知依赖](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0004.md): 缺失代码依赖，或者缺少软件包信息，不需要去网站搜索，在IDE内部即可完成查询。当前展示的效果图仅是示例，请以最终实际生成的效果为准。 - [直接引入组件](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0005.md): 对于常见的三方组件，可以使用华为云码道代码智能体提示常见的引入方法和代码模板。当前展示的效果图仅是示例，请以最终实际生成的效果为准。 - [如何写好一个Skill](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0010.md): 没有Skill的团队，每个人都在重复造轮子。工程师的提示词散落各处，项目经理（Project Manager）的需求表述每次让智能体重新猜，管理层的经验则随着人员流动悄悄蒸发。表面上看，工程师、项目经理、管理层关心的事情完全不同。但在智能体工具的使用层面，大家面对的是同一个困境：经验无法积累，质量依赖个人。Skill的本质——隐性知识的代 ## 常见问题 - [登录失败](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0006.md): 问题现象遇到以下任一报错，你可以参考本章节定位和解决：用户登录失败，并提示“本次登录失败，请重新登录”“Error: Unable to connect. Is the computer able to access the url?”原因分析如果你使用公司内网，可能是以下任一原因导致的报错：你已经配置代理或使用系统代理，但未填写代理认证 - [这个程序不支持该版本的计算机运行](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0017.md): 双击华为云码道代码智能体IDE安装包时，报错“这个程序不支持该版本的计算机运行”。您的操作系统为Windows，并且您的系统开启了兼容模式，兼容模式选择的不是Windows 10（系统版本必须为2019年及以上）或Windows 11。请按照下述步骤关闭兼容性：单击确定后，重新双击华为云码道代码智能体IDE安装包即可。 - [尚未获得此功能的访问权限](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0008.md): 在使用华为云码道代码智能体功能时，页面提示“您好，您尚未获得此功能的访问权限，请联系企业管理员为您开启席位。”。华为账号、IAM用户或企业联邦用户出现以下任意一种情况，均会触发该提示：账号未加入企业成员，且未分配席位。账号已加入企业成员，但未分配席位。在左侧导航栏选择“企业管理 > 成员及团队管理”，进入“成员及团队管理”页面。单击右上角 - [Windows下.exe安装程序双击后闪退](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0002.md): 双击IDE的.exe安装包时，Microsoft Store闪现且后续没有出现安装应用程序。Windows设置了仅允许从Microsoft Store安装应用。 - [华为云码道代码智能体IDE Linux安装常用命令汇总](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0003.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。 - [如何查看华为云码道代码智能体服务的软件版本号？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0016.md): 在华为云码道代码智能体IDE中，您可以通过以下方式查看当前运行服务软件的版本信息。通过“关于”对话框查看（推荐）在华为云码道代码智能体IDE工具顶部菜单栏中，单击“帮助”，选择“关于”。在弹出的关于页面中，即可查看到软件的具体版本信息。在华为云码道代码智能体IDE工具顶部菜单栏中，单击“帮助”，选择“关于”。在弹出的关于页面中，即可查看到 - [受限模式，功能已被禁用](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0065.md): 登录华为云码道代码智能体后，提示受限模式，功能已禁用。新建或打开项目时，若选择“否，我不信任此作者”，华为云码道代码智能体将自动切换至受限模式，此时所有智能功能将被禁用。单击“信任”仅信任当前目录及其工作区内的文件（即D:\TestCode\demo）。单击“信任父级”则会向上扩展，信任整个父目录（即D:\TestCode）及其所有子目录 - [鸿蒙PC安装华为云码道代码智能体常见报错](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0070.md): 若出现以下任一报错，可参考本常见问题开展排查解决：在鸿蒙PC上安装华为云CodeArts码道智能体后，登录后出现报错：“请求异常，请稍后重试”、“服务连接异常 服务正在尝试恢复连接，请稍后重试。”；与AI进行会话时，AI返回“Server is killed”；在码道代码智能体打开任意文件时，出现对应的语言服务报错。您的鸿蒙PC系统版本不 - [登录失败](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0006.md): 问题现象遇到以下任一报错，你可以参考本章节定位和解决：用户登录失败，并提示“本次登录失败，请重新登录”“Error: Unable to connect. Is the computer able to access the url?”原因分析如果你使用公司内网，可能是以下任一原因导致的报错：你已经配置代理或使用系统代理，但未填写代理认证 - [这个程序不支持该版本的计算机运行](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0017.md): 双击华为云码道代码智能体IDE安装包时，报错“这个程序不支持该版本的计算机运行”。您的操作系统为Windows，并且您的系统开启了兼容模式，兼容模式选择的不是Windows 10（系统版本必须为2019年及以上）或Windows 11。请按照下述步骤关闭兼容性：单击确定后，重新双击华为云码道代码智能体IDE安装包即可。 - [尚未获得此功能的访问权限](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0008.md): 在使用华为云码道代码智能体功能时，页面提示“您好，您尚未获得此功能的访问权限，请联系企业管理员为您开启席位。”。华为账号、IAM用户或企业联邦用户出现以下任意一种情况，均会触发该提示：账号未加入企业成员，且未分配席位。账号已加入企业成员，但未分配席位。在左侧导航栏选择“企业管理 > 成员及团队管理”，进入“成员及团队管理”页面。单击右上角 - [Windows下.exe安装程序双击后闪退](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0002.md): 双击IDE的.exe安装包时，Microsoft Store闪现且后续没有出现安装应用程序。Windows设置了仅允许从Microsoft Store安装应用。 - [华为云码道代码智能体IDE Linux安装常用命令汇总](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0003.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。 - [如何查看华为云码道代码智能体服务的软件版本号？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0016.md): 在华为云码道代码智能体IDE中，您可以通过以下方式查看当前运行服务软件的版本信息。通过“关于”对话框查看（推荐）在华为云码道代码智能体IDE工具顶部菜单栏中，单击“帮助”，选择“关于”。在弹出的关于页面中，即可查看到软件的具体版本信息。在华为云码道代码智能体IDE工具顶部菜单栏中，单击“帮助”，选择“关于”。在弹出的关于页面中，即可查看到 - [受限模式，功能已被禁用](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0065.md): 登录华为云码道代码智能体后，提示受限模式，功能已禁用。新建或打开项目时，若选择“否，我不信任此作者”，华为云码道代码智能体将自动切换至受限模式，此时所有智能功能将被禁用。单击“信任”仅信任当前目录及其工作区内的文件（即D:\TestCode\demo）。单击“信任父级”则会向上扩展，信任整个父目录（即D:\TestCode）及其所有子目录 - [鸿蒙PC安装华为云码道代码智能体常见报错](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0070.md): 若出现以下任一报错，可参考本常见问题开展排查解决：在鸿蒙PC上安装华为云CodeArts码道智能体后，登录后出现报错：“请求异常，请稍后重试”、“服务连接异常 服务正在尝试恢复连接，请稍后重试。”；与AI进行会话时，AI返回“Server is killed”；在码道代码智能体打开任意文件时，出现对应的语言服务报错。您的鸿蒙PC系统版本不 - [Windows生成的换行符在Linux环境中无法正常执行](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0023.md): 生成的文件是Windows系统的换行符（CRLF），无法在Linux系统上运行。在Windows系统上编写的脚本文件，默认使用Windows换行符（CRLF）。当用户在Linux系统上运行时，将\r当作普通字符处理，导致无法正常运行。可以通过华为云码道代码智能体提供的规则（Rules）能力来约定智能体。在华为云码道代码智能体中支持创建项目 - [微软新版插件不兼容使用说明](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0034.md): 在华为云码道代码智能体IDE安装过程中选择了“从VS Code导入”配置，导入的插件在华为云码道代码智能体IDE中无法正常运行。微软近期加强了对C/C++等官方语言支持插件的安全管控，仅允许在官方产品中运行。请优先前往华为云码道代码智能体IDE插件市场，搜索并安装功能类似的替代插件。如果市场内暂无满足需求的插件，请获取旧版本的插件安装包并 - [如何解决由插件兼容性问题导致的会话创建失败？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0040.md): 在华为云码道代码智能体聊天界面发起会话时，提示如下报错信息：因插件兼容性问题（如 Microsoft Foundry等），CodeArts Agent会话创建失败。在插件市场中安装了Microsoft Foundry插件。该插件加载过程中可能会修改系统变量或依赖库，从而干扰华为云码道代码智能体的运行环境。 - [如何解决华为云码道代码智能体IDE黑屏问题](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0060.md): 在使用华为云码道代码智能体IDE工具时，界面出现完全黑屏，无法显示正常内容。华为云码道代码智能体所使用的Electron框架，在部分图形处理器（GPU）的硬件加速配置下存在兼容性问题。临时规避方案您可以拖动窗口边缘调整大小，或按下F11键切换全屏模式，通过强制触发软件渲染恢复。您可以拖动窗口边缘调整大小，或按下F11键切换全屏模式，通过强 - [如何解决远程扩展宿主响应超时的问题](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0055.md): 使用华为云码道代码智能体IDE时可能会遇到断连的故障，报错提示“检测到远程扩展宿主响应超时。正在重新连接”，重新加载窗口后，还是提示报错“检测到远程扩展宿主在1分钟内响应超时2次，请重新加载窗口”。可能是用户安装的插件引起断连，请根据解决方法进行排查解决。您可以根据场景，选择对应的解决方案：若报错提示给出引起断连的异常插件名称，请将异常插 - [Windows生成的换行符在Linux环境中无法正常执行](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0023.md): 生成的文件是Windows系统的换行符（CRLF），无法在Linux系统上运行。在Windows系统上编写的脚本文件，默认使用Windows换行符（CRLF）。当用户在Linux系统上运行时，将\r当作普通字符处理，导致无法正常运行。可以通过华为云码道代码智能体提供的规则（Rules）能力来约定智能体。在华为云码道代码智能体中支持创建项目 - [微软新版插件不兼容使用说明](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0034.md): 在华为云码道代码智能体IDE安装过程中选择了“从VS Code导入”配置，导入的插件在华为云码道代码智能体IDE中无法正常运行。微软近期加强了对C/C++等官方语言支持插件的安全管控，仅允许在官方产品中运行。请优先前往华为云码道代码智能体IDE插件市场，搜索并安装功能类似的替代插件。如果市场内暂无满足需求的插件，请获取旧版本的插件安装包并 - [如何解决由插件兼容性问题导致的会话创建失败？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0040.md): 在华为云码道代码智能体聊天界面发起会话时，提示如下报错信息：因插件兼容性问题（如 Microsoft Foundry等），CodeArts Agent会话创建失败。在插件市场中安装了Microsoft Foundry插件。该插件加载过程中可能会修改系统变量或依赖库，从而干扰华为云码道代码智能体的运行环境。 - [如何解决华为云码道代码智能体IDE黑屏问题](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0060.md): 在使用华为云码道代码智能体IDE工具时，界面出现完全黑屏，无法显示正常内容。华为云码道代码智能体所使用的Electron框架，在部分图形处理器（GPU）的硬件加速配置下存在兼容性问题。临时规避方案您可以拖动窗口边缘调整大小，或按下F11键切换全屏模式，通过强制触发软件渲染恢复。您可以拖动窗口边缘调整大小，或按下F11键切换全屏模式，通过强 - [如何解决远程扩展宿主响应超时的问题](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0055.md): 使用华为云码道代码智能体IDE时可能会遇到断连的故障，报错提示“检测到远程扩展宿主响应超时。正在重新连接”，重新加载窗口后，还是提示报错“检测到远程扩展宿主在1分钟内响应超时2次，请重新加载窗口”。可能是用户安装的插件引起断连，请根据解决方法进行排查解决。您可以根据场景，选择对应的解决方案：若报错提示给出引起断连的异常插件名称，请将异常插 - [环境与性能指标规范](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0029.md): 本文档明确了设备的软硬件配置标准及核心性能指标，确保您的使用体验与运行效率。推荐物理内存16GB及以上（可用内存不低于10GB）；最低物理内存要求8GB（可用内存不低于4GB）。其中，16GB及以上内存可显著提升运行流畅度，尤其适用于多任务处理与大型项目编译场景。推荐Intel第10代 i5或Apple M4系列芯片。最低要求Intel - [滑动窗口限流机制](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0015.md): 在使用华为云码道代码智能体服务时，提示如下报错信息：套餐5小时窗口周期内，当前模型可用额度已用完，系统将在60分钟后自动为您陆续恢复。套餐7天窗口周期内，当前模型可用额度已用完，系统将在24小时后自动为您陆续恢复。华为云码道代码智能体采用“滑动窗口限流”策略，对每个用户在指定模型上的使用量实施“双维度、双窗口”的精细化配额管控：双维度监控 - [定时任务抖动机制](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0069.md): 每次触发循环任务时，会在计划时间基础上向后延迟一小段随机时间。偏移量计算：基于任务ID确定性计算（同一任务每次偏移量一致，不随时间变化）。偏移范围：min(10% × 执行周期, 5分钟)，即最多5分钟。偏移方向：仅向后延迟，不会提前执行。整点和半点是多个任务最容易集中触发的时刻，抖动机制专门针对这些时刻分散负载。单次任务仅在触发时间恰好 - [环境与性能指标规范](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0029.md): 本文档明确了设备的软硬件配置标准及核心性能指标，确保您的使用体验与运行效率。推荐物理内存16GB及以上（可用内存不低于10GB）；最低物理内存要求8GB（可用内存不低于4GB）。其中，16GB及以上内存可显著提升运行流畅度，尤其适用于多任务处理与大型项目编译场景。推荐Intel第10代 i5或Apple M4系列芯片。最低要求Intel - [滑动窗口限流机制](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0015.md): 在使用华为云码道代码智能体服务时，提示如下报错信息：套餐5小时窗口周期内，当前模型可用额度已用完，系统将在60分钟后自动为您陆续恢复。套餐7天窗口周期内，当前模型可用额度已用完，系统将在24小时后自动为您陆续恢复。华为云码道代码智能体采用“滑动窗口限流”策略，对每个用户在指定模型上的使用量实施“双维度、双窗口”的精细化配额管控：双维度监控 - [定时任务抖动机制](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0069.md): 每次触发循环任务时，会在计划时间基础上向后延迟一小段随机时间。偏移量计算：基于任务ID确定性计算（同一任务每次偏移量一致，不随时间变化）。偏移范围：min(10% × 执行周期, 5分钟)，即最多5分钟。偏移方向：仅向后延迟，不会提前执行。整点和半点是多个任务最容易集中触发的时刻，抖动机制专门针对这些时刻分散负载。单次任务仅在触发时间恰好 - [远程连接失败，提示认证失败](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0036.md): 执行远程连接操作时，提示认证失败。用户名、IP地址或端口配置有误。在华为云码道代码智能体IDE中，单击 ，进入远程开发页面。将鼠标悬浮在对应的连接上，查看用户名、IP地址和端口是否正确。您也可以单击远程连接上的 ，进入连接编辑页面进行查看。此处配置的密码是对应Linux账户的登录密码，端口是SSH的连接端口。如果是普通Linux主机，端口 - [远程连接失败，提示ETIMEDOUT](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0037.md): 执行远程连接操作时，提示ETIMEDOUT。若出现上述提示，请首先尝试重新连接。若重试无效，建议通过命令行（CMD）或SSH客户端（如PuTTY、Xshell）直接建立连接以进一步排查。若问题依旧存在，则通常表明存在网络连接故障或服务器本身问题。可以通过ping命令简单判断（但有的远程机器因为安全组设置禁ping，可以通过tracert命 - [Docker环境下，内置浏览器预览失败](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0028.md): 编译环境为Docker环境时，打开内置浏览器页面，预览失败。OPTIONS：可选参数，用户根据需求自定义的参数，例如-d表示在后台运行、-v表示挂载卷等。host_port：宿主机上的端口号，如8080。container_port：容器内的端口号，如80。例如，-p 8080:80就是把宿主机的8080端口映射到容器的80端口。IMAG - [远程连接失败，提示认证失败](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0036.md): 执行远程连接操作时，提示认证失败。用户名、IP地址或端口配置有误。在华为云码道代码智能体IDE中，单击 ，进入远程开发页面。将鼠标悬浮在对应的连接上，查看用户名、IP地址和端口是否正确。您也可以单击远程连接上的 ，进入连接编辑页面进行查看。此处配置的密码是对应Linux账户的登录密码，端口是SSH的连接端口。如果是普通Linux主机，端口 - [远程连接失败，提示ETIMEDOUT](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0037.md): 执行远程连接操作时，提示ETIMEDOUT。若出现上述提示，请首先尝试重新连接。若重试无效，建议通过命令行（CMD）或SSH客户端（如PuTTY、Xshell）直接建立连接以进一步排查。若问题依旧存在，则通常表明存在网络连接故障或服务器本身问题。可以通过ping命令简单判断（但有的远程机器因为安全组设置禁ping，可以通过tracert命 - [Docker环境下，内置浏览器预览失败](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0028.md): 编译环境为Docker环境时，打开内置浏览器页面，预览失败。OPTIONS：可选参数，用户根据需求自定义的参数，例如-d表示在后台运行、-v表示挂载卷等。host_port：宿主机上的端口号，如8080。container_port：容器内的端口号，如80。例如，-p 8080:80就是把宿主机的8080端口映射到容器的80端口。IMAG - [新建项目时没有出现弹窗](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0022.md): 新建项目时，未弹出窗口供用户选择在新窗口或当前窗口打开。您已经勾选了不再询问。如果希望下次新建项目时在新窗口打开，设置为on。如果希望下次新建项目时在当前窗口打开，设置为off。如果希望下次新建项目时弹出选择窗口，设置为default。 - [克隆Git仓库时，提示Could not connect to server](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0026.md): 在华为云码道代码智能体IDE中，通过Git克隆远程仓库时，提示Could not connect to server。您当前使用的是公司内网，请配置代理以确保正常访问。在本地的C:\Users\用户名\.gitconfig文件中，增加如下内容： - [如何设置Git的提交信息？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0030.md): 华为云码道代码智能体IDE深度集成Git版本控制系统，并提供了直观易用的图形化界面（GUI）。您可一键查看文件变更状态（修改、新增、未跟踪），轻松对比代码差异，完成暂存、提交、推送、拉取等操作，同时高效解决合并冲突。无需记忆复杂命令，开箱即用，显著降低学习成本，让版本管理更直观、高效。完成代码修改后，您可以在README.md文件中记录相 - [新建项目时没有出现弹窗](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0022.md): 新建项目时，未弹出窗口供用户选择在新窗口或当前窗口打开。您已经勾选了不再询问。如果希望下次新建项目时在新窗口打开，设置为on。如果希望下次新建项目时在当前窗口打开，设置为off。如果希望下次新建项目时弹出选择窗口，设置为default。 - [克隆Git仓库时，提示Could not connect to server](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0026.md): 在华为云码道代码智能体IDE中，通过Git克隆远程仓库时，提示Could not connect to server。您当前使用的是公司内网，请配置代理以确保正常访问。在本地的C:\Users\用户名\.gitconfig文件中，增加如下内容： - [如何设置Git的提交信息？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0030.md): 华为云码道代码智能体IDE深度集成Git版本控制系统，并提供了直观易用的图形化界面（GUI）。您可一键查看文件变更状态（修改、新增、未跟踪），轻松对比代码差异，完成暂存、提交、推送、拉取等操作，同时高效解决合并冲突。无需记忆复杂命令，开箱即用，显著降低学习成本，让版本管理更直观、高效。完成代码修改后，您可以在README.md文件中记录相 - [模型未加载成功，无法使用](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0049.md): 登录华为云码道代码智能体后，出现如下报错“模型未加载成功，无法使用”。该报错可能由以下原因之一导致。您的网络处于公司内网，未配置代理。本地有缓存。请根据您的使用场景，解决排障：若您处于公司内网且尚未配置代理，请为当前使用的IDE或插件配置网络代理，请参考网络代理配置华为云码道代码智能体IDE的网络代理，请参考网络代理配置华为云码道代码智能 - [项目中的.arts目录是做什么的？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0025.md): .arts是一个项目级配置目录，主要用于存储与当前项目紧密相关的配置文件（如settings.json用于项目设置，launch.json用于调试配置等）。这些配置仅作用于当前项目，不会影响华为云码道代码智能体的全局设置，从而实现项目之间的配置隔离。例如，在华为云码道代码智能体IDE中执行运行或调试操作（如图1），系统会自动生成一个.ar - [开启对话时，报错“请求失败！请重试。”](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0067.md): 当您调用华为云码道代码智能体时，可能出现如下报错“请求失败！请重试。”请您检查当前的代理配置情况，可能是由代理配置异常引起的。您可以参考网络代理进行配置。如果当前方法仍然没有生效，您可以通过华为云工单系统提交工单获取华为云的客户服务支持。 - [提示“计算资源紧张，请稍后再试”](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0004.md): 使用华为云码道代码智能体功能时，聊天窗口或IDE右下角提示计算资源紧张，请稍后再试。当前计算资源紧张，无法响应。等待一段时间再触发华为云码道代码智能体。 - [提示“代码生成暂无结果”](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0005.md): 使用华为云码道代码智能体生成代码时，聊天窗口或IDE右下角提示代码生成暂无结果。华为云码道代码智能体分析当前代码上下文信息后无可推荐代码。重新触发代码生成或切换至代码中其他位置触发代码生成。如果当前方法仍然没有生效，您可以通过华为云工单系统提交工单获取华为云的客户服务支持。 - [输出内容存在乱码](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0011.md): 用户在华为云码道代码智能体中输入会话内容后，生成的输出内容中出现乱码现象。终端编码与程序输出编码不一致。在Windows系统中，不同代码页（Code Page）对应不同的字符集支持。为避免此类问题，建议将终端代码页统一设置为65001（UTF-8）。设置后，再次发起会话，查看问题是否解决。如果仍然存在乱码，请继续执行2。在PowerShe - [如何解决排队等待问题？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0033.md): 问题现象在华为云码道代码智能体聊天界面发起任务时，如果当前队列已满，模型会返回以下任一提示：当前模型请求量较大，目前排队的队列已满，请稍后或切换其他模型。当前请求量较大，已为您优先排队，请稍后。解决方法参考界面提示，请稍后重试或切换其他模型。问题现象在华为云码道代码智能体聊天界面发起任务时，如果高峰排队，模型会返回以下任一提示：当前为使用 - [如何设置代码跳转、查看定义或声明等功能？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0031.md): 代码开发完成后，可通过代码跳转至定义、声明或引用位置，查找所有引用等功能，高效查阅并理解代码逻辑。您只需根据开发语言安装对应的语言服务插件，即可启用相关能力。请按照以下步骤进行设置：请根据开发语言安装对应的语言服务插件：Python：ms-python.python插件Go：golang.go插件Java：vscode-java-pack - [对话中断后重新提问，AI会沿用此前对话上下文继续回复](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0039.md): 智能体运行过程中，单击“停止回答”终止当前任务后，然后立即下发新指令，智能体无法识别终止操作，仍继续按照之前的逻辑执行未完成的任务，造成任务重复执行、逻辑错乱等问题。上下文保留机制：智能体的设计逻辑是保留完整的对话历史以便理解上下文。单击“停止回答”仅中断了当前的内容生成，并未从对话记录中删除该条历史指令。模型推理逻辑：当发送新问题时，系 - [沙箱程序被拦截导致执行失败的解决方案](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0058.md): 在沙箱模式下运行时，提示如下任一报错：Sandbox exe not found at expected path: C:\Users\XXXX\.codeartsdoer\codearts-data\sandbox_runner\1.1.0-202605251700\sandbox\win32-x64\windows_sandbox.e - [开启本地LSP功能后提示服务不可用](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0059.md): 启动本地LSP功能后，调用LSP相关工具，智能体提示“LSP服务当前不可用”。LSP服务器未下载成功。当日志中出现failed to install时，表示对应语言的LSP服务器未能成功下载或安装。请按以下步骤进行排查和手动修复。定位日志文件。在日志目录下，找到以kernel-codeartsdoer-incognito开头的.log文件 - [如何解决因内存溢出导致沙箱任务终止的问题？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0063.md): 在沙箱中运行任务时，任务异常终止并提示如下信息：任务因沙箱内存溢出而终止，请增大沙箱内存规格或点击“运行”转为沙箱外运行。在沙箱隔离运行环境中，您可通过sandbox.json配置文件自定义沙箱的CPU和内存规格。当任务运行过程中实际内存占用超过所配置的内存上限时，系统会因内存溢出（OOM）强制终止任务，导致执行失败。常见触发场景包括：处 - [模型未加载成功，无法使用](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0049.md): 登录华为云码道代码智能体后，出现如下报错“模型未加载成功，无法使用”。该报错可能由以下原因之一导致。您的网络处于公司内网，未配置代理。本地有缓存。请根据您的使用场景，解决排障：若您处于公司内网且尚未配置代理，请为当前使用的IDE或插件配置网络代理，请参考网络代理配置华为云码道代码智能体IDE的网络代理，请参考网络代理配置华为云码道代码智能 - [项目中的.arts目录是做什么的？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0025.md): .arts是一个项目级配置目录，主要用于存储与当前项目紧密相关的配置文件（如settings.json用于项目设置，launch.json用于调试配置等）。这些配置仅作用于当前项目，不会影响华为云码道代码智能体的全局设置，从而实现项目之间的配置隔离。例如，在华为云码道代码智能体IDE中执行运行或调试操作（如图1），系统会自动生成一个.ar - [开启对话时，报错“请求失败！请重试。”](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0067.md): 当您调用华为云码道代码智能体时，可能出现如下报错“请求失败！请重试。”请您检查当前的代理配置情况，可能是由代理配置异常引起的。您可以参考网络代理进行配置。如果当前方法仍然没有生效，您可以通过华为云工单系统提交工单获取华为云的客户服务支持。 - [提示“计算资源紧张，请稍后再试”](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0004.md): 使用华为云码道代码智能体功能时，聊天窗口或IDE右下角提示计算资源紧张，请稍后再试。当前计算资源紧张，无法响应。等待一段时间再触发华为云码道代码智能体。 - [提示“代码生成暂无结果”](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0005.md): 使用华为云码道代码智能体生成代码时，聊天窗口或IDE右下角提示代码生成暂无结果。华为云码道代码智能体分析当前代码上下文信息后无可推荐代码。重新触发代码生成或切换至代码中其他位置触发代码生成。如果当前方法仍然没有生效，您可以通过华为云工单系统提交工单获取华为云的客户服务支持。 - [输出内容存在乱码](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0011.md): 用户在华为云码道代码智能体中输入会话内容后，生成的输出内容中出现乱码现象。终端编码与程序输出编码不一致。在Windows系统中，不同代码页（Code Page）对应不同的字符集支持。为避免此类问题，建议将终端代码页统一设置为65001（UTF-8）。设置后，再次发起会话，查看问题是否解决。如果仍然存在乱码，请继续执行2。在PowerShe - [如何解决排队等待问题？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0033.md): 问题现象在华为云码道代码智能体聊天界面发起任务时，如果当前队列已满，模型会返回以下任一提示：当前模型请求量较大，目前排队的队列已满，请稍后或切换其他模型。当前请求量较大，已为您优先排队，请稍后。解决方法参考界面提示，请稍后重试或切换其他模型。问题现象在华为云码道代码智能体聊天界面发起任务时，如果高峰排队，模型会返回以下任一提示：当前为使用 - [如何设置代码跳转、查看定义或声明等功能？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0031.md): 代码开发完成后，可通过代码跳转至定义、声明或引用位置，查找所有引用等功能，高效查阅并理解代码逻辑。您只需根据开发语言安装对应的语言服务插件，即可启用相关能力。请按照以下步骤进行设置：请根据开发语言安装对应的语言服务插件：Python：ms-python.python插件Go：golang.go插件Java：vscode-java-pack - [对话中断后重新提问，AI会沿用此前对话上下文继续回复](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0039.md): 智能体运行过程中，单击“停止回答”终止当前任务后，然后立即下发新指令，智能体无法识别终止操作，仍继续按照之前的逻辑执行未完成的任务，造成任务重复执行、逻辑错乱等问题。上下文保留机制：智能体的设计逻辑是保留完整的对话历史以便理解上下文。单击“停止回答”仅中断了当前的内容生成，并未从对话记录中删除该条历史指令。模型推理逻辑：当发送新问题时，系 - [沙箱程序被拦截导致执行失败的解决方案](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0058.md): 在沙箱模式下运行时，提示如下任一报错：Sandbox exe not found at expected path: C:\Users\XXXX\.codeartsdoer\codearts-data\sandbox_runner\1.1.0-202605251700\sandbox\win32-x64\windows_sandbox.e - [开启本地LSP功能后提示服务不可用](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0059.md): 启动本地LSP功能后，调用LSP相关工具，智能体提示“LSP服务当前不可用”。LSP服务器未下载成功。当日志中出现failed to install时，表示对应语言的LSP服务器未能成功下载或安装。请按以下步骤进行排查和手动修复。定位日志文件。在日志目录下，找到以kernel-codeartsdoer-incognito开头的.log文件 - [如何解决因内存溢出导致沙箱任务终止的问题？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0063.md): 在沙箱中运行任务时，任务异常终止并提示如下信息：任务因沙箱内存溢出而终止，请增大沙箱内存规格或点击“运行”转为沙箱外运行。在沙箱隔离运行环境中，您可通过sandbox.json配置文件自定义沙箱的CPU和内存规格。当任务运行过程中实际内存占用超过所配置的内存上限时，系统会因内存溢出（OOM）强制终止任务，导致执行失败。常见触发场景包括：处 - [如何让MCP工具支持高精度数字参数？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0032.md): 在华为云码道代码智能体中配置MCP服务器后，通过MCP协议调用接口时，返回的参数值与实际输入的参数值不一致。华为云码道代码智能体没有内置高精度数字处理机制，超出安全整数范围的数字会在JSON解释阶段丢失精度。在MCP服务端，建议使用String类型传递高精度数字，即将高精度数字参数的JSON Schema类型设置为string。 - [如何解决uv目录占用磁盘空间过大问题？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0061.md): 系统磁盘空间不足，排查后发现uv或uvx相关的目录占用了大量存储空间，且随着使用时间的增长，体积持续增大。安装了使用uv/uvx启动的MCP服务器。uv是一款高性能的Python包管理工具，常用于运行MCP服务器。其磁盘占用主要来源于以下两部分：uv自身安装文件：这部分通常占用较小，可忽略不计。uv全局缓存目录：uv工具本身的机制，是导致 - [如何让MCP工具支持高精度数字参数？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0032.md): 在华为云码道代码智能体中配置MCP服务器后，通过MCP协议调用接口时，返回的参数值与实际输入的参数值不一致。华为云码道代码智能体没有内置高精度数字处理机制，超出安全整数范围的数字会在JSON解释阶段丢失精度。在MCP服务端，建议使用String类型传递高精度数字，即将高精度数字参数的JSON Schema类型设置为string。 - [如何解决uv目录占用磁盘空间过大问题？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0061.md): 系统磁盘空间不足，排查后发现uv或uvx相关的目录占用了大量存储空间，且随着使用时间的增长，体积持续增大。安装了使用uv/uvx启动的MCP服务器。uv是一款高性能的Python包管理工具，常用于运行MCP服务器。其磁盘占用主要来源于以下两部分：uv自身安装文件：这部分通常占用较小，可忽略不计。uv全局缓存目录：uv工具本身的机制，是导致 - [Visual Studio Code拖动会话窗口，当前进行中会话丢失](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0024.md): 在Visual Studio Code左右拖动会话窗口时，当前进行中会话丢失。在Visual Studio Code左右拖动会话窗口时，由于Visual Studio Code的设计机制，在窗口布局发生变化时，可能会导致插件被重新加载，插件会话框被重绘，从而正在进行的对话内容丢失。 - [聊天界面输入框输入非英文字符时，出现异常](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0014.md): 本案例以IntelliJ IDEA为例。在聊天界面的输入框中输入非英文字符时，可能遇到以下问题：中文输入法无法输入、输入法无法跟随光标。例如，您在聊天界面的输入框输入中文后，再输入中文标点符号，内容无法正常显示。例如，您在聊天界面的输入框输入中文后，再输入中文标点符号，内容无法正常显示。键盘数字输入混乱。例如，您快速输入1234567，实 - [编辑区对话异常](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0020.md): 本案例以IntelliJ IDEA为例。当您在代码编辑区输入内容时，出现无响应。您的IntelliJ IDEA版本为2023.2.*~2023.3.*，默认是离屏渲染。您可参考如下步骤查看版本号： - [25.2版本的JetBrains系列IDE无法正常获取终端输出](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0012.md): JetBrains系列IDE包括PyCharm、IntelliJ IDEA、WebStorm和CLion，本案例以IntelliJ IDEA为例。JetBrains系列IDE 25.2版本无法正常获取终端输出。JetBrains系列IDE 25.2版本默认会启用2025重制版（Reworked 2025）终端引擎，2025重制版终端引擎会 - [华为云码道代码智能体插件回退至目标历史版本](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0045.md): 如果需要将华为云码道代码智能体插件（CodeArts Agent）回退至目标历史版本，请按照下面的操作进行回退。回退历史版本可能会丢失基于新功能配置的数据，请谨慎操作。建议回退前提前备份重要数据。使用Visual Studio Code支持将华为云码道代码智能体插件（CodeArts Agent）回退至目标历史版本，参考如下操作。华为云码 - [Visual Studio Code拖动会话窗口，当前进行中会话丢失](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0024.md): 在Visual Studio Code左右拖动会话窗口时，当前进行中会话丢失。在Visual Studio Code左右拖动会话窗口时，由于Visual Studio Code的设计机制，在窗口布局发生变化时，可能会导致插件被重新加载，插件会话框被重绘，从而正在进行的对话内容丢失。 - [聊天界面输入框输入非英文字符时，出现异常](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0014.md): 本案例以IntelliJ IDEA为例。在聊天界面的输入框中输入非英文字符时，可能遇到以下问题：中文输入法无法输入、输入法无法跟随光标。例如，您在聊天界面的输入框输入中文后，再输入中文标点符号，内容无法正常显示。例如，您在聊天界面的输入框输入中文后，再输入中文标点符号，内容无法正常显示。键盘数字输入混乱。例如，您快速输入1234567，实 - [编辑区对话异常](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0020.md): 本案例以IntelliJ IDEA为例。当您在代码编辑区输入内容时，出现无响应。您的IntelliJ IDEA版本为2023.2.*~2023.3.*，默认是离屏渲染。您可参考如下步骤查看版本号： - [25.2版本的JetBrains系列IDE无法正常获取终端输出](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0012.md): JetBrains系列IDE包括PyCharm、IntelliJ IDEA、WebStorm和CLion，本案例以IntelliJ IDEA为例。JetBrains系列IDE 25.2版本无法正常获取终端输出。JetBrains系列IDE 25.2版本默认会启用2025重制版（Reworked 2025）终端引擎，2025重制版终端引擎会 - [华为云码道代码智能体插件回退至目标历史版本](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0045.md): 如果需要将华为云码道代码智能体插件（CodeArts Agent）回退至目标历史版本，请按照下面的操作进行回退。回退历史版本可能会丢失基于新功能配置的数据，请谨慎操作。建议回退前提前备份重要数据。使用Visual Studio Code支持将华为云码道代码智能体插件（CodeArts Agent）回退至目标历史版本，参考如下操作。华为云码 - [403：您的权限不足，请联系主账号给您配置action:devcloud:monthlyPackage:subscribe](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0007.md): 使用IAM用户或企业联邦用户开通华为云码道代码智能体套餐时，右上角报错提示“您的权限不足，请联系主账号给您配置action:devcloud:monthlyPackage:subscribe”。当前IAM用户或企业联邦用户未被授予购买华为云码道代码智能体的细粒度权限。在左侧导航栏选择“权限管理 > 权限”，进入“权限”页面。单击右上角的创 - [403：您的权限不足，请联系主账号给您配置action:codearts:monthlyPackage:subscribe](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0021.md): 使用IAM用户或企业联邦用户开通华为云码道代码智能体套餐时，右上角报错提示“您的权限不足，请联系主账号给您配置action:codearts:monthlyPackage:subscribe”。当前IAM用户或企业联邦用户未被授予购买华为云码道代码智能体的细粒度权限。在左侧导航栏选择“身份策略”，进入“身份策略”页面。单击右上角创建自定义 - [如何退订华为云码道CodeArts代码智能体](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0019.md): 如果您想要退订华为云码道CodeArts代码智能体，请按照如下步骤操作：具备企业管理员角色的华为账号同时拥有企业管理员角色与表1中细粒度权限的IAM用户或企业联邦用户华为账号在统一身份认证服务控制台为IAM用户授权的具体步骤请参考创建用户组并授权或创建用户组并授权（IAM新版），为企业联邦用户授权的具体步骤请参考创建用户组并授权。华为云码 - [403：您的权限不足，请联系主账号给您配置action:devcloud:monthlyPackage:subscribe](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0007.md): 使用IAM用户或企业联邦用户开通华为云码道代码智能体套餐时，右上角报错提示“您的权限不足，请联系主账号给您配置action:devcloud:monthlyPackage:subscribe”。当前IAM用户或企业联邦用户未被授予购买华为云码道代码智能体的细粒度权限。在左侧导航栏选择“权限管理 > 权限”，进入“权限”页面。单击右上角的创 - [403：您的权限不足，请联系主账号给您配置action:codearts:monthlyPackage:subscribe](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0021.md): 使用IAM用户或企业联邦用户开通华为云码道代码智能体套餐时，右上角报错提示“您的权限不足，请联系主账号给您配置action:codearts:monthlyPackage:subscribe”。当前IAM用户或企业联邦用户未被授予购买华为云码道代码智能体的细粒度权限。在左侧导航栏选择“身份策略”，进入“身份策略”页面。单击右上角创建自定义 - [如何退订华为云码道CodeArts代码智能体](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0019.md): 如果您想要退订华为云码道CodeArts代码智能体，请按照如下步骤操作：具备企业管理员角色的华为账号同时拥有企业管理员角色与表1中细粒度权限的IAM用户或企业联邦用户华为账号在统一身份认证服务控制台为IAM用户授权的具体步骤请参考创建用户组并授权或创建用户组并授权（IAM新版），为企业联邦用户授权的具体步骤请参考创建用户组并授权。华为云码 - [历史记录预览窗口展示无法自动换行](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0013.md): JetBrains系列IDE包括PyCharm、IntelliJ IDEA、WebStorm和CLion，本案例以IntelliJ IDEA为例。当您单击右上角的历史对话按钮 ，查看历史对话“冒泡排序”，由于历史对话内容较多，对话内容不能换行显示。华为云码道代码智能体采用的是离屏渲染模式。 - [如何解决历史会话丢失的问题？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0038.md): 使用华为云码道代码智能体IDE或Visual Studio Code时，若CodeArts Agent插件版本低于26.4.1，待AI模型回答问题刚结束时，升级CodeArts Agent插件或强制关闭CodeArts Agent插件，可能会导致历史会话丢失。低于26.4.1的CodeArts Agent插件版本更新历史会话的逻辑是先删除 - [无法查看原项目下的历史会话](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0047.md): 执行以下任意操作后，华为云码道代码智能体IDE的聊天窗口将无法查看原项目下的历史会话。修改当前项目名称，或修改项目完整路径中任意一层文件夹名称。例如，以下示例截图以华为云码道代码智能体IDE为例，用户将项目名称从“IDE”修改为“IDE-TEST”，单击对话历史图标 ，返回“暂未查询到对话历史”。修改当前项目名称后例如，以下示例截图以华为 - [历史记录预览窗口展示无法自动换行](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0013.md): JetBrains系列IDE包括PyCharm、IntelliJ IDEA、WebStorm和CLion，本案例以IntelliJ IDEA为例。当您单击右上角的历史对话按钮 ，查看历史对话“冒泡排序”，由于历史对话内容较多，对话内容不能换行显示。华为云码道代码智能体采用的是离屏渲染模式。 - [如何解决历史会话丢失的问题？](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0038.md): 使用华为云码道代码智能体IDE或Visual Studio Code时，若CodeArts Agent插件版本低于26.4.1，待AI模型回答问题刚结束时，升级CodeArts Agent插件或强制关闭CodeArts Agent插件，可能会导致历史会话丢失。低于26.4.1的CodeArts Agent插件版本更新历史会话的逻辑是先删除 - [无法查看原项目下的历史会话](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0047.md): 执行以下任意操作后，华为云码道代码智能体IDE的聊天窗口将无法查看原项目下的历史会话。修改当前项目名称，或修改项目完整路径中任意一层文件夹名称。例如，以下示例截图以华为云码道代码智能体IDE为例，用户将项目名称从“IDE”修改为“IDE-TEST”，单击对话历史图标 ，返回“暂未查询到对话历史”。修改当前项目名称后例如，以下示例截图以华为 - [数据归属和安全](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0010.md): 华为云码道代码智能体输出的代码版权归属用户。华为云码道代码智能体本质上是一个工具，根据用户的输入和预训练的模型生成代码，工具本身不具有创作自主性和意图，其输出的内容是对用户指令的响应和实现。类似传统的编程工具或IDE，它们辅助开发者编写代码，但代码的版权仍然归属于开发者。华为云码道代码智能体非常重视用户的隐私和数据安全，不会存储用户的代码 - [登录后显示没有模型](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0057.md): 已经配置了AK/SK认证，但是打开CodeArts Agent CLI时，没有可用的大语言模型。您可能没有开通套餐。如果出现“您好，您尚未获得此功能的访问权限，如想继续使用请前往购买套餐”，表示您尚未开通任何套餐，没有码道CLI的使用权限。请您进入华为云码道（CodeArts）代码智能体购买页，根据您的需要开通套餐。开通套餐后，重新打开C - [输入“codearts”回车后，打开了码道IDE](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0018.md): 在码道CLI中输入“codearts”后回车，打开了华为云码道代码智能体IDE工具。旧版本码道IDE安装目录中的“codearts”与“codearts.cmd”文件，与码道CLI安装路径下的同名文件发生冲突。此解决方案以Windows系统为例。其中，“codearts-agent”和“codearts-agent.cmd”文件为新版本文 - [卸载码道CLI](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0027.md): 根据提示删除残留的安装二进制包目录“installers”文件夹，即可实现完全卸载。 - [安装成功后，输入codearts命令后报错无法将“codearts”项识别为cmdlet、函数、脚本文件或可运行程序的名称](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0051.md): 安装完成后，输入“codearts”回车后，返回报错“codearts：无法将“codearts”项识别为cmdlet、函数、脚本文件或可运行程序的名称。”Windows修改环境变量后，已经运行的进程（包括桌面资源管理器explorer.exe）并不会自动刷新已有的环境变量，使用已经运行的进程开启的CMD或者PowerShell不会包含新 - [配置代理](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0052.md): 如果出现以下任意场景，表示您没有配置代理：执行任务时，返回报错“Access error. Please check the network or proxy.”在TUI开发模式下，初次启动加载超过10秒，无法加载出模型列表。如果您已经完成授权，但是您处于企业内网，那么您需要配置代理。请根据您的操作系统，选择对应的解决方案。http_pr - [外部内容无法粘贴至TUI模式的对话输入框](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0053.md): 无法将外部内容粘贴到TUI开发模式的对话输入框。您的操作系统是Windows 10 (x64)。本案例以CMD界面为示例。从外部复制“测试”粘贴到对话输入框。如果上述方案仍不能解决问题，请提交工单获取华为云的客户服务支持。 - [Nginx反向代理配置实现HTTPS访问](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0054.md): 采用Nginx反向代理部署HTTPS，可以满足安全访问要求。您可以按照如下步骤完成反向代理配置：配置示例如下：events { worker_connections 1024; # 指定每个工作进程可以同时处理的最大连接数 } http { # HTTPS server server { lis - [LSP服务不可用](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0064.md): 启动本地LSP功能后，调用LSP相关工具，智能体提示“LSP服务当前不可用”。LSP服务器未下载成功。当日志中出现failed to install时，表示对应语言的LSP服务器未能成功下载或安装。请按以下步骤进行排查和手动修复。定位日志文件。在日志目录下，找到以kernel-codeartsdoer-incognito开头的.log文件 - [命令无法正常执行，提示是否信任此文件夹](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0056.md): 在码道CLI中，执行某条命令时提示您是否信任该文件夹。码道CLI开启了受限使用模式，即%USERPROFILE%/.codeartsdoer/cli-data/settings.json配置文件中，enabled参数的值被设置成了true（默认为false）。按以下步骤操作，即可信任整个目录（D:\CLI01）及其所有子目录和工作区文件。 - [登录后显示没有模型](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0057.md): 已经配置了AK/SK认证，但是打开CodeArts Agent CLI时，没有可用的大语言模型。您可能没有开通套餐。如果出现“您好，您尚未获得此功能的访问权限，如想继续使用请前往购买套餐”，表示您尚未开通任何套餐，没有码道CLI的使用权限。请您进入华为云码道（CodeArts）代码智能体购买页，根据您的需要开通套餐。开通套餐后，重新打开C - [输入“codearts”回车后，打开了码道IDE](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0018.md): 在码道CLI中输入“codearts”后回车，打开了华为云码道代码智能体IDE工具。旧版本码道IDE安装目录中的“codearts”与“codearts.cmd”文件，与码道CLI安装路径下的同名文件发生冲突。此解决方案以Windows系统为例。其中，“codearts-agent”和“codearts-agent.cmd”文件为新版本文 - [卸载码道CLI](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0027.md): 根据提示删除残留的安装二进制包目录“installers”文件夹，即可实现完全卸载。 - [安装成功后，输入codearts命令后报错无法将“codearts”项识别为cmdlet、函数、脚本文件或可运行程序的名称](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0051.md): 安装完成后，输入“codearts”回车后，返回报错“codearts：无法将“codearts”项识别为cmdlet、函数、脚本文件或可运行程序的名称。”Windows修改环境变量后，已经运行的进程（包括桌面资源管理器explorer.exe）并不会自动刷新已有的环境变量，使用已经运行的进程开启的CMD或者PowerShell不会包含新 - [配置代理](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0052.md): 如果出现以下任意场景，表示您没有配置代理：执行任务时，返回报错“Access error. Please check the network or proxy.”在TUI开发模式下，初次启动加载超过10秒，无法加载出模型列表。如果您已经完成授权，但是您处于企业内网，那么您需要配置代理。请根据您的操作系统，选择对应的解决方案。http_pr - [外部内容无法粘贴至TUI模式的对话输入框](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0053.md): 无法将外部内容粘贴到TUI开发模式的对话输入框。您的操作系统是Windows 10 (x64)。本案例以CMD界面为示例。从外部复制“测试”粘贴到对话输入框。如果上述方案仍不能解决问题，请提交工单获取华为云的客户服务支持。 - [Nginx反向代理配置实现HTTPS访问](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0054.md): 采用Nginx反向代理部署HTTPS，可以满足安全访问要求。您可以按照如下步骤完成反向代理配置：配置示例如下：events { worker_connections 1024; # 指定每个工作进程可以同时处理的最大连接数 } http { # HTTPS server server { lis - [LSP服务不可用](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0064.md): 启动本地LSP功能后，调用LSP相关工具，智能体提示“LSP服务当前不可用”。LSP服务器未下载成功。当日志中出现failed to install时，表示对应语言的LSP服务器未能成功下载或安装。请按以下步骤进行排查和手动修复。定位日志文件。在日志目录下，找到以kernel-codeartsdoer-incognito开头的.log文件 - [命令无法正常执行，提示是否信任此文件夹](https://support.huaweicloud.com/codeartsagent_faq/codeartsagent_faq_0056.md): 在码道CLI中，执行某条命令时提示您是否信任该文件夹。码道CLI开启了受限使用模式，即%USERPROFILE%/.codeartsdoer/cli-data/settings.json配置文件中，enabled参数的值被设置成了true（默认为false）。按以下步骤操作，即可信任整个目录（D:\CLI01）及其所有子目录和工作区文件。 ## 活动 - [限时领取Tokens](https://support.huaweicloud.com/offers-codeartsagent/codeartsagent_offers_0001.md): 你可限时参与福利活动领取Tokens：每位用户每日可领取1000万Tokens。福利Tokens将于当日24:00清零，不累积至次日。适用人群：所有用户开始时间：2026年8月19日 22:00（UTC+8）结束时间：另行通知领取入口：华为云码道代码智能体IDE、JetBrains系列插件、Visual Studio Code插件均可领取