why01 API 文档

主题

Claude Code 部署

Claude Code 是 Anthropic 官方的 CLI 编码 agent——直接在终端里让 Claude 读你的代码、改文件、跑命令、提交 git。原生只接 Anthropic 官方账号，但通过环境变量可指向 OpenAI/Anthropic 协议兼容网关，本站就是其中之一。

前置条件 ​

  • Node.js 18+：还没装的看 Windows / macOS / Linux 安装指南
  • why01 API Key：还没建的看 创建 API Key
  • 账户余额 > 0：Claude Code 调用费用按 token 计费，先去 充值；建议 ¥50 起步（Claude Code 长会话烧 token 不慢，¥10 跑不了多久）

1. 安装 Claude Code ​

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

国内 npm 慢的话先换镜像：

bash
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

装完验证：

bash
claude --version

输出版本号即装好。

2. 配置环境变量（指向 why01） ​

Claude Code 读两个环境变量来决定调哪个 endpoint：

变量值
ANTHROPIC_BASE_URLhttps://s1.why01.top
ANTHROPIC_AUTH_TOKEN你的 sk-xxxxxxxx（why01 控制台创建的，不是 Anthropic 官方的 sk-ant-...）

WARNING

变量名是 ANTHROPIC_AUTH_TOKEN，不是 ANTHROPIC_API_KEY。两者作用不同——前者用于第三方 endpoint 鉴权，后者锁定 Anthropic 官方账号。填错会报 401。

macOS / Linux ​

把这两行加到你的 shell 配置（zsh 用户加 ~/.zshrc，bash 用户加 ~/.bashrc，fish 用户加 ~/.config/fish/config.fish）：

bash
export ANTHROPIC_BASE_URL=https://s1.why01.top
export ANTHROPIC_AUTH_TOKEN=sk-你的key

reload：

bash
source ~/.zshrc       # 或 ~/.bashrc

Windows ​

方式 A（PowerShell 当前会话临时）：

powershell
$env:ANTHROPIC_BASE_URL = "https://s1.why01.top"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的key"

只对当前窗口有效，关闭即失效。

方式 B（永久写入用户环境变量）：

powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://s1.why01.top", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的key", "User")

设完关掉所有终端窗口重开才能生效（老窗口的环境变量是设之前的）。

方式 C（GUI）：「设置 → 系统 → 关于 → 高级系统设置 → 环境变量 → 用户变量 → 新建」，名称分别填上面两个，值填对应内容。同样需要重开终端。

3. 启动 ​

进入你的项目目录，执行：

bash
cd ~/your-project
claude

进入交互界面后，与官方 Anthropic 账号体验一致——输入需求、Claude 读你的代码、提建议、按 Y/n 确认改动。

4. 验证调用确实走了 why01 ​

启动 Claude Code 后随便问一句让它执行的简单任务，让它跑完。然后回到 why01 控制台 → 日志 看：

  • 应该能在最近几分钟看到一组 Claude 模型的调用记录
  • 模型名形如 claude-sonnet-4-6-... 或 claude-sonnet-4-...（取决于你账户能访问的版本）
  • token 数 / 状态码 / 耗时都正常

看到了 = 接通了。

常见问题 ​

启动报 401 Unauthorized ​

典型报错界面：

Claude Code 401 报错示意

按这个顺序排：

  1. 检查环境变量：echo $ANTHROPIC_AUTH_TOKEN（Windows: echo %ANTHROPIC_AUTH_TOKEN% 或 PowerShell 里 $env:ANTHROPIC_AUTH_TOKEN）
    • 输出空 → 变量没设进去 / 没 reload shell
    • 输出 sk-ant-... → 用错了！要用 why01 的 sk-xxxxxxxx，不是 Anthropic 官方 sk-ant-...
  2. 检查 Key 状态：控制台「令牌管理」 看这个 Key 是「已启用」+ 未过期
  3. 检查变量名：必须是 ANTHROPIC_AUTH_TOKEN，不是 ANTHROPIC_API_KEY（两者并存时 _API_KEY 优先级更高，会覆盖你的设置）

启动报 404 / model not found ​

Claude Code 默认会用 Anthropic 最新的某个 Claude 模型（如 claude-sonnet-4-5-...）。如果你所在用户组没接入对应模型，会 404。两种处理：

  1. 联系客服升级到包含该模型的用户组
  2. 用 --model 显式指定一个你账户能访问的 Claude 模型：
    bash
    claude --model claude-sonnet-4-6
  3. 或者在配置里固定模型（详见官方文档 Settings）

具体可用的 Claude 模型名以 控制台模型页 实际显示为准。

提示 command not found: claude ​

PATH 里没 npm 全局 bin 目录。检查：

bash
npm config get prefix       # 输出全局 bin 所在目录的父级
ls $(npm config get prefix)/bin     # 应能看到 claude

如果文件存在但命令不通，把那个 bin 目录加到 PATH。

切回 Anthropic 官方账号 ​

清掉变量即可：

bash
unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN

或者改成官方 Key（注意是 _API_KEY 不是 _AUTH_TOKEN）：

bash
export ANTHROPIC_API_KEY=sk-ant-你的官方key
unset ANTHROPIC_BASE_URL

Claude Code 怎么计费的 ​

按 Claude Code 实际向网关发的 token 数算，含：

  • 你的对话内容
  • Claude Code 注入的 system prompt
  • 工具调用（读文件 / 改文件 / 跑命令）的 context
  • 文件读取后的代码内容

Agent 流可能比裸 chat 费 token 几倍——一次 "改一下这个 bug" 可能消耗几万 token。建议：

  • 先用便宜模型（如 claude-haiku-4-5）试通流程，再切贵模型做实际工作
  • 控制台「日志」按时间段查每次调用的 token 数，监控用量
  • 给 Agent 单独建一个 Key 并 设额度上限，单次任务跑飞只烧这一个 Key 的预算

长会话 / 多文件项目响应慢 ​

Claude Code 会维持一个长上下文，文件越多 + 对话越长，每次请求的 token 越多，延迟随之增长。建议：

  • 长会话超过 1 小时建议用 /clear 命令清上下文重开
  • 大型项目用 .claudeignore 排除无关目录（node_modules/, dist/ 等）

下一步 ​