command not found: claude

没重开终端。关掉窗口、重新打开再运行。

提示 401 / 未授权

密钥填错或带了空格；确认变量名是 ANTHROPIC_AUTH_TOKEN（不是 API_KEY）。Key 是否以 sk- 开头、复制时有没有多空格，设置永久变量后要重开终端。

一直转圈 / 连接超时

检查地址正好是 https://api.dolinx.com，别多空格或结尾斜杠。

设了变量好像没生效

临时变量只对当前窗口有效；永久变量设置后要重开终端（Windows 尤其）。

完全退出软件再重新打开，让它重新读取环境变量。

客户端没有 Developer 菜单

先 Help → Troubleshooting → Enable Developer Mode，重启后才出现。

客户端连不上 / Gateway error

在填写第三方网关的页面里确认 base URL=https://api.dolinx.com、API key 正确、auth scheme=bearer。

Claude Code 安装配置教程

零基础上手（Mac / Windows）。从打开终端讲起，安装 Claude Code、设置环境变量接入 dolinx，分别讲解命令行、IDE 与 Claude 客户端三种用法。

Claude 相关工具先分清两种：
① Claude Code CLI：命令行工具，装在终端里用，也可以在 VS Code / Cursor 的集成终端里用；
② Claude 客户端：单独下载安装的桌面 App，在 App 里填写 dolinx 网关和 API Key，不需要设置终端环境变量。

如果你只想用 Claude 客户端，可以跳过安装 Claude Code 和设置环境变量，只做“获取 API Key”，然后直接看“用法三”。

⚡推荐

一键脚本，30 秒完成接入

先做下面第 ② 步拿到 API Key，再把密钥替换进下面这行命令执行。脚本会自动安装 Claude Code 并写好环境变量，替代 ① ③ 两步；如果已经安装，命令会自动跳过工具安装，只配置环境，重复运行安全。

# mac
curl -fsSL https://dolinx.com/install.sh | bash -s -- --claude-key sk-你的Claude密钥

# windows
$env:CLAUDE_KEY="sk-你的Claude密钥"; irm https://dolinx.com/install.ps1 | iex

脚本详情见接入文档 STEP 0；想手动理解每一步，就按下面的教程继续。

终端是什么

“终端”（也叫命令行、Terminal、PowerShell）是一个可以输入文字命令操作电脑的小窗口。安装和启动 Claude Code，就是在里面粘贴几行命令、按回车。你不需要懂编程，会复制、粘贴、回车就行。

复制粘贴小提示：终端里 Mac 用 Command + V 粘贴，Windows 用 Ctrl + V 或鼠标右键粘贴。粘贴后按回车执行。

怎么打开终端

Mac：按 ⌘ + 空格 打开 Spotlight，输入“终端”（或 Terminal）回车。
Windows：点开始菜单，输入 PowerShell，点击 Windows PowerShell 打开。

① 安装 Claude Code

Claude Code 是 Anthropic 官方命令行工具。把对应你系统的命令整段复制进终端回车，等它装完即可。Mac / Linux：

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

Mac 也可以 brew install --cask claude-code。Windows（PowerShell）：

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

装好后关掉终端重开一个，输入 claude --version 显示版本号即成功。

② 获取 API Key

打开 dolinx 控制台注册 / 登录。
进入控制台，找到左侧「API密钥」页面。
点「创建密钥」，创建后复制以 sk- 开头的密钥。

这串 sk- 密钥相当于密码，不要发给别人，也不要贴到公开仓库、截图或群聊里。

③ 设置环境变量（临时 / 永久）

只用 Claude 客户端 的话本步可跳过，直接看用法三。环境变量只服务 CLI / IDE 集成终端。

给电脑记两条：去哪里连（地址）+ 你的密钥。Claude Code 启动时会自动读。

变量名	填什么
`ANTHROPIC_BASE_URL`	`https://api.dolinx.com`
`ANTHROPIC_AUTH_TOKEN`	你刚复制的 `sk-` 密钥

临时 vs 永久：
临时变量只在当前终端窗口有效，关掉窗口就没了，适合先测试；永久变量会写进系统配置，以后每次新开终端都自动生效，适合长期使用。

Mac / Linux · 临时（当前终端）/ 永久：

# 临时（当前终端，把 sk-*** 换成你的密钥）
export ANTHROPIC_BASE_URL=https://api.dolinx.com
export ANTHROPIC_AUTH_TOKEN=sk-***

# 永久
echo 'export ANTHROPIC_BASE_URL=https://api.dolinx.com' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-***' >> ~/.zshrc
source ~/.zshrc

如果你用的是老款 bash，把上面的 ~/.zshrc 换成 ~/.bashrc。

Windows（PowerShell） · 临时 / 永久：

# 临时（当前窗口）
$env:ANTHROPIC_BASE_URL = "https://api.dolinx.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-***"

# 永久（设置后重开终端）
setx ANTHROPIC_BASE_URL "https://api.dolinx.com"
setx ANTHROPIC_AUTH_TOKEN "sk-***"

