国内直连 · 免代理 · 即开即用

三步用上 Claude Code & Codex
稳定加速,告别卡顿

跟着这份指南,在 macOS、Windows、Linux 上完成安装并接入中转服务。全程复制粘贴,新手也能十分钟搞定。

开始安装 → 直接看接入配置
Step 0

开始之前的准备

两个工具都依赖运行环境。先把基础装好,后面才顺畅。

01

Node.js 18+

Claude Code 基于 Node 运行。前往 nodejs.org 下载 LTS 版本,一路下一步安装即可。

02

一个终端

macOS 用「终端」或 iTerm;Windows 用 PowerShell 或 Windows Terminal;Linux 用自带终端。命令都在这里敲。

03

中转 API Key

在本站后台获取你的专属 Key 和接入地址,接入配置那一步会用到,先复制好备用。

C

安装 Claude CodeAnthropic 官方命令行工具

1 确认 Node 已安装
输出版本号(v18 以上)即正常。没反应就回去装 Node.js。
node -v
2 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
3 验证安装
claude --version
提示
如果提示 权限不足 / EACCES,在命令前加 sudo 重试,或用 nvm 管理 Node 避免权限问题。
1 以管理员打开 PowerShell
开始菜单搜索 PowerShell,右键「以管理员身份运行」。
node -v
2 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
3 验证安装
claude --version
注意
若提示 无法加载脚本,因为在此系统上禁止运行脚本,先执行:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 然后输入 Y 确认。
1 确认 Node 已安装
Debian/Ubuntu 可用 sudo apt install nodejs npm 安装。
node -v
2 全局安装 Claude Code
sudo npm install -g @anthropic-ai/claude-code
3 验证安装
claude --version
提示
推荐用 nvm 安装 Node,避免 sudo 全局安装带来的权限问题。
X

安装 Codex CLIOpenAI 官方命令行编程助手

1 全局安装 Codex
npm install -g @openai/codex
2 验证安装
codex --version
提示
也可以用 Homebrew 安装:brew install codex。装完同样用 codex --version 验证。
1 全局安装 Codex
在 PowerShell 或 Windows Terminal 中执行。
npm install -g @openai/codex
2 验证安装
codex --version
注意
提示找不到 codex 命令时,关闭终端重新打开一次,让 PATH 生效。
1 全局安装 Codex
sudo npm install -g @openai/codex
2 验证安装
codex --version
提示
用 nvm 管理 Node 时不需要 sudo,直接 npm install -g @openai/codex 即可。
核心步骤

接入中转加速

把工具的请求地址指向本站中转,即可在国内免代理稳定使用。下面两处占位需替换成你后台拿到的真实信息。

必填
将命令里的 YOUR_API_KEY 换成你的专属密钥,https://你的中转域名/v1 换成后台显示的接入地址。两者都在本站后台「我的接入」页面获取。
C

配置 Claude Code设置两个环境变量,指向中转地址

1 写入环境变量(zsh)
把下面两行加到 ~/.zshrc,记得替换占位符。
# ~/.zshrc
export ANTHROPIC_BASE_URL="https://你的中转域名/v1"
export ANTHROPIC_API_KEY="YOUR_API_KEY"
2 让配置生效
source ~/.zshrc
3 启动
claude
1 设置环境变量(PowerShell)
永久写入当前用户,替换占位符后执行。
setx ANTHROPIC_BASE_URL "https://你的中转域名/v1"
setx ANTHROPIC_API_KEY "YOUR_API_KEY"
2 重开终端后启动
setx 写入后需重新打开终端才生效。
claude
1 写入环境变量(bash)
加到 ~/.bashrc,替换占位符。
# ~/.bashrc
export ANTHROPIC_BASE_URL="https://你的中转域名/v1"
export ANTHROPIC_API_KEY="YOUR_API_KEY"
2 生效并启动
source ~/.bashrc && claude
X

配置 Codex CLI编辑配置文件,指向中转地址

1 编辑配置文件
打开(没有就新建)~/.codex/config.toml,写入下面内容。
# ~/.codex/config.toml
model_provider = "relay"

[model_providers.relay]
name = "relay"
base_url = "https://你的中转域名/v1"
env_key = "CODEX_API_KEY"
2 设置密钥并启动
export CODEX_API_KEY="YOUR_API_KEY"
codex
1 编辑配置文件
路径为 C:\Users\你的用户名\.codex\config.toml,内容同 macOS。
# %USERPROFILE%\.codex\config.toml
model_provider = "relay"

[model_providers.relay]
name = "relay"
base_url = "https://你的中转域名/v1"
env_key = "CODEX_API_KEY"
2 设置密钥(PowerShell)并启动
setx CODEX_API_KEY "YOUR_API_KEY"
# 重开终端后:
codex
1 编辑配置文件
打开(没有就新建)~/.codex/config.toml,内容同 macOS。
# ~/.codex/config.toml
model_provider = "relay"

[model_providers.relay]
name = "relay"
base_url = "https://你的中转域名/v1"
env_key = "CODEX_API_KEY"
2 设置密钥并启动
export CODEX_API_KEY="YOUR_API_KEY"
codex
注意
配置里的 model_provider 名称要和 [model_providers.xxx] 一致。以本站后台说明为准,不同中转命名可能略有差异。
FAQ

常见问题

提示 401 / 鉴权失败怎么办?⌄
多半是 API Key 填错或没生效。检查是否替换了 YOUR_API_KEY、有没有多余空格,Windows 上 setx 后要重开终端。
命令 claude / codex 找不到?⌄
说明全局 npm 的 bin 目录不在 PATH 里。重开终端试试;仍不行的话用 npm config get prefix 查看路径并加入 PATH。
连接超时 / 请求很慢?⌄
确认 BASE_URL 用的是本站中转地址而不是官方地址。接入中转后无需再开代理,若同时开了代理反而可能冲突,关掉再试。
能同时用 Claude Code 和 Codex 吗?⌄
可以。两者配置互不影响,各自指向中转即可,用同一个 Key 还是不同 Key 以后台说明为准。
如何更新到最新版本?⌄
重新执行安装命令即可:npm install -g @anthropic-ai/claude-code 或 npm install -g @openai/codex。