Claude Code 配置参考

藕片 API 的 Claude Code 手动配置参考：安装命令、settings.json、Base URL、API Key、Windows PowerShell 和配置冲突排查。

本页用于手动设置藕片 API 连接和排查配置冲突。首次安装可先选用 Windows、macOS 或 Linux 教程。

安装与版本检查

macOS、Linux 或 WSL 终端：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

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

安装完成后重新打开终端，再运行 claude --version。出现版本号后继续配置；找不到命令时先处理安装目录与 PATH。

范围	位置	用途
macOS / Linux 用户配置	`~/.claude/settings.json`	个人连接与偏好
Windows 用户配置	`%USERPROFILE%\.claude\settings.json`	个人连接与偏好
项目共享配置	`.claude/settings.json`	团队共同的项目设置
项目个人配置	`.claude/settings.local.json`	个人在该项目内的设置

API Key 放在个人配置中。修改已有文件时保留其他内容，只合并必要字段。Windows 创建文件后确认名称是 settings.json，没有额外的 .txt 后缀。

登录藕片 API 的 API 密钥页面获取自己的 Key，然后在用户设置中合并：

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

将 sk-eopt-xxx 换成本机使用的真实密钥。Base URL 填写 https://eopt.ai，客户端会构造实际请求路径，不需要在这里追加 /v1/messages。

控制台复制的终端配置可能使用 ANTHROPIC_AUTH_TOKEN。它同样是客户端传递凭据的一种方式；排查时检查是否还存在另一项凭据或旧服务地址，避免同时使用不同的 Key。

只想在当前终端测试时，可以先使用会话级变量。

macOS / Linux：

export ANTHROPIC_BASE_URL='https://eopt.ai'
export ANTHROPIC_API_KEY='sk-eopt-xxx'
claude

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = "https://eopt.ai"
$env:ANTHROPIC_API_KEY = "sk-eopt-xxx"
claude

这些写法只影响当前终端及其启动的进程。希望以后直接运行 claude 时，使用上面的个人配置文件。已有终端不会因为另一个窗口修改了变量而自动更新。

设置可能来自组织管理、启动参数、项目个人文件、项目共享文件和用户文件。某些行为还会读取环境变量，具体优先规则取决于字段，不能把所有变量一概视为同一个覆盖层。

出现“改了仍不生效”时按顺序检查：

只查看地址可以执行：

printf '%s\n' "$ANTHROPIC_BASE_URL"

PowerShell 对应为：

$env:ANTHROPIC_BASE_URL

空值只说明当前 shell 没有设置该变量，不能据此判断设置文件是否生效。检查凭据时不要把完整 Key 粘贴到日志或反馈中。

在 Claude Code 中使用 /model 切换当前可用模型，模型名称和价格以藕片 API 控制台概览为准。收到模型相关错误时先核对完整名称与账号权限。

缓存读取、缓存写入、普通输入和输出分别记录。单次费用以使用日志中的详情为准，长会话的实际用量还受输入规模、工具结果和客户端请求轮数影响。

先运行 claude --version 确认安装，再运行 claude，在新会话发送“请只回复配置成功”。正常收到回复后，到藕片 API 使用日志查看对应调用。

401 优先检查地址和密钥，402 查看钱包，429 查看报错中的限制说明；持续出现其他错误时转到报错与踩坑汇总。