Claude Code · Linux 配置教程

选择你的电脑系统

不知道选哪个？Windows 是常见 PC 系统，苹果电脑通常选 macOS。

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

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

打开 Linux 的「终端」。如果使用 WSL，请在相应的 Linux 发行版终端中执行以下命令。

执行安装命令：

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

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

claude --version

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

打开藕片 API → API 密钥，即可看到自动生成的密钥。

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

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

在终端执行：

claude

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

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

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

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

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

配置文件：~/.claude/settings.json。

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

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

可以开始使用，也可以进入 Claude Code 详细手册查看更多配置。后续报错请保留错误原文、系统和工具版本，按报错手册排查。