全部教程Claude Code 拼车配置完整教程(macOS / Linux / Windows)

Claude Code 拼车配置完整教程(macOS / Linux / Windows)

我是 Quentin,OpenClaw 作者,OpenClaw 拼车的维护者。

这篇是 Claude Code 接入 cp.bizq.net 官方拼车的完整步骤:从 Node.js 准备、清理掉以前装过的中转 CLI、装原生 Claude Code,到把 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN 写进 shell 配置永久生效。

如果你只想最快跑起来,跳到 一键路径 就行:一行命令,30 秒完成。这篇主要给愿意手动配置、想理解每一步在做什么的同学。

一行命令完成所有事:

curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x

0. 一键路径

适合:只想快速跑起来,不关心内部细节。

curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x

setup.sh 做的事:

  1. 检查 Node.js(不够就装)
  2. 卸载已经装过的中转 CLI(如有)
  3. 装原生 Claude Code
  4. 写入 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN~/.bashrc / ~/.zshrc
  5. 打印验证步骤

跑完直接 claude 就能用。如果你想看每一步在做什么,继续往下读。


1. 安装 Node.js(如已装可跳过)

Claude Code 依赖 Node.js ≥ 18.0。先检查:

node --version

输出 v18.x 或更高就可以跳过本节。

Ubuntu / Debian

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs
node --version

macOS

sudo xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node
node --version

Windows

推荐用 Node.js 官方安装包,下 LTS 版本即可。装完打开 PowerShell:

node --version

2. 卸载已有的中转 CLI(可选但强烈推荐)

这步最容易被忽略,但 80% 的”配置好了但跑不通”问题都出在这里。

如果你之前装过任何形式的中转/代理 CLI(很多论坛教程会推),先彻底卸干净,否则会和 Claude Code 原生版冲突,环境变量被劫持。

检查是否本地装过

npm ls @anthropic-ai/claude-code

检查是否全局装过

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

卸载

# 本地
npm uninstall @anthropic-ai/claude-code
# 全局
npm uninstall -g @anthropic-ai/claude-code

如果你之前用过其他名字的中转 CLI,搜 npm ls -g | grep -i claude 找出来一并卸掉。

清理深度推荐顺手把本地缓存也归档一下,参考 清理本地 Claude Code 缓存 那篇。


3. 安装原生 Claude Code

只装 Anthropic 官方版

macOS / Linux —— Homebrew(最稳)

brew install --cask claude-code

macOS / Linux / WSL —— 官方 install.sh

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

Windows —— PowerShell

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

npm 全局(任何平台)

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

装完验证:

claude --version

输出版本号(类似 1.x.x)就成。


4. 拿到拼车凭证

加 OpenClaw 拼车微信群,群主会发:

  • ANTHROPIC_AUTH_TOKEN:形如 cr_... 的一串字符
  • ANTHROPIC_BASE_URL:默认是 https://cp.bizq.net(或群主指定的具体连接点)

档位按团队规模定制(单人 / 小团队 / 企业),微信咨询


5. 第一次跑起来(临时环境变量)

到任意项目目录下:

cd your-project-folder
export ANTHROPIC_AUTH_TOKEN=cr_xxxxxxxxxxxxxxxxxxxxxxxx
export ANTHROPIC_BASE_URL=https://cp.bizq.net
claude

第一次启动会问你几个东西,全部默认即可:

  1. 选主题 → Enter
  2. 安全须知 → Enter
  3. Terminal 配置 → Enter
  4. 信任工作目录 → Enter

然后就是一个交互式提示符,输入:

你是什么模型?

应该回答 Claude Sonnet 4.6Claude Opus 4.6。代表整条链路都通了。


6. 永久生效(写入 shell 配置)

export 只在当前 shell 有效。每次开新窗口都要重写一遍肯定不行。把它们写进 shell 启动文件,开终端自动加载。

macOS / Linux —— bash

cat <<'EOF' >> ~/.bashrc
 
# Claude Code via OpenClaw 拼车
export ANTHROPIC_AUTH_TOKEN="cr_xxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://cp.bizq.net"
EOF

~/.bash_profile 同理(macOS 默认 login shell 走 bash_profile,所以两个都加最稳):

cat <<'EOF' >> ~/.bash_profile
 
