跳转到主要内容
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 订阅。只有在账号具备对应计划或调用权限后，后续模型调用与额度使用才会正常生效。 如需订阅或购买，请访问：Step Plan 订阅

​
获取 Step API Key

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

​
配置步骤

​
添加环境变量

打开系统终端（Terminal.app 或 iTerm2），在任意目录下运行以下命令（~/.zshrc 是固定路径，跟当前目录无关）： 
echo 'export OPENAI_API_KEY="xxxxxx"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://api.stepfun.com/step_plan/v1"' >> ~/.zshrc
source ~/.zshrc
其中 xxxxxx 替换为你在控制台创建的 Step API Key。运行完 source ~/.zshrc 后，后续每次启动终端都会自动加载这些变量，无需重复运行。

​
验证环境变量

执行以下命令，确认变量已正确写入： 
echo $OPENAI_API_KEY
echo $OPENAI_BASE_URL
若分别输出你的 API Key 和 https://api.stepfun.com/step_plan/v1，则说明配置成功。

​
选择模型

启动 Open Code： 
opencode
按 Ctrl + T 打开模型列表（Variants），选择推荐模型： 
<model_id>
说明：本文示例中的 <model_id> 可填写为 step-3.5-flash-2603 或 step-3.5-flash。
选择成功后，终端底部会显示当前模型信息，例如： 
Build
<model_id>
StepFun
这表示当前 Open Code 会话已开始使用 Step 模型。

​
测试接入

完成配置后，可以执行一个简单任务进行验证，例如： 
Create a hello world script in Python
若接入成功，模型通常会返回类似内容： 
print("Hello, world!")

​
常见问题

​
Provider 未显示

如果在模型列表中未找到 StepFun 相关模型，请检查：
  1. Open Code 是否为最新版本。
  2. 当前网络环境是否正常。
  3. 环境变量是否已正确写入（执行 echo $OPENAI_BASE_URL 验证）。
  4. 是否已完全重启终端后再启动 Open Code。

​
API Key 错误

如果出现以下报错： 
401 Incorrect API key
请检查：
  • Key 是否复制完整
  • Key 是否属于正确环境（.ai / .com）

​
模型调用失败

如果模型无法返回结果，请检查：
  1. API Key 是否有效。
  2. 模型名称是否正确。
推荐模型： 
<model_id>

​
总结

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