Claude Code CLI 接入

难度 ⌨️ 进阶（命令行）　|　接口格式 Claude　|　base_url https://byesu.si

接入信息 · 填这几样

接口地址https://byesu.si

API 密钥sk-xxxxxxxx去控制台创建 →

推荐模型claude-opus-5-5

接口格式 Claude · 模型名以 控制台 实际为准

Claude Code 是 Anthropic 官方的命令行编程助手。它默认连 Anthropic，我们用两个环境变量把它指向半页酥。

开始之前

先到 控制台 → 令牌 创建一个 Claude 分组 的令牌（见 选择分组）。下文的 sk-xxxx 换成你自己的。

第 1 步：安装 Claude Code

任选一种方式：

原生安装器（免 Node，推荐）

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

npm（需 Node.js 18+）

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

npm 路线需要先装 Node.js 18+（没装的去 nodejs.org 下载 LTS 版）。Windows 用户还需要先安装 Git for Windows——Claude Code 依赖 Git Bash，缺了启动会报错。

装好后验证：

claude --version

第 2 步：指向半页酥（二选一）

方式一：一键脚本（最快，推荐）

接口地址我们已经帮你写进脚本了 —— 运行后只要粘贴你的 API Key（sk-xxxx）。脚本会把配置写进 Claude Code 自己的配置文件 ~/.claude/settings.json，并跳过官方登录页：不用 source、不用重开终端，配完直接运行 claude。

Windows

iex (irm 'https://docs.byesu.si/setup/claude.ps1')

macOS / Linux

curl -fsSL https://docs.byesu.si/setup/claude.sh | bash

脚本还会把 ~/.bashrc / ~/.zshrc 里旧的 ANTHROPIC_* 变量注释掉（原文件备份为 *.byesu-bak.时间），免得旧 Key 和新配置打架；Windows 版会删除同名的用户环境变量。

方式二：手动写配置文件

① ~/.claude/settings.json（Windows 在 C:\Users\你的用户名\.claude\settings.json；文件已存在就只加 env 这一段）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://byesu.si",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌"
  }
}

② ~/.claude.json（也在用户主目录）：在最外层的 { } 里加上 "hasCompletedOnboarding": true；文件不存在就新建：

{
  "hasCompletedOnboarding": true
}

不加这一项，首次启动会弹出 claude.ai 的登录页（让你打开链接、粘贴 code）——那是 Anthropic 官方账号登录，用半页酥不需要。

注意

• ANTHROPIC_BASE_URL 是 https://byesu.si（Anthropic 格式，不带 /v1）。
• 用 ANTHROPIC_AUTH_TOKEN，不用 ANTHROPIC_API_KEY：后者会让 Claude Code 先弹一个「是否使用这个 API Key」的确认。
• 终端里如果还 export 着旧的 ANTHROPIC_API_KEY，它会盖过上面的配置：执行 unset ANTHROPIC_API_KEY，或从 ~/.bashrc / ~/.zshrc 删掉那一行再新开终端。

第 3 步：选模型（可选）

启动 Claude Code 后，输入 /model 即可切换模型；也可用环境变量指定默认：

export ANTHROPIC_MODEL="claude-opus-5-5"   # 当前最强；或控制台里其它 Claude 模型

第 4 步：跑起来验证

进任意项目目录，启动：

claude

让它做点小事（比如「列出当前目录的文件」），能正常回答就接通了 ✅

卡住了？

• 401 / 令牌无效 → Key 填错；或终端里还留着旧的 ANTHROPIC_API_KEY（执行 unset ANTHROPIC_API_KEY 或新开终端）（详情）
• 启动后弹出 claude.ai 登录页、让你粘贴 code → 配置没生效：重新跑一遍上面的一键脚本，或按方式二在 ~/.claude.json 加上 hasCompletedOnboarding
• 无可用渠道 → 令牌不在 Claude 分组里（选择分组，详情）
• 余额不足 → 去控制台充值（详情）
• 其它见 常见错误 & 解决