Claude Code 使用指南

这份指南适合已经连接 AASC、准备开始实际任务的中文用户。先读懂项目，再说明要改什么；每次完成一小步，用真实检查结果判断是否完成。

资料核对日期：2026 年 10 月 31 日。文中的任务和规则模板是 xclaude 整理的示例；工具能力依据文末官方资料，实际可用命令、权限和模型以你的会话为准。

按需要阅读：第一次使用 · 任务流程 · 项目规则 · 验收与交付 · 问题排查。

先分清你正在使用什么#

• xclaude：提供约定的代理接入、配置指导与中文使用支持。工具、额度、有效期和费用在开通前确认。
• AASC：你使用的客户端或服务界面，用于查看和操作会话。客户端下载及服务运行方式见下载 AASC。
• Claude Code：会读取项目、修改文件并运行工具的编程助手。它操作的是会话所在运行环境中的文件，可能是你的电脑，也可能是约定的远程环境。

手机上看到对话，不代表项目文件已经保存在手机上。第一次开始时，先确认“正在操作哪台设备、哪个项目目录、文件怎么取回”。连接地址和权限不清楚时，先向客服确认。

第一次使用的五个步骤#

1. 确认接入信息。 已开通用户使用客服提供的 AASC 版本、连接地址和配置说明。自建用户先完成快速开始中的安装与配置。
2. 确认项目和文件位置。 在有权操作的运行环境中打开目标项目，检查已有修改，保留可恢复的版本。不要让多个会话同时修改同一批文件。
3. 进入 Claude Code 会话。 通过当前 AASC 的会话入口进入；需要新建终端会话时，参照终端与 SSH。网站下载页只提供 AASC，接入所需依赖按你的实际环境配置。
4. 先做一次小任务。 可以先让它解释项目入口、定位一个按钮，或修正一处文案。先熟悉查看变更、权限提示和检查结果的位置。
5. 确认结果再继续。 打开改动后的页面或文件，核对效果，并保存需要的记录。完成这一步后再增加任务范围。

可以直接用下面这段作为第一次提问：

先帮我了解当前项目，暂时不要修改文件。
请确认当前工作目录，说明项目的主要用途和启动入口。
找出与登录页面有关的文件，以及项目现有的检查方式。
如果还有未提交的修改，请先说明，不要覆盖。
最后建议一个适合第一次尝试的小任务。

一次任务怎样推进#

下面是建议的日常工作顺序。修改错别字等小任务可以直接完成；涉及多个文件、不熟悉的逻辑或不明确的需求时，先确认方案。

1. 说明目标。 写出希望用户最终看到的结果，以及什么情况算完成。
2. 核对项目。 让 Claude Code 找到相关文件、读取现有约定，并检查当前状态。
3. 确认方案。 明确修改范围、暂不处理的内容和验证方式；复杂任务可以使用计划模式。
4. 小步修改。 一次处理一个明确问题。出现超出范围的需求时，先重新确认。
5. 运行检查。 使用项目已有的测试、构建或实际操作检查；失败时根据错误修复，再重新检查。
6. 确认交付。 查看差异和结果，确认文件保存位置。需要提交、推送或上线时，明确目标与执行范围。

把需求写成可以检查的任务#

一段好用的需求通常包含五项信息：目标、当前情况、修改范围、限制、验收标准。能提供相关文件路径、复现步骤或脱敏截图时，一并给出。不要一次粘贴整个项目或大量无关日志。

下面是示例任务，页面名称和检查方式需要按你的项目替换：

目标：让手机用户更容易找到登录按钮。
当前情况：390 像素宽的页面上，登录按钮被挤到了第二行。
修改范围：只处理登录页的布局，保留现有登录逻辑。
限制：不要添加依赖，不改其他页面，不提交或发布。
验收标准：320 和 390 像素宽度没有横向滚动；按钮能点击；原有登录流程仍可用。
请先定位原因，说明准备修改哪些文件，再按确认的方案完成并验证。

遇到报错时，把“帮我修一下”换成可复现的信息：

操作：打开订单详情，点击导出。
期望：下载当前订单的文件。
实际：出现“导出失败”，重复三次都能复现。
范围：只排查导出流程。
补充：我会提供脱敏后的错误信息和相关截图。
请先定位失败在哪一步，不要先重写整个模块。

