如何在 Agent.Space 使用 Claude Code：Workspace 实操指南

在 Agent.Space 使用 Claude Code，指的是让 Claude Code 这个 Agent harness 在持久化云端 Workspace 中运行。Claude Code 可以调查代码库、编辑文件、运行开发命令并验证结果；Workspace 则把项目文件、Session、受支持的 Preview 与明确的交接状态集中保存。

最稳妥的首次工作流是：创建或打开 Workspace，提供必要的项目上下文，选择 Claude Code 和兼容模型，先让它调查再编辑，最后用书面验收标准审查保存下来的证据。Claude Code Agent 页面是了解当前可用性和相关文章的 Hub。

这条路径是在 harness 周围加入 Agent.Space 的项目层。它不会复制 Anthropic 原生 Claude Code 的每个界面，也不会把 Agent.Space 套餐变成 Anthropic 订阅或 Console 余额。

产品事实核验于 2026-09-02。 Harness、模型、功能与套餐可用性都可能变化。依赖某个组合前，请检查 Agent.Space 线上选择器与 Anthropic 当前官方文档。

在 Agent.Space 使用 Claude Code 意味着什么

Anthropic 把 Claude Code 定义为能够读取代码库、编辑文件、运行命令并连接开发工具的 Agentic Coding 工具。在 Agent.Space 中，这个 harness 是更大项目边界中的一名参与者：

这些层级可以彼此独立地变化。选择另一个兼容模型，不会自动产生另一套 harness 工作方式；新建 Session 不会删除 Workspace 文件；加入另一个受支持 Agent 也不需要放弃当前 Workspace 或重新搭建项目上下文。

Agent.Space 产品架构解释了完整关系。对于本指南，核心只需要记住一句话：Claude Code 执行任务，Workspace 保存任务周围可以检查的项目状态。

什么时候适合选择这条 Claude Code 路径

当项目需要的不只是一段私有终端对话时，可以评估 Agent.Space 中的 Claude Code：

• 当前文件需要在多个工作时段之间持续保留；
• 团队成员需要从同一份项目状态检查或继续工作；
• 另一个受支持 Agent 可能在独立 Session 中审查结果；
• 受支持的 Preview 或产物需要与任务上下文放在一起；
• 这个工作负载更适合托管云端 Runtime。

如果某项能力只存在于当前 CLI、IDE、Desktop、Web、Mobile 或集成入口，应选择 Anthropic 原生 Claude Code。Anthropic 的平台指南列出了这些入口，也明确说明执行位置与交互界面会不同。如果组织必须直接运营完整 Runtime、网络与 Credential 边界，则使用自管环境。

选择应当跟着项目走：文件需要放在哪里、谁要审查、任务怎样恢复，以及真正需要哪项原生能力。

如果要具体比较 Anthropic harness 与 Cursor 的编辑器加 Agent 工作流，请查看 Claude Code 与 Cursor 怎么选。

五步启动 Claude Code Session

1. 为结果创建 Workspace

使用 计费迁移审查 或 文档搜索修复 这类项目名称，而不是 Claude 实验。如果后来加入团队成员或其他 Agent，一个长期有效的名字仍能说明这个 Workspace 的目标。

2. 加入 Brief 和必要文件

写清预期结果、权威来源、允许范围、禁止范围与验收标准，只加入让这些约束成立所需的文件。不要把 Credential 和无关私密材料写进 Prompt 或普通项目文件。

3. 选择 Claude Code

新建 Session，并把 Claude Code 选为 Agent harness。应把线上选择器当成当前可用性记录，而不是依赖一篇旧指南或内部版本号。

4. 单独选择兼容模型

从产品当前为 Claude Code 提供的模型中选择。一个模型出现在 API 目录里，不代表每个 harness 或界面都能使用它。如果需要比较或切换模型路径，同时避免把模型和 harness 混为一谈，可以查看 Claude Code 模型切换与 Hooks 指南。

