> ## Documentation Index
> Fetch the complete documentation index at: https://platform.stepfun.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 从其他 Agent 迁移

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 配置自动导入

```bash theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
step mcp list
step mcp get <服务器名称>
```

在交互界面使用 `/mcp` 检查连接状态和工具数。命令路径、环境变量和远程服务权限仍需在 Step Code 的运行环境中有效。

原工具与 Step Code 可以并存；导入并不意味着两份配置会持续同步。

## 直接使用 Claude Code 插件

Step Code 可读取 `.claude-plugin/plugin.json`，以及插件中的 `.mcp.json`、`skills`、`commands` 和 `agents`。市场清单兼容 `.claude-plugin/marketplace.json`。

给 Claude Code 编写的插件多数无需修改即可安装使用。安装方式见[插件](/docs/zh/step-code/customization/plugins)。

## 项目指引文件

当前目录到文件系统根的各级目录中，按以下顺序选择指引：

1. `AGENTS.override.md`
2. `AGENTS.md`
3. `CLAUDE.md`

全局指引位于 `~/.stepcode/agent/AGENTS.md`。现有 `CLAUDE.md` 可以继续使用，无需仅为文件名重新编写；请检查其中引用的工具、命令和路径是否仍适用。

修改后执行 `/reload` 或重启。`--no-context-files` 关闭自动发现，`/init` 可生成新的项目指引。

## 不迁移的内容

| 内容             | 处理方式                     |
| -------------- | ------------------------ |
| 模型供应商 OAuth 凭据 | 重新执行 `/login`            |
| MCP OAuth 授权   | 执行 `step mcp login <名称>` |
| 源工具项目级 MCP 配置  | 按需手动添加                   |

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

## 下一步

* [快速开始](/docs/zh/step-code/quickstart)
* [MCP](/docs/zh/step-code/customization/mcp)
* [插件](/docs/zh/step-code/customization/plugins)