确认方向后，可以直接继续：“按刚才确认的范围修改，完成后列出改动、运行过的检查和仍未验证的部分。”无需每轮重复全部背景，但任务范围改变时要说清楚。

项目规则应该怎么写#

CLAUDE.md 适合记录这个项目会反复用到的信息，例如约定、检查命令和不能从源码直接看出的限制。保持简短、具体；一次任务的临时要求放在对话中，详细操作手册放在单独文档中。

• 项目规则通常放在项目根目录的 CLAUDE.md，或 .claude/CLAUDE.md。
• 个人通用偏好可放在 ~/.claude/CLAUDE.md，会影响多个项目，不要把单个客户项目的要求随意写进去。
• 特定目录的约定可使用 .claude/rules/ 中按路径限定的规则；先确认当前版本的支持方式。

以下是规则内容示例，不会自动应用到你的项目。先核对现有规则，再合并需要的部分，不要直接覆盖原文件：

项目说明：这是面向中文用户的网站；品牌名为 xclaude。
沟通方式：用中文说明结果。信息不确定时，先检查来源，不猜测。
修改范围：围绕当前任务修改，保留已有功能和无关的本地改动。
开始之前：阅读相关文件和现有约定，确认工作目录。
验证方式：使用本项目实际存在的检查命令；界面改动还要检查目标尺寸。
异常处理：先定位错误原因；重复失败时停下来总结证据，不连续猜测修改。
敏感信息：不把密码、密钥或私人数据写入输出和提交。
交付说明：说明改了什么、如何验证、哪些还没有验证。
发布范围：提交、推送、部署和对外发送，按用户明确指定的范围执行。

再补上项目真实可运行的启动和检查命令。例如，先读取项目脚本，再记录对应命令；不要把示例中的命令当成每个项目都存在。

Claude Code 提供 /init 协助生成初始项目说明，/memory 用于查看和管理记忆与指令文件。生成后仍需你检查内容；已有文件应保留有效约定。路径和加载方式以官方记忆与项目规则文档为准。

任务说明、规则、技能和权限各管什么#

这些机制解决的问题不同，可以一起使用：

• 任务消息：说明这一次要完成什么，例如“只修复这个按钮”。任务结束后，不必把所有细节写成长期规则。
• CLAUDE.md：提供持续适用的项目背景与约定，例如语言、目录含义、检查命令。
• 技能（Skills）：保存可重复使用的操作步骤，例如团队的文档整理流程。按任务需要使用，不必把全部流程塞进项目说明。
• 权限与沙箱：控制工具调用和访问边界。权限决定什么操作被允许或需要确认；沙箱限制受其约束的进程可以访问哪些资源。
• 钩子（Hooks）：在指定事件触发时执行已配置的操作或检查。适合需要固定触发的检查，但仍要正确配置、测试和维护。

CLAUDE.md 和技能中的自然语言会影响模型行为，但不是强制执行的访问控制。写一句“不要读取密钥”不等于技术上禁止读取；需要限制访问时，应配置相应的权限和运行环境。参考官方最佳实践与权限配置。

实际使用时，先确认当前会话采用什么权限模式。看到授权提示，核对它要操作的文件、运行的命令和访问的目标。不清楚的操作先让它解释；不要为了省去提示直接放开全部权限。模式名称、可用选项和默认值可能因版本、模型或组织设置不同，按当前会话显示为准。

让长任务更容易继续#

一个会话围绕一个主要目标推进。相关文件、明确的错误信息和验收标准，比重复粘贴大量背景更有用。

任务较长时，让 Claude Code 把当前进度写成一段交接说明，至少包含：已确认目标、已完成修改、关键文件、检查结果、未解决问题、下一步。随后核对说明有没有漏掉限制条件。

Claude Code 会在上下文接近限制时进行压缩，也提供 /compact 主动整理当前对话。压缩后的摘要不是完整原文备份；需要长期保留的决定和项目知识，应放在合适的项目文件里。换一个无关任务时，使用新会话；继续旧任务时，恢复对应会话并先核对文件现状。见官方上下文说明。

先学会这几个会话命令#

