>本文介绍如何在 Claude Code 中通过 Messages API 接入 Step 模型，配置 Step Plan、推理强度与 1M 上下文，并验证对话和工具调用。
> **更新日期**：2026-10-28 | **适用模型**：Step 5 Preview | **API 端点**：`https://api.stepfun.com/step_plan/v1/messages`


# 前期准备#
## 运行环境要求

- macOS、Linux 或 Windows。（Windows 可使用 PowerShell，也可在 WSL 中运行。）
- 本文采用 npm 安装方式，需要 Node.js 22 或更高版本；已使用原生安装包安装 Claude Code 的用户可跳过 npm 安装。

## 套餐订阅状态确认
- 确认 **Step Plan 订阅有效、额度可用**，且具备所用模型的调用权限。本文配置示例使用 Step Plan 通道。
- 前往 **Step 开放平台密钥管理页面** 创建 API Key。
使用 npm 安装前，确认 `Node.js` 与 `npm` 可用：
```
node -v
npm -v
```


# 配置步骤
## 安装 Claude Code

在终端执行：

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

安装完成后，验证版本：

```bash
claude --version
```

> 兼容性验证版本为 **Claude Code 2.1.209**。安装命令获取最新版，模型别名解析和上下文管理可能因版本不同而变化。 Claude Code（建议 >= 2.1.209）：

## 创建配置文件

### 方式一：通过官方脚本快速配置

以下命令从 Step 官方仓库 `stepfun-ai/Step-Cookbook` 下载中文脚本，**下载成功后才执行**。

`macOS / Linux / WSL（Bash）` —— 请先安装 `jq`，脚本使用`jq`更新 JSON 配置：

```bash
curl -fsSL https://raw.githubusercontent.com/stepfun-ai/Step-Cookbook/main/scripts/claude-key-setup/zh-CN/configure_claude.sh -o configure_claude.sh &&
  bash configure_claude.sh
```

**Windows（普通 PowerShell）** —— 使用当前用户权限即可，无需管理员：

```powershell
& {
  $ErrorActionPreference = "Stop"
  Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
  Invoke-WebRequest -Uri "https://raw.githubusercontent.com/stepfun-ai/Step-Cookbook/main/scripts/claude-key-setup/zh-CN/configure_claude.ps1" -OutFile "configure_claude.ps1"
  & .\configure_claude.ps1
}
```

> **注意**：
> 1）接入 Step Plan 时，脚本菜单中选择 `2`，输入 API Key，并选择模型（默认 `step-5-preview`）；选择 1 会使用普通 API 通道。
>
> 2）脚本会备份已有配置并**替换整个 env 对象**，保留 `hooks`、`theme` 等其他顶层字段；原 `env` 中的额外变量会被移除。

### 方式二：手动编辑配置文件

直接编辑 `~/.claude/settings.json`。
将以下字段合并到用户级配置文件 `~/.claude/settings.json`，保留已有的 `permissions`、`hooks` 等设置。Windows 对应 `%USERPROFILE%\.claude\settings.json`；若设置了 `CLAUDE_CONFIG_DIR`，使用该目录下的 `settings.json`。文件不存在时先创建目录，再保存以下 Json，将 `YOUR_STEP_API_KEY` 替换为实际密钥：
```Json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_STEP_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.stepfun.com/step_plan"
  },
  "model": "step-5-preview"
}
```
模型 ID 可填写 step-5-preview、step-3.7-flash、step-3.5-flash-2603 或 step-3.5-flash。
​
| **字段**                              | **位置** | **用途**                                                                   |
| ----------------------------------- | ------ | ------------------------------------------------------------------------ |
| ANTHROPIC\_AUTH\_TOKEN              | env    | Step API Key，用于请求认证。                                                     |
| ANTHROPIC\_BASE\_URL                | env    | 配置为 `https://api.stepfun.com/step_plan`，Claude Code 自动追加 `/v1/messages`。 |
| model                               | 顶层     | 主会话模型；启动参数 `--model` 或环境变量 `ANTHROPIC_MODEL` 可覆盖此项。                      |
| ANTHROPIC\_DEFAULT\_OPUS\_MODEL 等   | env，可选 | 将内置模型档位映射到 Step 模型。                                                      |
| CLAUDE\_CODE\_SUBAGENT\_MODEL       | env，可选 | 设置子 Agent 模型。                                                            |
| CLAUDE\_CODE\_MAX\_CONTEXT\_TOKENS  | env，可选 | 覆盖客户端对自定义模型的上下文窗口估计。                                                     |
| CLAUDE\_CODE\_AUTO\_COMPACT\_WINDOW | env，可选 | 设置自动压缩使用的窗口，不超过模型上下文窗口。                                                  |
> 可选：将以下模型别名和子 Agent 配置合并到 `env`。任务显式指定的模型需单独核对。


