Skip to main content
Step Code 可以接入 Claude Code / Codex 的现有工作流：首次启动导入 MCP 配置，兼容 Claude Code 插件布局，现有 CLAUDE.md 直接生效。登录凭据需要重新配置。

​
迁移会发生什么

首次启动检测到本机 Claude Code 或 Codex 的 MCP 配置时，会显示导入界面。确认后，支持的服务器配置写入 ~/.stepcode/config.toml 的 [mcp_servers]。
  • 来源包括 ~/.claude.json 和 ~/.codex/config.toml。
  • 源文件只读，不移动、删除或覆盖原配置。
  • 每个来源只询问一次；重复内容不重复导入。
  • 同名但配置不同的服务器自动加 -claude / -codex 后缀。
  • 环境变量引用保留变量名，不将对应环境变量值展开写入配置。
  • 无法转换的字段会提示，导入后需检查结果。
目前支持 stdio 和 Streamable HTTP；SSE、WebSocket 传输及 IDE 注入的服务器不自动导入。Claude Code 项目级 mcpServers 需要手动配置。

​
MCP 配置自动导入

在交互界面使用 /mcp 检查连接状态和工具数。命令路径、环境变量和远程服务权限仍需在 Step Code 的运行环境中有效。 原工具与 Step Code 可以并存；导入并不意味着两份配置会持续同步。

​
直接使用 Claude Code 插件

Step Code 可读取 .claude-plugin/plugin.json，以及插件中的 .mcp.json、skills、commands 和 agents。市场清单兼容 .claude-plugin/marketplace.json。 给 Claude Code 编写的插件多数无需修改即可安装使用。安装方式见插件。

​
项目指引文件

当前目录到文件系统根的各级目录中，按以下顺序选择指引：
  1. AGENTS.override.md
  2. AGENTS.md
  3. CLAUDE.md
全局指引位于 ~/.stepcode/agent/AGENTS.md。现有 CLAUDE.md 可以继续使用，无需仅为文件名重新编写；请检查其中引用的工具、命令和路径是否仍适用。 修改后执行 /reload 或重启。--no-context-files 关闭自动发现，/init 可生成新的项目指引。

​
不迁移的内容

不要直接复制不明格式的凭据文件，也不要将包含密钥的配置提交到项目仓库。

​
下一步