配置 CLI 工具

ProxyHub 支持在命令行中使用 Claude Code、Codex、Gemini CLI

环境检查

（1）确认 Nodejs 环境已安装

在 Windows 或 MacOS 终端输入以下命令：

npm list -g --depth=0

正常情况应该有输出内容（没有任何内容也没关系），如果提示"命令未找到"，则说明你没有安装 Nodejs， 你需要在 Nodejs官网 来安装运行 cli 所需的环境。

(2) 确认 git 环境已安装:

在 Windows 或 MacOS 终端输入以下命令：

git -v

正常情况应该输出 git version x.xx.x 等字样, 如果提示"命令未找到"，则说明你没有安装 git, 你需要在 Git官网 来安装运行 cli 所需的环境。

（2）安装 CLI

在 Windows 或 MacOS 终端输入以下命令，一次性安装好我们目前所需的所有终端：

npm i -g @anthropic-ai/claude-code@v2.1.79

不建议使用 v2.1.81 版本, 有计费异常的问题, 建议锁定指定版本

（3）测试安装成功

重要 这一步很重要，请你务必运行命令进行测试，因为这一步运行命令后，你的用户目录下才会生成各 CLI 的配置目录，方便后续操作！

Claude Code

在启动 claude code 之前, 请修改 claude code 的配置。

windows 环境, 请在 Document 目录下找到 .claude/settings.json 文件, 注意文件名是 settings.json

也可以通过键盘按下"Win+R"键，输入以下内容后回车，打开 Claude Code 配置目录找到文件, 如果不存在请自行创建

%userprofile%\.claude

mac 环境，找到 ~/.claude/settings.json 文件, 如果不存在请自行创建

配置文件如下(无论windows还是mac)

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "输入您在控制台设置的 token",
    "ANTHROPIC_BASE_URL": "https://proxyhub.ai",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1",
    "DISABLE_INSTALLATION_CHECKS": "1"
  }
}

在终端输入以下命令，若出现对话界面或选项，则 Claude Code 安装成功：

claude

如果您在打开 claude 遇到如下报错

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR BAD REQUEST
lease check your internet connection and network settings.
Note: Claude Code might not be available in your country

此时需要修改 .claude 文件, 找到 hasCompletedOnboarding 字段并设置值为 true (如没有需要自行添加)

通常这个文件在 setting.json 的同级目录或上一级目录

Codex

安装

npm i -g @openai/codex@latest

配置

修改 ~/.codex/config.toml 配置如下 (没有则新建)

model = "gpt-5.4"
model_provider = "custom"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.custom]
name = "custom"
base_url = "https://proxyhub.ai/v1"
wire_api = "responses"

修改 ~/.codex/auth.json

{
  "OPENAI_API_KEY": "填写你的 codex 令牌"
}

在终端输入以下命令，若出现对话界面或选项，则 Codex 安装成功：

codex