```Json
{
  "ANTHROPIC_DEFAULT_SONNET_MODEL": "step-5-preview",
  "ANTHROPIC_DEFAULT_OPUS_MODEL": "step-5-preview",
  "ANTHROPIC_DEFAULT_HAIKU_MODEL": "step-5-preview",
  "ANTHROPIC_DEFAULT_FABLE_MODEL": "step-5-preview",
  "CLAUDE_CODE_SUBAGENT_MODEL": "step-5-preview"
}
```

首次接入先验证最小配置，再按需加入别名与子 Agent 设置。若后台任务仍请求内置模型名，请核对该任务显式指定的模型。
同名变量同时出现在配置文件 env 和终端环境时，配置文件中的值会覆盖终端值。切换服务后，请一并检查用户配置、项目配置及 `.zshrc / .bashrc` 中的旧地址和密钥，保存后重新启动 Claude Code。

## 方式三：Shell alias（和官方 Claude 共存）

如果你既要用官方 Claude，又要随时切到书生模型，最推荐这个方式：定义一个新命令 `claude-intern`，原来的 `claude` 完全不受影响。

### Linux / macOS

**第一步**：打开 shell 配置文件（同方式一第二步，zsh 用户改 `~/.zshrc`，bash 用户改 `~/.bashrc`）：

```bash
nano ~/.zshrc
```

**第二步**：在文件末尾追加 alias

```bash
alias claude-intern='ANTHROPIC_BASE_URL="https://api.stepfun.com/step_plan" \
  ANTHROPIC_AUTH_TOKEN="your-api-token" \
  ANTHROPIC_MODEL="step-5-preview" \
  ANTHROPIC_SMALL_FAST_MODEL="step-5-preview" \
  claude'
```

**第三步**：让 alias 生效

```bash
source ~/.zshrc
```

之后就有两个命令可以用：

```bash
claude          # 走你原来的配置（比如官方 Claude）
claude-step   # 走阶跃星辰 step-5 
```

`claude-intern` 后面可以跟参数，比如 `claude-intern --help`，效果和原生 `claude --help` 一致。

### Windows PowerShell

PowerShell 没有 alias 传环境变量的能力，用函数代替，效果一样。

打开 PowerShell 配置文件：

```powershell
notepad $PROFILE
```

如果提示文件不存在，先创建：

```powershell
New-Item -ItemType File -Path $PROFILE -Force
notepad $PROFILE
```

在文件中追加：

```powershell
function claude-intern {
    $env:ANTHROPIC_BASE_URL = "https://chat.intern-ai.org.cn"
    $env:ANTHROPIC_AUTH_TOKEN = "your-api-token"
    $env:ANTHROPIC_MODEL = "intern-s2"
    $env:ANTHROPIC_SMALL_FAST_MODEL = "intern-s2"
    claude @args
}
```

保存后执行 `. $PROFILE` 重新加载，之后就能使用 `claude-intern` 了。

***

## 验证是否接入成功

直接用 curl 验证 API 和 Token 是否可用：

```bash
curl -X POST https://api.stepfun.com/step_plan/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-token" \
  -d '{
    "model": "step-5-preview",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "ping"}]
  }'
```

返回内容里出现 `"type": "message"` 就说明通了。

***



## 设置推理强度

`Step-5-Preview` 支持以下推理强度：

