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

这篇指南介绍在 Agent.Space 云端 Workspace 中运行 Claude Code 的流程。它不是唯一的接入方式：想继续用你 Mac 上已登录的 Claude Code，可以用 Agent.Space Mac App 把这台 Mac 连接到 Workspace；想在本地客户端里使用 Agent.Space 的模型，可以用 Agent.Space Developer API。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 是更大项目边界中的一名参与者：

层级	在这套工作流中的职责
模型	提供底层推理与生成能力。
Claude Code harness	组织上下文收集、工具、权限、编辑、命令与验证。
Session	承载一个持续进行的 Claude Code 任务和可见对话。
Workspace	集中保存成员、Session、项目文件、Preview 与明确的交接状态。

这些层级可以彼此独立地变化。选择另一个兼容模型，不会自动产生另一套 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 桌面、CLI 与网页的区别。

云端 Workspace 和本地 Claude Code 怎么选？

需求	更相关的路径	不会自动发生什么
在 Workspace 里使用你 Mac 上已登录的 Claude Code	安装 Agent.Space Mac App，把这台 Mac 连接到 Workspace	不经你允许，Workspace 成员用不了你 Mac 上的 Claude Code 和订阅；Mac 睡眠时任务会暂停
在本地 Claude Code 里使用 Agent.Space 模型	在 Developer API 页面生成受支持的 Claude Code 客户端配置	配置 API 不会把仓库或原有对话搬进云端
在云端保存项目、Session 和交接材料	按下文创建 Workspace 并启动 Claude Code	云端项目不会自动继承本地客户端的权限、登录态或历史

走 Mac App 路线时，那台 Mac 上的 Claude Code 需要已经登录。在上面发起的 Session 使用这份登录和订阅额度，不消耗 Agent.Space 积分。

走 API 路线请跟随 Agent.Space Developer API 接入指南，从实时页面取得当前模型与配置。更改前备份现有配置，不要把 API Key 放入仓库或聊天正文。先验证一次小请求的响应和记录，再让客户端执行有副作用的任务。

费用应按所选模型和通道判断，而不是只看 harness 名称。选择 Claude Code harness 不代表取得 Claude Pro、Max 或 Anthropic API 余额；也不能因为账户有 Codex Dedicated 套餐，就假设 Claude 模型调用包含在内。当前适用套餐额度用完后会自动转为按量扣除积分；套餐外调用也按量计费。请先核对套餐与积分规则，不要把“有套餐”当成不会发生额外消费。

这部分本地接入与资金说明核对于 2026 年 10 月 10 日的公开产品说明、Mac App 和 Developer API 页面，不是已完成的付费账户调用测试。下文继续介绍云端 Workspace 流程。

如果用量记到了非预期账号，先按Claude Code API 扣费排查步骤检查认证环境，不要急着继续充值。

五步启动 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 一定提供相同模型，仍需单独检查这里的实时选择器。

如果准备尝试较新的 Opus 路线，Opus 5.5 设置与首次运行清单会分别检查客户端版本、模型选择与任务验收，帮助你在修改可工作的默认配置前做好准备。

5. 先调查，再行动

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

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

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

text

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

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

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

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

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

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

如果要由团队成员或另一个 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 对比。

使用 Anthropic 原生会话控制功能时，先核对 Remote Control 的账号与主机要求，其资格与 Agent.Space 分开。

如果 Claude Code 提示未登录或登录过期，应先确认实际凭据，再决定是否调整工作方式。登录过期排查指南区分了账号认证、容量和计费；换一个工作区不会修复原生账号。

一次安全的 Claude Code 首次运行

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

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

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

如果想从具体任务入手，可以先按接手已有代码库的流程定位代码，再做可运行的 Bug 修复练习。若遇到账号停用通知，请查看独立的封号反馈与恢复指南。