> ## Documentation Index
> Fetch the complete documentation index at: https://bianxieai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> 通过 Anthropic 兼容接口运行 Claude Code

## 安装

按 Claude Code 官方方式完成安装，确认 `claude --version` 可运行。然后配置以下环境变量。

<CodeGroup>
  ```bash macOS / Linux theme={null}
  export ANTHROPIC_BASE_URL="https://api.bianxie.ai"
  export ANTHROPIC_AUTH_TOKEN="API_KEY"
  export ANTHROPIC_MODEL="your-model"
  claude
  ```

  ```powershell Windows PowerShell theme={null}
  $env:ANTHROPIC_BASE_URL="https://api.bianxie.ai"
  $env:ANTHROPIC_AUTH_TOKEN="API_KEY"
  $env:ANTHROPIC_MODEL="your-model"
  claude
  ```
</CodeGroup>

若当前 Claude Code 版本读取 `ANTHROPIC_API_KEY` 而非 `ANTHROPIC_AUTH_TOKEN`，将同一密钥写入该变量。模型必须支持 Anthropic Messages 和工具调用。

## 持久化配置

macOS/Linux 可将变量写入 `~/.zshrc` 或 `~/.bashrc` 后重新加载；Windows 可写入用户环境变量。也可在 `~/.claude/settings.json` 的 `env` 中配置，但不要把包含真实 Key 的文件提交到仓库。

## 常见问题

### 提示 Not logged in 或要求登录

如果启动后看到 **Not logged in · Please run /login**，或进入 Anthropic 登录选项，通常说明 Claude Code 没有读取到可用的便携AI聚合API配置，或首次引导尚未完成。

先检查 `ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_BASE_URL` 和 `ANTHROPIC_MODEL` 是否已在当前终端生效，以及是否被旧的全局环境变量或 CC Switch 配置覆盖。确认 Key、Base URL 和模型 ID 正确后，如仍进入登录流程，可按以下步骤跳过首次引导：

1. 定位用户主目录下的 `.claude.json` 文件：

   * macOS / Linux：`~/.claude.json`
   * Windows：`C:\Users\%USERNAME%\.claude.json`

2. 将 `hasCompletedOnboarding` 字段设置为 `true`：

```json theme={null}
{
  "hasCompletedOnboarding": true
}
```

3. 保存文件，然后在终端中重新运行 `claude`。

<Note>如果 `.claude.json` 已包含其他字段，只添加或修改 `hasCompletedOnboarding`，不要覆盖整个文件。</Note>

### 其他错误

* `401`：不要把 `API_KEY` 占位符原样写入配置。
* `400 Incorrect model ID`：从实时模型页复制完整模型 ID。
* CC Switch 与手动配置同时存在：删除冲突的全局 `ANTHROPIC_*` 变量。