在 Claude Code 中使用 ByteRouter

准备工作

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，支持在终端中直接与 AI 对话、生成代码、调试问题等。通过接入 ByteRouter，您可以在 Claude Code 中使用包括 GPT、Claude、Gemini 在内的多种模型。在开始之前，请确保：

已获取 ByteRouter API 密钥 登录 ByteRouter 控制台获取您的 API 密钥

提示： 如果还没有 ByteRouter 账户，请先在 ByteRouter 官网注册并获取 API 密钥。

第一步：安装 Claude Code

选择以下任一方式安装：

macOS / Linux（推荐）
Windows
NPM 安装

使用官方脚本一键安装：

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

也可以通过 Homebrew 安装：

brew install --cask claude-code

如果遇到权限问题，请在命令前加 sudo。

PowerShell：

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

CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

如果您已安装 Node.js 18 或更新版本，可以通过 npm 安装：

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

适用于所有操作系统。

验证安装

安装完成后，运行以下命令确认安装成功：

claude --version

如果输出版本号（如 1.x.x），说明安装成功。

第二步：配置 ByteRouter API

以下提供三种配置方式，根据您的使用习惯任选其一。

方式一：编辑 settings.json（推荐）

这是最稳定的配置方式，配置一次即可长期生效。 1. 找到配置目录：

Windows：按 Win + R，输入 %userprofile%\.claude 打开
macOS：按 Command + Shift + G，输入 ~/.claude 打开
Linux：进入 ~/.claude 目录

如果目录不存在，先在终端运行一次 claude 再按 Ctrl + C 退出，会自动生成该目录。

2. 创建或编辑 settings.json 文件：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://byterouter.ai/v1",
    "ANTHROPIC_AUTH_TOKEN": "your_api_key_here",
    "ANTHROPIC_MODEL": "claude-sonnet-4.6"
  }
}

参数	说明
`ANTHROPIC_BASE_URL`	ByteRouter API 地址，固定为 `https://byterouter.ai/v1`
`ANTHROPIC_AUTH_TOKEN`	您的 ByteRouter API 密钥
`ANTHROPIC_MODEL`	默认使用的模型，可从下方模型列表中选择

保存文件后，重新启动 Claude Code 即可生效。

方式二：永久环境变量

将配置写入系统环境，所有终端窗口都会自动加载。

macOS (zsh)
macOS / Linux (bash)
Windows

echo 'export ANTHROPIC_BASE_URL="https://byterouter.ai/v1"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your_api_key_here"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4.6"' >> ~/.zshrc
source ~/.zshrc

echo 'export ANTHROPIC_BASE_URL="https://byterouter.ai/v1"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your_api_key_here"' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4.6"' >> ~/.bashrc
source ~/.bashrc

方式 A：图形界面设置

右键 “此电脑” → “属性” → “高级系统设置” → “环境变量”
在 “用户变量” 中新建：
- ANTHROPIC_BASE_URL = https://byterouter.ai/v1
- ANTHROPIC_AUTH_TOKEN = your_api_key_here
- ANTHROPIC_MODEL = claude-sonnet-4.6
重启终端窗口

方式 B：PowerShell 命令设置

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://byterouter.ai/v1', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'your_api_key_here', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-sonnet-4.6', 'User')

方式三：临时环境变量

适合临时测试或短期使用，关闭终端后配置会失效。

macOS / Linux
Windows (PowerShell)

export ANTHROPIC_AUTH_TOKEN="your_api_key_here"
export ANTHROPIC_MODEL="claude-sonnet-4.6"
export ANTHROPIC_BASE_URL="https://byterouter.ai/v1"
claude

$env:ANTHROPIC_AUTH_TOKEN="your_api_key_here"
$env:ANTHROPIC_MODEL="claude-sonnet-4.6"
$env:ANTHROPIC_BASE_URL="https://byterouter.ai/v1" claude ```
</Tab>

<Tab title="Windows (CMD)">
  ```cmd theme={null}
  set ANTHROPIC_AUTH_TOKEN=your_api_key_here
  set ANTHROPIC_MODEL=claude-sonnet-4.6
  set ANTHROPIC_BASE_URL=https://byterouter.ai/v1
  claude

