知能API研发的一键配置 Anthropic Claude Code CLI 环境变量的跨平台工具。
注意
请先把.claude 文件夹下的setting.json文件删除
在开始之前,请确保你的电脑已安装 Git(建议 v2.40+),Claude Code 需要 Git 来管理代码仓库。
v2.40+
打开终端,运行以下命令:
git --version
如果能正常输出版本号(如下所示),说明已安装,可以跳过安装步骤:
git version 2.45.0
如果提示 git: command not found 或 'git' 不是内部或外部命令,说明尚未安装,请按照你的操作系统选择对应方式安装:
git: command not found
'git' 不是内部或外部命令
Windows:
方式一:命令安装(推荐)
打开 PowerShell,运行:
winget install --id Git.Git -e --source winget
安装完成后,重新打开终端,运行 git --version 验证。
方式二:手动下载安装
macOS:
方式一:使用 Homebrew 安装(推荐)
brew install git
方式二:在终端运行以下命令,系统会自动提示安装 Xcode 命令行工具(内含 Git):
xcode-select --install
Linux(Ubuntu / Debian):
sudo apt-get update sudo apt-get install -y git
安装完成后,运行 git --version 确认安装成功。
macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
Windows
irm https://claude.ai/install.ps1 | iex
winget install Anthropic.ClaudeCode
Windows 用户提示
如果提示 claude 不是内部或外部命令,需将安装路径加入 PATH,根据终端任选其一运行:
claude 不是内部或外部命令
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.local\bin", "User")
setx Path "%Path%;%USERPROFILE%\.local\bin"
执行后重新打开终端即可生效。 :::
PowerShell 无法启动 Claude?
如果 PowerShell 提示脚本执行策略错误,无法运行 claude.ps1,这是 PowerShell 的安全策略在阻止,不是 Claude 本身出问题。运行以下命令解除限制:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
执行后重新打开终端即可正常使用。
安装完成后验证:
claude --version
编程插件tokens消耗量很大,请注意tokens消耗
直接在终端运行对应命令,自动完成下载与安装。
提示
以下命令为一次性安装脚本,运行后脚本不会保留在电脑上。如需再次使用配置工具,请重新运行对应命令,无需提前下载或保存。
Linux / macOS
curl -fsSL https://cnb.cool/知能API/知能API_claude_code/-/git/raw/main/install.sh | bash
Windows PowerShell
iwr -useb https://cnb.cool/知能API/知能API_claude_code/-/git/raw/main/install.ps1 | iex
Windows CMD
curl -fsSL https://cnb.cool/知能API/知能API_claude_code/-/git/raw/main/install.cmd -o "%TEMP%\install.cmd" && call "%TEMP%\install.cmd"
快速安装失败?
若以上命令执行失败,请参阅下方「方式二:手动下载」进行手动安装。
适用于快速安装脚本无法运行的情况。配置工具开源仓库地址:
适用于快速安装脚本无法运行的情况。
配置工具开源仓库地址:
在仓库右侧 Release 区,点击最新版本(如 知能API Claude Code v1.8.0)进入下载页。
在附件列表中选择对应系统的插件下载,例如 Windows 选 windows-amd64.exe。
下载完成后即可按下方安装说明运行。
Windows 用户下载完成后可直接双击运行;Linux / macOS 用户需先 chmod +x 添加执行权限再运行(macOS 还需 xattr -cr 移除隔离标记),运行后即可跳到第二步进行配置。
chmod +x
xattr -cr
第一次配置,选择第一项「知能API 推荐配置」一键配置即可。
推荐配置已自动填好 Base URL 与各模型,只需粘贴你的 知能API 令牌(Auth Token)后回车。
API 连接验证成功、配置保存成功后会显示配置摘要,按回车退出。配置已保存到环境变量,重新打开终端后生效。
重新打开终端,输入 claude 后回车启动 Claude Code。
claude
启动后出现安全提示,选择 1. Yes, I trust this folder 回车即可使用 Claude Code。
1. Yes, I trust this folder
如果你想自定义 Base URL、令牌、模型等参数,可在模式选择界面选择「手动配置」,按提示逐项填写。
选择第二项「手动配置 URL / Token / 模型等」新增一套配置。
为本次配置取一个目录名称,便于后续管理多套配置。
填入 API 服务器地址:https://www.apexrouter.top。
https://www.apexrouter.top
粘贴你的 知能API 令牌,获取地址:https://www.apexrouter.top/token。
https://www.apexrouter.top/token
进入模型配置菜单,用上下键和回车选择要配置的模型项(默认 / Haiku / Sonnet / Opus),配置完成后按 ESC 或输入 q 保存退出。
进入某个模型项后,可从预设列表中选择模型(后缀 -cc 为 claude code 专区模型),也可选择最下方「自定义输入」。
选择「自定义输入」后手动输入模型名称(需在模型广场中能找到该模型)。
Agent Teams 功能尚不完善,建议选择「否」保持当前值不变。
选择「是」可将你配置的模型同步到 VSCode 插件。
可自定义提交时的 Git 署名,不需要可直接回车采用默认。
选择「是」将配置写入 VSCode settings.json,完成插件配置。
settings.json
出现配置摘要即表示配置完成,按回车结束。配置已保存到环境变量,重新打开终端后生效。
已保存的配置会出现在模式选择界面,可随时切换、编辑或删除。
选择你想使用的已保存配置进入管理界面。
可对配置执行:写入 settings.json 并应用到环境变量、编辑配置、删除配置。
选择「编辑此配置 修改 URL / Token / 模型 / 开关等」进入编辑界面。
编辑菜单可分别修改 URL / Token / 模型、effort 思考强度、Agent Teams、VSCode 插件、Git 与 PR 署名等。
© 2026 知能API Claude Code 配置教程文档