配置 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.71
npm i -g @openai/codex@latest
npm i -g @google/gemini-cli@latest

（3）测试安装成功

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

Claude Code

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

windows 环境, 请在 Document 目录下找到 .claude/setting.json 文件

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

%userprofile%\.claude

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

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "输入您在控制台设置的 token",
    "ANTHROPIC_BASE_URL": "https://proxyhub.ai",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "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

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

codex

Gemini

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

gemini

配置教程

安装完成后，请根据你使用的 CLI 选择对应的配置教程：