| **--effort** | **适用任务**              |
| ------------ | --------------------- |
| `low`        | 简单任务，优先速度与较低 token 消耗 |
| `medium`     | 一般推理与多步骤任务            |
| `high`       | 复杂推理、规划与代码分析          |

调用 Step 5 Preview 时，`xhigh` 和 `max` 由服务端映射为 `high`；Claude Code 通过 Messages API 的 `output_config.effort` 传入该设置。

**启动时指定本次会话强度：**

```bash
claude --model step-5-preview --effort medium
```

**保存默认档位**时，将 `effortLevel` 合并到 `~/.claude/settings.json` **顶层**（不是 `env`）：

```json
{
  "effortLevel": "medium"
}
```

保存后重启 Claude Code。若未生效，检查 `CLAUDE_CODE_EFFORT_LEVEL`、启动参数及项目或组织设置。

## 开启 1M 上下文

`Step-5-Preview` 上下文窗口为 **1M tokens**。若 `/context` 显示为未识别模型并按 200k 计算，将以下字段合并进 `~/.claude/settings.json`（保留已有配置）：

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_STEP_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.stepfun.com/step_plan",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000"
  },
  "model": "step-5-preview"
}
```

说明：

* `CLAUDE_CODE_MAX_CONTEXT_TOKENS`：按 1M 窗口计算用量，必须是纯数字 `1000000`，不能写 `1M` 或 `1000k`。
* `CLAUDE_CODE_AUTO_COMPACT_WINDOW`：将自动压缩窗口对齐到 1M，取值 `100000–1000000`，同样只接受纯数字；客户端仍会预留输出与内部处理空间，可能在窗口填满前压缩。
* 保存后**完全退出并重新启动**，再输入 `/context` 确认窗口接近 1M 而非 200k。
* 声明大于 200k 后，启动时可能出现「200K limit isn't enforced」类提示，属预期行为。
* 通过官方脚本接入时，**脚本不会自动写入上述两个字段**，需手动补进 `env`。

## 启动 Claude Code

```bash
cd your-project
claude
```

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

## 测试接入

### 验证客户端对话

1. 保存配置，**完全退出并重新启动** Claude Code。
2. 输入 `/status`，核对模型、认证方式和配置来源。
3. 发送「只回复 OK」，检查返回内容与流式输出。

### 验证 Agent 工具调用

在已安装 Python 的独立测试目录中，先创建输出 `Hello, world!` 的 `hello.py`，再向 Claude Code 发送：

> 读取当前目录中的 `hello.py`，把它改成接受命令行参数 `name`。未传参数时输出 `Hello, Step5`；传入 `Ada` 时输出 `Hello, Ada`。使用本机可用的 Python 解释器分别运行这两种情况，检查输出。

* 若验证失败，根据报错修正后重新运行，不要修改其他文件。
* 完成后汇报文件变更、执行的命令和运行结果。
* 按权限提示批准必要操作，核对读取、修改、运行的工具记录及两次输出；随后继续提问，确认会话保留任务上下文。



# 总结
Step 阶跃星辰大模型 Claude-like API 已经兼容 Claude Code 客户端，搭配 step-5-preview 模型就可以在 Claude Code 里直接使用step-5-preview大模型。下面提供的接入方式，由快到稳：

1. **方式一·环境变量**：一行命令试试看，不改任何配置。
2. **方式二·settings.json**：长期使用，写进 Claude Code 配置。
3. **方式三·Shell alias**：和官方 Claude 共存，随时切换。

***



## 方式一：环境变量（最快，先跑通再说）

在当前终端临时设置，不影响任何已有配置，关掉终端就还原。最适合「先试试看好不好用」。

### Linux / macOS

打开终端，复制粘贴下面四行（记得把 token 换成自己的）：

```bash
export ANTHROPIC_BASE_URL="https://api.stepfun.com/step_plan"
export ANTHROPIC_AUTH_TOKEN="your-api-token"
export ANTHROPIC_MODEL="step-5-preview"
export ANTHROPIC_SMALL_FAST_MODEL="step-5-preview"
```

然后直接：

```bash
claude
```

进入 Claude Code 后输入 `/status`，能看到 Base URL 是我们的地址、模型是 intern-s2，就说明跑通了 🎉

### Windows PowerShell

```powershell
$env:ANTHROPIC_BASE_URL = "https://api.stepfun.com/step_plan"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-token"
$env:ANTHROPIC_MODEL = "step-5-preview"
$env:ANTHROPIC_SMALL_FAST_MODEL = "step-5-preview"

