Open Code 接入指南

Open Code 是一款运行在终端中的 AI Coding Agent，适合通过自然语言完成代码生成、代码修改和项目分析等开发任务。通过配置 Step API Key，Open Code 可以直接接入 Step 模型，在终端环境中调用推理能力完成开发流程。

本文档介绍 Open Code 接入 Step API 的准备条件、配置步骤与基础验证方法。

概述

Open Code 适合偏终端交互的开发工作流。完成 Provider 配置后，可以直接在终端中使用 Step 模型执行常见编码任务。

前置条件

开发环境

支持以下系统：

• macOS
• Linux

建议使用较新的系统版本和终端环境。

安装 Open Code

Open Code 可以通过 Homebrew 安装：

brew install anomalyco/tap/opencode

安装完成后，执行以下命令确认是否安装成功：

opencode --version

若返回版本号，则说明安装成功。启动 Open Code：

opencode

订阅 Step Plan

在开始配置前，请先确认当前账号已完成 Step Plan 订阅。只有在账号具备对应计划或调用权限后，后续模型调用与额度使用才会正常生效。

如需订阅或购买，请访问：platform.stepfun.com/step-plan 

获取 Step API Key

访问 Step 平台控制台 创建 API Key，并妥善保存：

配置步骤

添加 Provider

启动 Open Code：

opencode

随后按以下步骤操作：

1. 按 Ctrl + P 打开命令面板。
2. 在搜索框中输入 Add Provider。
3. 在 Provider 列表中选择 StepFun。
4. 按提示填写 Step API Key。

配置完成后，Open Code 即可调用 Step 模型。

选择模型

按 Ctrl + T 打开模型列表（Variants），选择推荐模型：

step-3.5-flash

选择成功后，终端底部会显示当前模型信息，例如：

Build
step-3.5-flash
StepFun

这表示当前 Open Code 会话已开始使用 Step 模型。

测试接入

完成配置后，可以执行一个简单任务进行验证，例如：

Create a hello world script in Python

若接入成功，模型通常会返回类似内容：

print("Hello, world!")

常见问题

Provider 未显示

如果在 Add Provider 列表中未找到 StepFun，请检查：

1. Open Code 是否为最新版本。
2. 当前网络环境是否正常。
3. 是否已完全重启 Open Code。

API Key 错误

如果出现以下报错：

401 Incorrect API key

请检查：

• Key 是否复制完整
• Key 是否属于正确环境（.ai / .com）

模型调用失败

如果模型无法返回结果，请检查：

1. API Key 是否有效。
2. 模型名称是否正确。

推荐模型：

step-3.5-flash

总结

完成 Provider 与模型配置后，Open Code 即可通过 Step API 在终端中执行代码生成、文件编辑和项目分析等任务。建议先用最小示例验证连通性，再继续补充你自己的终端开发工作流。