临时环境变量仅在当前终端窗口有效，切换窗口或关闭终端后需重新设置。

第三步：开始使用

验证配置

启动 Claude Code 并发送一条简单消息来确认配置是否正确：

claude "你好"

如果收到 AI 回复，说明配置成功。如果出现错误，请参考下方常见问题排查。

使用方式

Claude Code 提供两种交互模式：

交互模式：运行 claude 进入持续对话，适合复杂任务
单次命令：运行 claude "你的问题" 获取单次回复后退出，适合快速提问

支持的模型

ByteRouter 支持多种 AI 模型，您可以根据任务需求灵活切换。详见快速开始页面了解完整的模型列表。

常用模型示例

模型名称	特点
`claude-sonnet-4.6`	性能与速度均衡
`claude-opus-4.5`	最强综合能力
`gpt-4.1`	高效能 GPT 模型
`gemini-2.0`	Google 高级模型

常用命令

以下是 Claude Code 中常用的命令和快捷操作：

命令	说明
`claude`	进入交互模式
`claude "问题"`	单次提问
`claude --version`	查看版本号
`/model`	在交互模式中切换模型
`/help`	查看帮助信息
`Ctrl + C`	退出交互模式

常见问题

Q1: 配置后仍然弹出登录选择页面？

启动后仍然显示 “Select login method” 说明配置未生效。 排查步骤：

使用 settings.json 方式：检查文件路径是否正确
- Windows：C:\Users\<用户名>\.claude\settings.json
- macOS / Linux：~/.claude/settings.json
使用环境变量方式：确认在设置变量的同一终端窗口中启动了 Claude Code
检查 JSON 格式：确保括号、逗号、引号都正确（不要使用中文引号）

Q2: 出现认证错误？

错误信息	含义	解决方案
`401 Unauthorized`	API 密钥无效	检查密钥是否正确，登录 ByteRouter 控制台确认
`403 Forbidden`	权限不足	确认 API 密钥是否过期或已被禁用

同时确保 ANTHROPIC_BASE_URL 设置为 https://byterouter.ai/v1。

Q3: 提示 “Unable to connect” 连接失败？

这说明 Claude Code 未能连接到 API 服务。

检查网络连接是否正常
确认 ANTHROPIC_BASE_URL 配置正确
如果使用了代理，确保代理设置允许访问 byterouter.ai

Q4: 如何切换模型？

两种方式：

交互模式中：输入 /model 命令即可切换
修改配置：更改 settings.json 或环境变量中的 ANTHROPIC_MODEL 字段，重启 Claude Code

Q5: 响应速度慢？

切换到响应更快的模型
缩短提问内容，减少上下文长度
检查本地网络状况

支持与帮助

如果您在使用过程中遇到任何问题，请联系我们：

📧 技术支持：[email protected]

开始使用 ByteRouter

立即注册 ByteRouter，获取您的 API 密钥，在 Claude Code 中体验多模型编程助手！

​准备工作

​第一步：安装 Claude Code

​验证安装

​第二步：配置 ByteRouter API

​方式一：编辑 settings.json（推荐）

​方式二：永久环境变量

​方式三：临时环境变量

​第三步：开始使用

​验证配置

​使用方式

​支持的模型

​常用模型示例

​常用命令

​常见问题

​Q1: 配置后仍然弹出登录选择页面？

​Q2: 出现认证错误？

​Q3: 提示 “Unable to connect” 连接失败？

​Q4: 如何切换模型？

​Q5: 响应速度慢？

​支持与帮助

开始使用 ByteRouter

准备工作

第一步：安装 Claude Code

验证安装

第二步：配置 ByteRouter API

方式一：编辑 settings.json（推荐）

方式二：永久环境变量

方式三：临时环境变量

第三步：开始使用

验证配置

使用方式

支持的模型

常用模型示例

常用命令

常见问题

Q1: 配置后仍然弹出登录选择页面？

Q2: 出现认证错误？

Q3: 提示 “Unable to connect” 连接失败？

Q4: 如何切换模型？

Q5: 响应速度慢？

支持与帮助