# Claude Code 复用安装包

把 Claude Code 装到 Linux 或 macOS，并指向 **OpenAI 兼容网关**（本例：`https://pro5000.cdxyl.online`，模型 `Qwen3.8-27B-FP8`）。

本目录可整体复制到其它电脑使用；**优先离线安装内置二进制**，写入配置也只用复制/`mv` 生成 `settings.json`，**不要求目标机有 Node.js / npm / python3**。

## 目录内容

| 文件 | 用途 |
|---|---|
| `install-claude-code.sh` | 一键安装（幂等，可重复执行） |
| `vendor/claude-linux-x64` | 内置 Linux x86_64 二进制（离线安装用） |
| `vendor/VERSION` | 内置二进制版本号 |
| `settings.example.json` | 配置模板 |
| `README.md` | 本说明 |

## 快速开始（另一台机器）

```bash
# 1. 把整个 claude-install 目录拷过去
# 2. 按需改密钥（或用环境变量，不必改文件）
cd claude-install
API_KEY='你的密钥' bash install-claude-code.sh

# 也可只改脚本顶部 GATEWAY_URL / API_KEY / MODEL_ID 再运行：
# bash install-claude-code.sh
```

脚本会：

1. 检查系统与参数  
2. **优先**把 `vendor/claude-<平台>` 拷到 `~/.local/bin/claude`；没有内置包时才用 npm 在线安装（默认淘宝镜像）  
3. 备份并用 `settings.example.json`（或按脚本变量生成）写入 `~/.claude/settings.json`，不安装任何依赖  
4. 发一条 `pong` 请求验证网关  

若某台机器脚本已装好二进制、只差配置，也可手动：

```bash
mkdir -p ~/.claude
cp settings.example.json ~/.claude/settings.json
chmod 600 ~/.claude/settings.json
```

安装后若当前终端提示 `claude: 未找到命令`（脚本改 PATH 不影响父 shell），任选其一：

```bash
export PATH="$HOME/.local/bin:$PATH"   # 立刻生效
source ~/.bashrc
# root 安装时脚本会链到 /usr/local/bin/claude，一般可直接敲 claude
```

## 安装优先级

1. **离线二进制**（推荐拷贝分发）：`vendor/claude-linux-x64`、`vendor/claude-linux-arm64`、`vendor/claude-darwin-arm64`、`vendor/claude-darwin-x64`  
2. **在线 npm**：需要 Node.js 18+ 和 npm；默认 registry `https://registry.npmmirror.com`  
   - 可用环境变量覆盖：`NPM_REGISTRY=https://registry.npmjs.org`  
   - 自动配置用户级前缀 `~/.npm-global`，避免 sudo / EACCES  

> 说明：官方 `curl https://claude.ai/install.sh` 在部分地区会跳到「区域不可用」页面；本包因此改为内置二进制 + npm 镜像方案。

## 为其它平台补充离线包

在一台能访问 npm 的机器上：

```bash
# 例：打包当前 Linux x64 二进制到 vendor/
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
# 安装后二进制通常在：
#   ~/.npm-global/lib/node_modules/@anthropic-ai/claude-code/bin/claude.exe
# 或 optional 包：
#   .../node_modules/@anthropic-ai/claude-code-linux-x64/claude
cp <上述路径> vendor/claude-linux-x64
chmod +x vendor/claude-linux-x64
# 把 package 版本写入 vendor/VERSION
```

macOS / ARM 同理，文件名改为 `claude-darwin-arm64` 等。

## 配置原理

| 环境变量 | 作用 |
|---|---|
| `ANTHROPIC_BASE_URL` | 网关地址 |
| `ANTHROPIC_AUTH_TOKEN` | API Key |
| `ANTHROPIC_MODEL` | 主模型名 |
| `ANTHROPIC_SMALL_FAST_MODEL` | 后台小快模型（本例与主模型相同） |
| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | 上下文窗口（填了可消除 "isn't recognized" 警告） |
| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 单次最大输出 token |

写入 `~/.claude/settings.json` 的 `env` 字段，Claude Code 启动时自动加载。

查网关真实窗口：

```bash
curl -s -H "Authorization: Bearer <key>" <url>/v1/models
```

看目标模型的 `max_input_tokens`。

## 验证

```bash
echo "say exactly: pong" | claude -p   # 应输出 pong
claude --version                         # 如 2.1.197 (Claude Code)
cat ~/.claude/settings.json
```

## 切换工作目录

Claude Code 以启动时的当前目录为工作区：

```bash
cd /opt && claude
claude --add-dir /opt          # 额外允许访问 /opt
# 会话内：/add-dir /opt   /status
```

## 常见问题

1. **找不到 claude**：`source ~/.bashrc`，或确认 `~/.local/bin`（离线）/ `~/.npm-global/bin`（npm）在 PATH 中。  
2. **"Model isn't recognized"**：配置 `CLAUDE_CODE_MAX_CONTEXT_TOKENS`（本例 131072）。  
3. **官方 install.sh 失败 / 区域不可用**：直接用本目录脚本，不要依赖 `claude.ai/install.sh`。  
4. **只有 Node、没有 npm**（Debian 常见）：优先用本包离线二进制；或安装完整 Node 发行版 / `apt install npm`。  
5. **401 / 403**：检查 key 与网关鉴权方式。  
6. **其它架构电脑**：按上文补齐对应 `vendor/claude-*` 后再拷贝。

## 安全

- `settings.json` 含明文 key，不要提交到 git 或随处传播。  
- `settings.example.json` 与脚本默认值为示例 key；分发前请换成自己的，或只用环境变量传入。  
- 换 key：改 `~/.claude/settings.json` 或重跑脚本。
