必须先在agent space控制台确认工作空间已启用claude code服务并显示【ready（claude code v3.5.2）】，否则自然语言编程指令将被静默丢弃；随后通过ctrl+shift+p输入“claude start”启动tui界面，即可用英文描述任务执行编码、重构或调试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Agent Space云端工作空间中使用Claude Code，必须绕过本地CLI安装路径，直接在预置容器环境中调用其核心Agent能力——因为Agent Space本身已集成Claude Code运行时，无需额外部署Node.js或配置API Key。
确认工作空间已启用Claude Code服务
进入Agent Space控制台→左侧导航栏点击「工作空间」→选择目标空间→查看右上角状态标签。若显示【Ready（Claude Code v3.5.2）】，说明服务已就绪；若为“Initializing”或“Disabled”，需等待3–5分钟或联系管理员开启AI Agent模块。
这一步不可跳过：未激活Claude Code服务的空间无法响应任何自然语言编程指令，所有后续输入将被静默丢弃。
启动Claude Code交互会话
在工作空间文件浏览器中，任意目录下按快捷键 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）→ 输入“claude start”→ 回车。
终端将自动加载Claude Code TUI界面，并显示当前项目结构摘要。此时光标处于输入框，可直接用英文描述任务，例如：“add a /health endpoint to express.js server”。
注意：首次启动时会自动拉取最新Skill模板缓存，耗时约8–12秒，期间界面无响应属正常现象，勿重复触发命令。
执行跨文件重构任务
方法一：用自然语言指定范围
输入“refactor auth logic from src/utils/auth.js into a new src/services/auth.service.ts, update all imports, then run npm test”→ 按Tab键批准工具调用→ 等待AI自动完成读取、编辑、保存、测试全流程。
方法二：手动限定上下文
先执行claude context add src/utils/auth.js src/config/index.ts→ 再输入“extract token validation into reusable function with JSDoc”→ Tab确认。此方式避免AI误改无关文件，适合高风险重构。
【关键前提】工作空间必须已提交Git初始提交（git commit -m "init"），否则Claude Code无法建立文件变更追踪，所有修改将丢失且不生成diff预览。
调试报错并自动修复
第一步：复制终端中完整的错误堆栈（含文件路径、行号、错误类型）
第二步：在Claude Code输入框粘贴该堆栈，末尾加一句“explain and fix”
第三步：Tab确认后，AI将定位问题根源→ 修改代码→ 插入console.log验证点→ 重新运行相关测试
这一步操作起来很简单，但必须确保堆栈里包含至少一个真实文件路径。纯语法错误（如Missing semicolon）可被直接修复；而涉及环境变量缺失或网络超时的错误，AI会明确提示需要人工介入配置。