如果你的账号能使用 Anthropic 当前的 Fable 路线，可继续查看在 Claude Code 中选择 Fable 5.1 并调整 Effort的原生 CLI 命令与访问检查。这项上游可用性不代表 Agent.Space 一定提供相同模型，仍需单独检查这里的实时选择器。

5. 先调查，再行动

给出一个边界清楚的修改或诊断任务。面对陌生仓库时，先让 Claude Code 定位相关代码、重述范围、说明不确定点并提出检查方案；确认边界后再允许它编辑。

使用“先计划、后执行”的任务合同

Anthropic 把 Claude Code 的 Agentic Loop 解释为收集上下文、采取行动和验证结果。下面的 Prompt 可以让这几个阶段更容易审查：

目标产出[具体且可观察的结果]。
权威上下文- 遵循[Brief、文件、Issue 或需求]。- 修改任何内容前先检查[相关范围]。
范围- 可以修改[文件或行为]。- 不要修改[受保护区域]。
计划检查点先总结当前行为、可能原因或方案、涉及文件和验证计划。如果需要产品或架构决定，请停下来等待确认。
验收检查- [测试、构建、Preview 状态或内容规则]- [第二项完成条件]
完成前列出修改过的文件、已运行和未运行的检查、假设与开放风险。

这并不表示每个任务都要做很长的规划。一行文案修改通常不需要。错误假设可能扩散到多个文件，或者最终产品/架构决定必须由真人做出时，这个检查点才特别有价值。

审查保存的证据，并准备下一 Session

Claude Code 的总结只能说明它认为发生了什么。还要检查实际项目状态：

1. 把输出与验收标准逐项对照。
2. 检查每个修改文件，留意范围是否扩大。
3. 如果是视觉结果，打开受支持的 Preview 或产物。
4. 阅读测试、构建、Lint、类型检查或其他相关输出。
5. 把通过的检查与跳过或无法运行的检查分开记录。
6. 写下假设、待决定事项和最安全的下一步。

如果要由团队成员或另一个 Agent 继续，请把这些信息写成可以检查的交接材料。下一任务属于其他 harness 时，应在同一 Workspace 中新建独立 Session。新 Session 可以检查当前文件和明确交接，但不会悄悄继承 Claude Code 的隐藏推理。

如果有用的上下文还在本地对话中，可以使用受控流程导入选定的 Claude Code 对话。导入的对话不会同时带来本地项目目录，因此编辑前要先把历史记录与 Workspace 文件重新对齐。

哪些仍然由 Anthropic 决定

Agent.Space 独立于 Anthropic。它不是 Claude 订阅、Console/API 余额、Anthropic 转售服务、共享登录、Claude Managed Agents 部署，也不是绕过 Anthropic 账号、支付、地区、自动化或使用规则的方式。

以下事项仍由 Anthropic 决定：

• Claude Code 的核心行为与原生界面；
• Claude 模型能力和上游功能资格；
• 订阅、Console/API、Cloud Provider 与认证规则；
• 只存在于 Anthropic CLI、IDE、Desktop、Web 或集成中的功能；
• 这些账号适用的 Anthropic 条款与数据控制。

例如，Anthropic 当前的认证指南为 Subscription OAuth、Console Credential 和受支持 Cloud Provider 规定了不同的所有权与优先级。让 Claude Code harness 在独立 Workspace 中运行，并不会合并这些产品或余额。

如果认证和账单归属才是主要问题，请阅读单独的 Claude Code 订阅、API 与托管 Workspace 对比。

一次安全的 Claude Code 首次运行

扩大范围前，先确认一条端到端链路：

• 选择： Claude Code 和需要的兼容模型出现在当前线上产品中。
• 范围： 任务明确说明了允许和禁止修改的内容。
• 检查点： 主观产品或架构选择会回到真人决定。
• 证据： 已保存文件和相关检查支持完成结论。
• 恢复： 修改足够小，能够继续调整或撤销。
• 连续性： 另一个参与者能从文件与书面交接理解当前状态。

当结果可以检查、不确定性已经写明，而且下一步不依赖重建一段私有对话时，第一次运行才算完成。在此基础成立后，再加入更多文件、更长任务、其他 Agent 或团队成员。