claude
```

想让它重启后依然生效，需要临时变量改为用户级变量：

```powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.stepfun.com/step_plan", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-api-token", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "step-5-preview", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL", "step-5-preview", "User")
```

### Windows CMD

```cmd
set ANTHROPIC_BASE_URL=https://api.stepfun.com/step_plan
set ANTHROPIC_AUTH_TOKEN=your-api-token
set ANTHROPIC_MODEL=step-5-preview
set ANTHROPIC_SMALL_FAST_MODEL=step-5-preview

claude
```

### 想要永久生效（Linux / macOS 版）

上面这种 `export` 只对当前终端有效，关掉就没了。如果你想以后每次开终端都自动生效，需要把它们写进 shell 配置文件。

**第一步：判断你用的是哪种 shell**

```bash
echo $SHELL
```

* 输出含 `zsh` → 编辑 `~/.zshrc`（macOS 默认就是 zsh）
* 输出含 `bash` → 编辑 `~/.bashrc`（多数 Linux 默认）

下面以 zsh 为例（bash 把 `.zshrc` 换成 `.bashrc` 即可）。

**第二步：用编辑器打开配置文件**

```bash
# 任选其一
nano ~/.zshrc      # 新手推荐，操作提示在屏幕底部
vim ~/.zshrc       # 熟悉 vim 的用
code ~/.zshrc      # 装了 VS Code 的话最直观
```

如果提示文件不存在，需要先 `touch ~/.zshrc` 新建一个再打开。

**第三步：把配置追加到文件末尾**

```bash
# Intern Claude Code
export ANTHROPIC_BASE_URL="https://api.stepfun.com/step_plan"
export ANTHROPIC_AUTH_TOKEN="your-api-token"
export ANTHROPIC_MODEL="step-5-preview"
export ANTHROPIC_SMALL_FAST_MODEL="step-5-preview"
```

保存退出（nano：`Ctrl + O` 回车保存，`Ctrl + X` 退出；vim：`:wq` 回车）。

**第四步：让改动立即生效**

```bash
source ~/.zshrc
```

这一步等价于重开一个终端，让 shell 重新读一次配置。之后任何新开的终端窗口都会自动带上这些变量。

***

## 方式二：写进 Claude Code 的 settings.json

> ⚠️ **请先看这里**：此方式会直接覆盖 Claude Code 的全局配置，原来用的 Anthropic 官方 Key 会失效。如果你现在仍在正常使用官方 Claude，建议优先考虑方式一或方式三。

**配置文件路径**：

* Linux / macOS：`~/.claude/settings.json`
* Windows：`%USERPROFILE%\.claude\settings.json`

打开 `settings.json`，把下面这段 `env` 合并进去（如果文件本身是空的，整段贴进去就行）：

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.stepfun.com/step_plan",
    "ANTHROPIC_AUTH_TOKEN": "your-api-token",
    "ANTHROPIC_MODEL": "step-5-preview",
    "ANTHROPIC_SMALL_FAST_MODEL": "step-5-preview"
  }
}
```

保存后重启 Claude Code 生效。

**怎么切回官方 Claude？** 删掉上面这几个键，或者把 `settings.json` 还原成你之前的样子。建议改之前先 `cp settings.json settings.json.bak` 备份一份。

**只想在某个项目里生效？** 把同样的配置放到该项目的 `.claude/settings.json` 即可，不影响别的项目。

***



## 常见问题

**Q1：`claude` 启动后报 401 Unauthorized / Invalid API Key？**

检查 `ANTHROPIC_AUTH_TOKEN` 有没有填完整。常见坑：前后多了空格/引号、误加了 `Bearer` 前缀、token 过期。

**Q2：`/status` 显示的还是 `api.anthropic.com`？**

