Skip to Content
Step Plan接入指南Claude Code 接入指南

Claude Code 接入指南

Claude Code 是一个运行在终端中的 AI 编码助手，可以通过自然语言命令完成代码生成、调试、重构和工程管理等任务。通过配置 API 接口，Claude Code 可以将模型调用请求转发到自定义 AI 服务。

本文档介绍如何在 Claude Code 中完成 Step API 的接入配置，并验证模型是否可用。

概述

Claude Code 适合偏终端工作流的开发者。完成配置后，可以直接在本地项目中通过自然语言驱动编码任务。

前置条件

操作系统

Claude Code 支持以下系统：

  • macOS
  • Linux
  • Windows（建议使用 PowerShell 或 Windows Terminal）

Node.js 环境

Claude Code 依赖 Node.js 运行，建议安装 Node.js >= 18。

不同系统的安装方式示例：

  • macOS：使用 Homebrew 或 nvm
  • Linux：使用系统包管理器或 nvm
  • Windows：使用 Node 官方安装包或 Chocolatey

示例命令：

brew install node
nvm install 18
sudo apt install nodejs npm
choco install nodejs

安装完成后，运行以下命令确认环境：

node -v
npm -v

订阅 Step Plan

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

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

获取 Step API Key

在调用模型前，需要先在 Step 开放平台 获取 API Key。建议通过控制台创建新的 Key，并避免将其硬编码进代码仓库。

推荐做法：

  • 使用环境变量保存 Key
  • 或通过本地配置文件管理 Key

配置步骤

安装 Claude Code

在终端中执行：

npm install -g @anthropic-ai/claude-code

安装完成后，验证版本：

claude --version

创建配置文件

Claude Code 通过配置文件读取 API 服务地址和认证信息。配置文件位置为：

~/.claude/settings.json

如果文件不存在，可以先创建目录和文件：

mkdir -p ~/.claude
touch ~/.claude/settings.json

将以下内容写入配置文件：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.stepfun.com/step_plan"
  },
  "model": "step-3.5-flash"
}

参数说明：

  • ANTHROPIC_API_KEY：填写你的 Step API Key
  • ANTHROPIC_BASE_URL：填写 Base URL
  • model：填写 step-3.5-flash

保存后，建议重新打开终端使配置生效。

启动 Claude Code

进入任意代码项目目录：

cd your-project

启动 Claude Code：

claude

首次启动时若出现 Do you want to use this API key?，选择 Yes 即可。

测试接入

进入 Claude Code 后，先执行以下命令查看当前配置状态：

/status

确认以下信息正确：

  • API Key 已加载
  • Base URL 正确（https://api.stepfun.com/step_plan）
  • 默认模型名称正确（step-3.5-flash）

随后执行测试指令：

write a minimal python hello world program into hello.py

如果 Claude Code 成功创建文件并写入代码，则说明模型接入成功。

常见问题

模型不存在

报错示例：

model does not exist

可能原因：

  • 模型名称填写错误（应为 step-3.5-flash）
  • 当前账号没有该模型权限
  • Base URL 指向错误接口（应为 https://api.stepfun.com/step_plan）

API Key 无效

报错示例：

401 invalid_api_key

可能原因：

  • API Key 输入错误
  • Key 已过期或被删除
  • Key 与当前 API 域名不匹配

配额不足

报错示例：

402 quota_exceeded

这通常表示当前账户调用额度已用完，需要补充余额或升级套餐。

修改配置后不生效

建议检查：

  1. Claude Code 是否已完全重启。
  2. 配置文件 JSON 格式是否正确。
  3. 终端环境变量是否已经刷新。

总结

完成配置后，Claude Code 即可在终端中通过 Step API 发起模型调用，用于代码生成、调试和开发流程自动化。建议先用 /status 和最小任务验证配置，再进入真实项目使用。

Last updated on
OpenClaw 接入指南Open Code 接入指南