# 给配置助手的任务

我是新手，正在 Windows 上配置 Claude Code，使用 藕片 API 服务。请先阅读这份教程：[Claude Code 平台教程](https://docs.eopt.ai/claude-code-windows)

请先确认我已经安装了什么、进行到哪一步。每次只指导一个步骤，写清楚在哪里操作、填什么、成功后会看到什么，等我反馈再继续。遇到错误先根据教程排查，不要猜测不存在的模型、分组或界面选项。已有配置先备份并只合并必要字段。API Key 用 sk-eopt-xxx 占位，由我在本机填写。

如果无法读取链接，请明确告诉我，让我粘贴完整教程。你没有本机操作能力时，请指导我执行，不要声称已经替我修改成功。

---

# Claude Code · Windows 配置教程

先完成一步，再继续下一步。已经完成的安装步骤可以跳过。

## 这份教程会帮你完成什么

安装并连接 藕片 API 服务，最后发送一条消息确认可以使用。所有 API Key 示例都是占位值 `sk-eopt-xxx`，实际 Key 只在你自己的软件中填写。

| 要填写的内容 | 本教程使用的值 |
|---|---|
| 工具 | Claude Code |
| 系统 | Windows |
| Base URL | `https://eopt.ai` |
| 模型 | 使用 Claude 默认模型 |

## 1. 安装并打开工具

右键开始按钮，打开「终端」中的 PowerShell，或打开「Windows PowerShell」。以下命令均在 PowerShell 中执行。

执行安装命令：

```powershell
irm https://claude.ai/install.ps1 | iex
```

关闭并重新打开终端，再检查版本：

```powershell
claude --version
```

**完成标志**：版本检查能显示版本号，没有「找不到命令」的提示。

如需使用 Git Bash，可另外安装 [Git for Windows](https://git-scm.com/install/windows)。已有 Git 时可跳过，安装后重新打开终端。

## 2. 获取 API 密钥
打开 [藕片 API](https://eopt.ai/sign-in) → [API 密钥](https://eopt.ai/keys) ，即可看到自动生成的密钥。

**完成标志**：看到自动生成的密钥。

## 3. 发一条消息验证

首次使用前，先按下方「手动配置」保存 藕片 API 地址和自己的 API 密钥，再重新打开 PowerShell。

在终端执行：

```powershell
claude
```

如果出现工作目录信任提示，确认目录后按界面操作，再发送：**请只回复「配置成功」**。

**完成标志**：收到正常回复，没有 API Key 无效、模型不可用或连接失败的报错。

## 没成功时，先看这里

| 你看到的现象 | 先做什么 |
|---|---|
| 找不到命令 | 关闭并重新打开终端，再检查版本；Windows 下确认打开的是本教程指定的终端。 |
| API Key 无效 / 401 | 检查 Key 是否复制完整、是否过期，确认已启用正确的 藕片 API 配置。不要把完整 Key 发到聊天里。 |
| 模型不可用 | 检查模型名称和模型限制；以本教程的配置表为准。 |
| 403 block | 确认是否使用官方客户端 |
| 连接失败 / 一直等待 | 换一个可用网络，检查代理；记录完整错误文字，不要同时修改多个设置。 |

### 以前登录过 Claude 官方账号

如果 藕片 API 配置没有生效，先在终端执行 `claude auth logout` 退出旧账号。不要同时混用官方 OAuth 登录和 藕片 API 的 API Key。

## 手动配置

将连接地址和 API 密钥保存在本机。已有配置时先备份，只合并下面涉及的字段，不要整份覆盖原文件。保存后重新打开 PowerShell。

配置文件：`%USERPROFILE%\.claude\settings.json`。可将此路径粘贴到资源管理器地址栏打开；目录或文件不存在时创建，并确认文件名是 `settings.json`，不是 `settings.json.txt`。

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://eopt.ai",
    "ANTHROPIC_API_KEY": "sk-eopt-xxx"
  }
}
```

把占位值 `sk-eopt-xxx` 替换成你自己的 API Key。

## 配好了，接下来

可以开始使用，也可以进入 [Claude Code 详细手册](https://docs.eopt.ai/claude-code/config) 查看更多配置。后续报错请保留错误原文、系统和工具版本，按 [报错手册](https://docs.eopt.ai/errors) 排查。