说明环境变量没传到 Claude Code 进程里。新开一个终端窗口再试；或确认 `~/.bashrc`、`~/.zshrc`、`$PROFILE` 确实保存了改动并 `source` 过。

**Q3：模型经常空回复，或工具调用很不稳？**

`step-5-preview` 在 Claude Code 这类强依赖工具调用的场景下，必须保持 `thinking_mode` 开启（API 默认就是开的）。请不要在 settings 里通过 `extraBody` 把它关掉。

**Q4：上下文最长多少？**

`step-5-preview` 支持 1M 上下文。单次 `max_tokens` 建议 ≤ 8K或者 ≤ 64k。大型项目结合 Claude Code 的 `/compact` 压缩历史会更顺。

**Q5：被限流了（-20053 / HTTP 429）？**

默认 30 req/min。Claude Code 在多 Agent、密集工具调用时容易触发，可去限流策略申请更高配额。

**Q6：想切回官方 Claude 怎么办？**

* 方式一：关闭终端，或执行 `unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL ANTHROPIC_SMALL_FAST_MODEL`。
* 方式二：编辑 `~/.claude/settings.json`，删掉对应键。
* 方式三：直接用 `claude`，alias 不会污染默认命令。

**Q7：VS Code / JetBrains 插件能用吗？**

能。IDE 插件读的是同一份 `~/.claude/settings.json`，按方式二配好即可。环境变量方式只对「从同一个 shell 启动的 IDE 进程」生效。

## 两个模型变量是干嘛的？

这是配置里最容易让人疑惑的部分，单独解释下。

| **环境变量**                     | **角色**       | **影响哪些功能**                                   |
| ---------------------------- | ------------ | -------------------------------------------- |
| `ANTHROPIC_MODEL`            | 主模型（默认对话用）   | 跟 Claude Code 的所有正常对话、写代码、推理、工具调用，都走这个模型     |
| `ANTHROPIC_SMALL_FAST_MODEL` | 小快模型（后台轻量任务） | 会话标题生成、`/compact` 摘要压缩、状态栏更新、轻量分类等不需要重型推理的场景 |

Claude Code 会自动根据任务类型在两者之间切换，无需手动指定。

**为什么我们建议两个都设成  step-5-preview ？** 因为目前只暴露这一个对外模型；如果只设了 `ANTHROPIC_MODEL` 没设 `ANTHROPIC_SMALL_FAST_MODEL`，Claude Code 在后台任务里会尝试调用默认的 `claude-haiku-*`，这个模型在我们的 API 里不存在，会直接报错。

**关于 `/model` 命令的小坑**：Claude Code 的 `/model` 命令在使用第三方 `BASE_URL` 时，不会真的去请求我们的模型列表，它只能在你环境变量配置的值之间显示/切换。想确认当前实际用的是什么，**`/status` 命令更可靠**——它会直接打印 Base URL、Model、Small Fast Model 三个字段。

***


本文介绍如何在 Claude Code 中通过 Messages API 接入 Step 模型，配置 Step Plan、推理强度与 1M 上下文，并验证对话和工具调用。 更新日期：2026-10-28 | 适用模型：Step 5 Preview | API 端点：https://api.stepfun.com/step_plan/v1/messages

Step 5 接入 Claude Code的全流程指南

本文介绍如何在 Claude Code 中通过 Messages API 接入 Step 模型，配置 Step Plan、推理强度与 1M 上下文，并验证对话和工具调用。

开发工具

人工智能

云计算

本文详解如何在ClaudeCode中通过MessagesAPI接入Step Plan，配置step-5-preview模型、1M上下文及推理强度，并验证对话与工具调用。涵盖三种安装方式、环境变量设置、配置文件编辑及常见问题排查，助您快速启用Step模型。

密钥管理

代码解释

解释器

Windows

Python

Linux

MacOS

Agent

JSON

让每一个 Agent，都跑在云上

tcap

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Step 5 接入 Claude Code的全流程指南-腾讯云开发者社区-腾讯云

Step 5 接入 Claude Code的全流程指南

Step 5 接入 Claude Code的全流程指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