不想敲命令也行：开始菜单搜“编辑账户的环境变量”，新建上面两个变量保存即可。

④ 开始使用（三种用法）

用法一、二共用上面的环境变量；用法三在 Claude 客户端内单独配置。

用法一：命令行（CLI）

如果第 ③ 步用的是永久方式（setx 或写入 ~/.zshrc），请新开一个终端窗口再运行。永久变量只在新打开的终端里生效；临时方式则在刚才那个窗口直接运行。

进入你的项目文件夹并启动：

cd ~/your-project
claude

看到对话界面就成功了，直接用中文说需求。常用命令：

/init     生成项目记忆文件 CLAUDE.md
/model    切换模型（Opus / Sonnet / Haiku）
/clear    清空当前对话上下文
/status   查看当前模型与连接状态

用法二：在 IDE 里使用（VS Code / Cursor）

想边写代码边对话，推荐直接用 IDE 自带的集成终端运行 claude，不用装任何插件。

用「打开文件夹」打开你的项目。
打开集成终端：顶部菜单终端 / Terminal → 新建终端，或按 Ctrl + `（反引号，键盘左上角 Esc 下方）。
在这个终端里直接运行 claude 即可——不用装任何插件。

Cursor 是基于 VS Code 的，终端菜单和快捷键基本相同。若 IDE 在你设置环境变量之前就开着，请完全退出再重新打开，它才会读到新变量。

用法三：在 Claude 客户端中使用

指 Claude 桌面客户端（claude.ai/download，Mac / Windows 版）。

先开启开发者模式：菜单栏 Help → Troubleshooting → Enable Developer Mode。开启后 App 可能重启，顶部出现 Developer 菜单。
打开 Developer → Configure third-party inference（这里就是填写第三方网关的入口）。
在 Connection 下拉里选 Gateway，在下方 GATEWAY CREDENTIALS 里填：

Gateway base URL	`https://api.dolinx.com`
Gateway API key	你的 `sk-` 密钥
Gateway auth scheme	`bearer`
Credential kind（如有）	Static API key（静态密钥）

Claude 桌面客户端 Configure third-party inference 的 Connection 界面，Connection 选择 Gateway，并填写 Gateway base URL、Gateway API key、Gateway auth scheme 和 Credential kind — Claude 客户端 Developer → Configure third-party inference → Connection 界面

点 Apply locally（保存到本机）→ App 重启进入使用第三方网关的模式 → 登录页选 Start in Cowork on 3P 开始使用。

模型列表会从中转自动拉取，通常只显示可识别为 Claude 的模型。如果列表为空，回头检查 Gateway base URL、API key 和 auth scheme 是否填对。

遇到问题怎么办

现象	怎么解决
`command not found: claude`	没重开终端。关掉窗口、重新打开再运行。
提示 401 / 未授权	密钥填错或带了空格；确认变量名是 `ANTHROPIC_AUTH_TOKEN`（不是 API_KEY）。Key 是否以 `sk-` 开头、复制时有没有多空格，设置永久变量后要重开终端。
一直转圈 / 连接超时	检查地址正好是 `https://api.dolinx.com`，别多空格或结尾斜杠。
设了变量好像没生效	临时变量只对当前窗口有效；永久变量设置后要重开终端（Windows 尤其）。
VS Code 读不到	完全退出软件再重新打开，让它重新读取环境变量。
客户端没有 Developer 菜单	先 `Help → Troubleshooting → Enable Developer Mode`，重启后才出现。
客户端连不上 / Gateway error	在填写第三方网关的页面里确认 base URL=`https://api.dolinx.com`、API key 正确、auth scheme=bearer。

FAQ · 还有关于Claude Code 的其他问题？

Claude 和 OpenAI 的变量能混用吗？+

不要混用。Claude Code 读 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN；Codex、Cline、Cherry Studio 这类 OpenAI 兼容工具才读 OPENAI_BASE_URL 或 config.toml 里的 base_url。

为什么 Claude Code 一直跳官方登录页？+

多半是之前登录过官方 OAuth，或者环境变量没被当前终端读到。先运行 claude /logout，再确认变量设置正确，关闭终端重开后再运行 claude。

VS Code / Cursor 里运行 claude 读不到 Key 怎么办？+

IDE 常常在启动时读取环境变量。先完全退出 VS Code / Cursor，再重新打开项目和集成终端；或者直接在系统终端里进入项目目录运行 claude。

/agents、/skills、hooks、MCP 这些功能还能用吗？+

能用。这些主要是 Claude Code 客户端本地功能，dolinx 只负责模型请求的中转，不会关掉 /agents、/skills、hooks、MCP 等能力。

用 dolinx 中转，我自己的 Anthropic / OpenAI 账号会被封吗？+

不会用到你的官方个人账号。你在客户端里填的是 dolinx 的 Base URL 和 API Key，请求通过 dolinx 的中转链路走上游，和你的 Anthropic / OpenAI 个人登录账号分开。