企业官网建设流程全解析

Step Code 是一款运行在终端的 AI 编程智能体工具。如果你正计划从 Claude Code 迁移到 Step Code，最大的惊喜是：整个过程几乎零配置成本——你的 MCP 服务器配置、Claude Code 插件、以及项目里的CLAUDE.md指南都会被自动识别或直接沿用，无需手动搬运。

下面这套 5 步迁移教程，带你从安装到验证完整走一遍，预计 10 分钟即可完成全部迁移。

一、为什么 Step Code 对迁移友好？

在动手之前，先了解 Step Code 为你内置的三块"兼容地基"（来自 README.md 的 Migrate from other agents 章节）：

这得益于 Step Code 在源码层面为兼容做了专门设计，核心实现在 mcp-import.ts 中。

二、第一步：一键安装 Step Code

打开终端，按平台选择官方安装脚本即可。安装程序会下载最新 Release、校验完整性、把step装到~/.stepcode/bin并更新 PATH。

macOS / Linux / WSL

curl -fsSL https://static-openapi.stepfun.com/stepcode/install.sh | bash

Windows（PowerShell）

irm https://static-openapi.stepfun.com/stepcode/install.ps1 | iex

💡 Windows 原生支持目前为 beta，官方推荐在 WSL 中安装。

重开终端后验证：

step --version

以后升级只需一条命令：step update。

三、第二步：登录 Step 账号

Step Code 默认内置Step (StepFun)模型提供方。支持两种计费方式：

• Step Plan 订阅（Mini / Plus / Pro / Max 套餐）：浏览器 OAuth 登录，凭证自动刷新
• Step Platform API Key：按请求计费，在开发者平台创建 Key 即可

登录方式任选其一：

step login # 终端登录

或在 TUI 内输入/login。登录后用/model切换可用模型，/status查看当前会话状态。

四、第三步：MCP 服务器配置自动导入（核心亮点）

这是迁移中最省事的一步。Step Code首次启动时会自动扫描：

• Claude Code 的~/.claude.json
• Codex 的~/.codex/config.toml

然后弹出一个一次性选择界面，列出所有可导入的 MCP 服务器，勾选后写入你自己的~/.stepcode/config.toml。整个过程有三个值得放心的设计：

1. 源文件只读：~/.claude.json不会被写入、重命名或删除，Claude Code 可以继续安全使用；
2. 幂等可重复：每个来源只询问一次，重复启动不会反复打扰；
3. 密钥不落盘：Codex 中的bearer_token_env_var等只复制环境变量名，绝不把真实 Token 内联进配置文件。

⚠️两个迁移注意点：

• Step Code 支持stdio和http (Streamable HTTP)两种传输；Claude Code 的sse/ws类型服务器会明确提示"不支持"，需要你手动配置；
• Claude Code 中projects[...].mcpServers下按项目目录划分的"local scope"服务器不会被导入（作用域规则不同），界面会给出数量提示，这类服务器需手动补配。

导入逻辑与提示界面分别实现在 mcp-import.ts 和 mcp-import-prompt.ts，行为细节可查阅对应的 mcp-import.test.ts 测试文件。

五、第四步：CLAUDE.md 与插件零改动沿用

项目指南：CLAUDE.md直接生效

Step Code 加载项目上下文文件时，候选列表本身就包含CLAUDE.md（见 resource-loader.ts）：

查找顺序：AGENTS.override.md→AGENTS.md→CLAUDE.md

也就是说你项目里已有的CLAUDE.md一个字都不用改，Step Code 会原样读取。如果想统一为AGENTS.md，在 TUI 中运行/init即可生成等价文件。

插件：.claude-plugin/plugin.json直接识别

Step Code 的插件系统会主动查找 Claude Code 风格的清单文件.claude-plugin/plugin.json（见 plugins.ts），并自动完成字段归一化：

• 把 Claude 的name字段映射为 Step 的id；
• 自动探测插件目录下的skills/、commands/、agents/目录；
• 兼容根目录的.mcp.json声明。

用/plugin命令即可浏览、安装和管理这些插件。

六、第五步：迁移验证与常用命令速查

迁移完成后，在任意项目目录执行step启动 TUI，输入一句任务即可验证。建议按此清单快速核对：

此外，/import命令支持从 JSONL 文件导入并恢复会话，适合迁移历史对话记录。

七、迁移中的常见问题

• Claude Code 还能继续用吗？可以。MCP 导入只读你的配置文件，两个工具可并行共存，随时切换。
• 导入界面错过了怎么办？设置环境变量STEP_MCP_IMPORT_ALWAYS=1可让导入界面在每次启动时重新出现。
• 想完全卸载 Step Code？删除~/.stepcode目录即可移除全部用户数据（配置、凭证、会话、日志）。
• 升级后需要重新登录吗？不需要。Step Code 启动时会自动修复旧版配置中过期的端点地址，详见 step-integration.md。

写在最后

从 Claude Code 迁移到 Step Code 的真实成本，比大多数人想象的低得多：一条安装命令、一次登录、一次 MCP 勾选，CLAUDE.md和插件则完全免动。得益于高 Token 效率、多智能体编排（/ultracode）和内置 StepPage 静态站发布能力，迁移完成后你获得的不仅是一个替代品，而是一套更省 Token、更擅长长任务的终端 AI 编程工作流。

📎相关模块索引：

• MCP 导入核心：mcp-import.ts
• 导入交互界面：mcp-import-prompt.ts
• 插件兼容层：plugins.ts
• 上下文文件加载：resource-loader.ts
• Step 集成与兼容性矩阵：step-integration.md