# Claude Code via OpenClaw 拼车
export ANTHROPIC_AUTH_TOKEN="cr_xxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://cp.bizq.net"
EOF

macOS / Linux —— zsh(macOS 默认)

cat <<'EOF' >> ~/.zshrc
 
# Claude Code via OpenClaw 拼车
export ANTHROPIC_AUTH_TOKEN="cr_xxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://cp.bizq.net"
EOF

写完之后 reload:

source ~/.zshrc   # 或 ~/.bashrc

或者直接关掉终端重开。

Windows —— CMD(临时)

set ANTHROPIC_BASE_URL=https://cp.bizq.net
set ANTHROPIC_AUTH_TOKEN=cr_xxxxxxxxxxxx
cd your-project-folder
claude

CMD 这种写法只在当前会话生效。要永久就走 PowerShell 或图形界面。

Windows —— PowerShell(临时)

$env:ANTHROPIC_BASE_URL="https://cp.bizq.net"
$env:ANTHROPIC_AUTH_TOKEN="cr_xxxxxxxxxxxx"
cd your-project-folder
claude

Windows —— PowerShell Profile(永久)

打开 PowerShell:

notepad $PROFILE

如果文件不存在 PowerShell 会问你要不要创建,选是。在末尾追加:

$env:ANTHROPIC_AUTH_TOKEN = "cr_xxxxxxxxxxxx"
$env:ANTHROPIC_BASE_URL   = "https://cp.bizq.net"

保存关闭,重启 PowerShell 生效。

Windows —— 系统环境变量(图形)

Win + Rsysdm.cpl → 高级 → 环境变量 → 用户变量”新建”两条:

名称
ANTHROPIC_AUTH_TOKENcr_xxxxxxxxxxxx
ANTHROPIC_BASE_URLhttps://cp.bizq.net

注销重登或重启后生效。这个写法所有 shell(CMD / PowerShell / Git Bash)都能读到。


7. 日常使用

环境变量写好之后日常就这样:

cd ~/code/your-project
claude

用得最多的几个内置命令:

> /help          查看所有指令
> /model sonnet  切换模型
> /clear         清空当前会话
> /init          为当前项目生成 CLAUDE.md

推荐:项目级 CLAUDE.md

每个仓库根目录放一份 CLAUDE.md,写清楚约束(语言、风格、不要碰的目录、commit 规则)。Claude Code 启动时自动读。具体写法见 CLAUDE.md 约束提示词指南


8. 验证 & 排错

如果某一步不对,按这个清单排:

检查环境变量真的注入了

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

输出空 = shell 配置文件没 reload,或者写到了错的文件(比如 macOS 默认 zsh 但你写到 bashrc)。

检查 claude 命令在哪

which claude

如果是某个奇怪路径(比如 /usr/local/bin/claude 但你只装在 ~/.local),说明 PATH 里有旧版残留,回到 第 2 步 再清一遍。

检查请求真的发到拼车网关

启动时加 --debug

claude --debug

观察请求 URL 必须以 https://cp.bizq.net 开头。如果是别的域名说明 ANTHROPIC_BASE_URL 被某处覆盖了。

Token 失效循环

突然出现持续登录失败、token 过期:先核弹清理 + 重跑 setup.sh:

# macOS/Linux
mv ~/.claude       ~/.claude-bak-$(date +%s)
mv ~/.claude.json  ~/.claude.json-bak-$(date +%s)
 
curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x

详细的清理方案见 清理本地 Claude Code 缓存和配置


9. 我自己的最佳实践

跑了半年多沉淀的几条:

  1. 每个项目单独 export,不要全局污染。某些项目要走专属 token(比如客户隔离)时直接 direnv + .envrc 就行
  2. CLAUDE.md 永远 commit 进仓库。提示词版本化是 2026 年最有价值的工程实践之一
  3. token 紧张时切到 Haiku 4.5,便宜 10 倍且日常足够
  4. bashrc/zshrc 改完一定 reload 再测,别假定它生效了
  5. 每月跑一次 ccclear,避免本地 ~/.claude/ 越积越大拖慢启动

立即开始

一行命令把上面所有事自动做完:

curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x

具体团队规模与 token 档位微信咨询


相关文章