这些命令输入在 Claude Code 会话中，不是 AASC 的下载或安装命令。在输入框输入 / 可查看当前环境的菜单；命令需放在消息开头。某些功能受版本、平台、套餐和配置影响。

• /help：查看帮助；不确定快捷键或命令时先看这里。
• /plan：进入计划模式，适合需要先分析范围的大改动。
• /permissions：查看和调整权限；修改前先理解影响范围。
• /memory：查看和管理项目指令、记忆。
• /context：查看上下文占用，定位过多的背景内容。
• /compact：压缩当前对话，继续同一件事。
• /resume：恢复之前的会话，继续前先检查项目是否已有新改动。
• /diff：查看当前变更，交付前核对是否超出范围。

完整列表及可用条件见官方命令参考。如果当前 AASC 会话不提供某项入口，使用自然语言说明目标，或向客服确认支持范围；不要反复输入不存在的命令。

怎样判断任务确实完成#

不要只看一句“已完成”。要求它给出你能核对的结果：

1. 改动对应目标。 列出修改的文件或页面，并说明每处改动解决什么问题。
2. 检查真实执行。 说明运行了哪些检查、结果如何；没有执行或被环境阻塞的检查要明确写出。
3. 实际操作可用。 界面任务打开目标页面，检查所需尺寸和交互；接口或数据任务核对代表性输入、输出和错误情况。
4. 原有功能仍可用。 检查与改动相关的旧流程，避免新效果破坏既有行为。
5. 文件可以找回。 确认文件所在设备、目录和保存方式；远程环境中的文件按约定导出或同步。
6. 交付状态准确。 本地完成、已提交、已推送和已上线是不同状态。需要发布时，明确发布目标，并在发布后打开实际地址验证。

可使用这段收尾提示：

请按目标逐项核对结果。
说明修改了什么、运行了哪些检查、结果是什么。
把没有验证或仍存在的问题单独列出。
说明文件保存在哪里，以及目前是本地完成、已提交还是已经上线。
如果需要下一步操作，请写清具体动作和目标。

遇到问题时按哪一步排查#

结果不符合预期： 指出具体哪里不对，给出期望示例；先让它复述差异和准备修改的范围，再继续。不要只重复“再优化一下”。

总在改无关内容： 缩小到一个任务，明确相关文件和不处理的内容；让它先查看当前差异。如果多轮仍偏离，整理进度后重新开始一个聚焦的会话。

测试或构建失败： 保留失败命令和相关错误，区分代码问题、依赖问题和缺少环境配置。让它基于错误定位原因，不要为了让检查通过删除检查或掩盖报错。

长时间没有输出： 先查看会话是否仍在运行工具、等待授权或等待回答。不要连续发送相同任务，避免重复执行。需要停止时，使用当前界面的停止操作；之后核对已经发生的文件修改和仍在运行的任务。

AASC 连接失败： 核对地址、运行环境状态、网络和登录信息，参照连接问题排查。界面连接中断不代表账号已被封禁。

额度不足或账号受限： 先记录实际提示、发生时间和客户端版本，向客服核对套餐与接入状态。账号规则和申诉结果由对应平台决定，不要把网络失败、额度用完和账号限制混为一谈。

反馈截图和日志前，请遮住密码、密钥、完整配对链接及不需要提供的私人内容。

使用条件与资料来源#

以上流程帮助你明确需求、减少返工并核对结果，不承诺特定产出，也不保证上游账号永不受限。项目规则、AASC 接入和代理服务不会改变对应服务商的地区、账号及使用规则。购买前请阅读体验与购买说明。

以下是本页技术说明的官方依据；示例任务、规则模板和验收清单是 xclaude 整理的使用建议：

• Claude Code 最佳实践：项目上下文、可验证结果及不同控制机制。
• 项目规则与记忆：CLAUDE.md 的位置、用途和管理方式。
• 权限模式：计划模式、操作审批及可用条件。
• 权限配置：权限规则和沙箱的关系。
• 上下文窗口：长会话与压缩。
• 会话命令：命令含义及可用条件。
• 常见工作流程：理解项目、定位问题和推进任务。

准备开始时，可先查看 AASC 下载与服务运行方式；已连接用户可以从本页第一次提问示例开始。