三步配置
1
安装 Claude Code
- macOS
- Windows
- Linux
打开“终端”，运行官方安装命令（macOS 13 及以上，Intel / Apple Silicon 均可）：
claude --version。2
保存网关、Key 和模型到用户配置
从 ABCRelay 控制台 复制 API Key 和可用的 Claude 模型 ID。按系统打开下面的文件，再填写 JSON 中的两个占位符。文件不存在时请新建此文件，已有配置请合并 配置保存后，重开终端仍然生效，无需每次执行
env 内容，保留其他设置。- macOS
- Windows
- Linux
默认完整路径：
export。Key 不加 Bearer 。如设置过 CLAUDE_CONFIG_DIR，请使用该目录下的 settings.json。地址不带 /v1： ANTHROPIC_BASE_URL 填 https://www.abcrelay.com。Claude Code 追加 /v1/messages，最终请求为 https://www.abcrelay.com/v1/messages；填成 /v1 结尾会重复版本路径。三个系统相同。3
确认生效，发送第一条消息
保存文件后，在终端运行 收到回复后，在 ABCRelay 控制台核对同一时间的调用记录。记录中的令牌和模型一致，才确认本次请求经过 ABCRelay；实际调用会消耗额度。
claude。进入新会话，输入 /status 检查网关地址和模型，再发送：FAQ 与详细说明
为什么 Codex 带 /v1，Claude Code 却不带？
为什么 Codex 带 /v1，Claude Code 却不带？
它们追加的接口路径不同：Codex 追加
/responses，Claude Code 追加 /v1/messages，所以基础地址不能互相照抄。此规则取决于客户端的配置字段和模式，与系统或模型品牌无关。其他客户端见API 地址对照表。重开终端后还要重新配置吗？旧变量怎么处理？
重开终端后还要重新配置吗？旧变量怎么处理？
不用。第 2 步已经写入用户配置：macOS / Linux 的
~/.claude/settings.json，Windows 的 %USERPROFILE%\.claude\settings.json。新会话会读取它；自定义 CLAUDE_CONFIG_DIR 时，文件位于该目录下的 settings.json。文件包含 Key，不要提交到仓库。无需把这份配置再写进 ~/.bashrc 或 ~/.zshrc。若之前在这些 shell 启动文件里保存过旧地址或 Key，删除相应旧项，避免同时维护两份；设置文件中的同名 env 值会覆盖 shell 值。项目与托管设置也可能覆盖用户配置，以 /status 为准。首次接入使用上述用户级文件；项目级 .claude/settings.json（相对于项目根目录）在首次向导与目录信任确认之后才生效，不要把真实 Key 放进会提交的项目配置。Windows CMD、Homebrew 和其他安装方式怎么用？
Windows CMD、Homebrew 和其他安装方式怎么用？
Windows CMD 安装：安装后仍使用第 2 步的用户配置文件，保存后运行
claude，无需 set Key。
macOS 也可使用 brew install --cask claude-code，Windows 也可使用 winget install Anthropic.ClaudeCode。不要混用不同 shell 的语法。WSL 与原生 Windows 的用户目录和配置分开。Linux 也有官方 apt / dnf / apk 包。Alpine 需先安装 bash、curl、libgcc、libstdc++ 和 ripgrep，并设置 USE_BUILTIN_RIPGREP=0，见官方平台安装步骤。macOS / Linux / WSL 的 CLI 通常位于 ~/.local/bin/claude。原生 Windows 和 WSL 是两套安装，请在同一环境安装、配置并启动。为什么仍要求登录，或者出现 401？
为什么仍要求登录，或者出现 401？
先检查第 2 步用户文件是否已保存为有效 JSON，以及
/status 显示的凭据来源。ANTHROPIC_AUTH_TOKEN 优先于已保存的 Claude 登录；配置正确时无需先登录 Claude 订阅账号，首次界面和目录信任向导仍可能出现。Key 只填原文，不加 Bearer ，确认未撤销、有余额和模型权限。如果管理员明确要求 x-api-key，改用 ANTHROPIC_API_KEY，不要同时保留两种鉴权变量。在用户文件的 env 中替换鉴权字段后重启。该模式首次交互需要批准；曾拒绝时在 /config → Use custom API key 中开启。托管设置中的 forceLoginMethod 或 forceLoginOrgUUID 可能强制官方登录，需要管理员调整。为什么模型不存在，或主模型能用、后台功能却报错？
为什么模型不存在，或主模型能用、后台功能却报错？
使用控制台可用的准确 API 模型 ID，不能用展示名称。主会话也可通过
claude --model "YOUR_CLAUDE_MODEL_ID" 或 /model YOUR_CLAUDE_MODEL_ID 选择。别名和后台功能可能使用其他模型，按实际开放权限配置：不要给未确认能力的模型添加
[1m]。Anthropic 官方不支持将 Claude Code 通过网关路由到非 Claude 模型。404、流式输出卡住或工具调用失败怎么处理？
404、流式输出卡住或工具调用失败怎么处理？
根地址应为
https://www.abcrelay.com，客户端自行追加 /v1/messages。渠道需要 Anthropic Messages、SSE、工具调用及相应的请求字段；只有 OpenAI Chat Completions 接口不够。单独的 /v1/messages/count_tokens 404 不代表推理不可用，该接口属于可选能力。400 提到 thinking、context_management 等字段时，按官方网关兼容性说明排查具体模型与上游。输出卡住时检查代理是否缓冲 SSE 或丢弃 ping、工具字段。429 需结合控制台区分余额、预算、速率限制与上游限流。更多示例见故障排查。为什么 CLI 配置不能直接用于桌面 App？有哪些功能限制？
为什么 CLI 配置不能直接用于桌面 App？有哪些功能限制？
桌面 App 使用独立的第三方推理配置窗口，不从 CLI 的
ANTHROPIC_BASE_URL 或用户配置（~/.claude/settings.json；Windows 资源管理器为 %USERPROFILE%\.claude\settings.json） 读取网关路由，见桌面版指南。网关凭据模式不支持依赖 claude.ai 身份的 Remote Control 和语音输入；官方网页与 Slack 云端模式也不会因为本机配置而改走 ABCRelay。官方参考与核对日期
官方参考与核对日期
核对日期：2026-09-10。本页已核对官方配置说明，未逐项完成客户端实测。一次短消息成功只验证该次调用，不能代表长上下文、工具链及所有后台功能都可用。