# Claude Code 复用安装包

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

## 目录内容

| 文件 | 用途 |
|---|---|
| `install-claude-code.sh` | 一键安装脚本（幂等，可重复执行） |
| `settings.example.json` | 配置模板（含本机当前生效的完整配置） |
| `README.md` | 本说明 |

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

```bash
# 1. 确保有 Node.js >= 18（建议 20+）
node -v || curl -fsSL https://deb.nodesource.com/setup_22.x | bash - && apt-get install -y nodejs

# 2. 改脚本顶部的三个变量（URL / API_KEY / MODEL_ID）
nano install-claude-code.sh

# 3. 跑
bash install-claude-code.sh
```

脚本会：检查 node → `npm i -g @anthropic-ai/claude-code`（含补跑被拦截的 postinstall）→ 写 `~/.claude/settings.json`（已有则先备份）→ 发一条 `pong` 最小请求验证。

## 配置原理

Claude Code 原生走 Anthropic 协议，但支持通过环境变量改指向：

| 环境变量 | 作用 |
|---|---|
| `ANTHROPIC_BASE_URL` | 网关地址（OpenAI 兼容网关需支持 Anthropic 协议适配） |
| `ANTHROPIC_AUTH_TOKEN` | 你的 apikey |
| `ANTHROPIC_MODEL` | 主模型名 |
| `ANTHROPIC_SMALL_FAST_MODEL` | 后台小快模型（本例与主模型相同） |
| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | 上下文窗口 token 数。**填了它，"isn't recognized" 的启动警告就消失**，且自动压缩按真实窗口触发（本例 131072） |
| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 可选，单次最大输出 token |

> 查网关真实窗口：`curl -s -H "Authorization: Bearer <key>" <url>/v1/models`，看目标模型的 `max_input_tokens`。

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

## 验证

```bash
echo "say exactly: pong" | claude -p        # 应输出 pong
claude --version                              # 应显示 2.x
cat ~/.claude/settings.json                   # 检查 env 四件套
```

## 切换工作目录（操作哪个目录）

Claude Code **以启动时的当前目录为工作目录**，所有文件读写都相对它。三种方式：

```bash
# 方式 1：先 cd 再启动（最常用）
cd /opt
claude

# 方式 2：启动参数直接指定
claude --add-dir /opt        # 额外允许访问 /opt（主目录仍是 cwd）

# 方式 3：会话内切换
# 进入 claude 后输入：
#   /add-dir /opt             # 把 /opt 加入本会话可操作目录
#   /status                   # 查看当前工作目录与模型
```

注意：
- `claude` 默认只允许操作**启动目录及其子目录**；要跨目录（比如人在 `~` 但要改 `/opt`），用 `--add-dir /opt` 或会话内 `/add-dir /opt`。
- 会话内 `/add-dir` 只对本次会话生效；要长期固定，就永远从目标目录启动，或在 `~/.claude/settings.json` 加 `"permissions": {"additionalDirectories": ["/opt"]}`。
- 安全：对 `/opt` 这种系统目录操作前，确认你知道自己在改什么；Claude Code 删文件前会询问。

## 常见问题

1. **"Model isn't recognized" 警告**：配置了 `CLAUDE_CODE_MAX_CONTEXT_TOKENS`（本例 131072，来自网关 `/v1/models` 的 `max_input_tokens`）后，启动警告消失，自动压缩也按真实窗口触发。若换了模型，重新查 `/v1/models` 更新该值。
2. **模型自称 "我是 Claude"**：系统提示词默认行为，实际跑的是网关后面的模型（本例 Qwen3.8-27B-FP8），别被话术误导。
3. **postinstall 被 npm 拦截**：脚本已用 `--allow-scripts=@anthropic-ai/claude-code` 补跑，一般不用管。
4. **401 / 403**：key 无效或网关鉴权方式不是 `Authorization: Bearer`，检查网关文档。
5. **超时**：`timeout 60` 可调大；内网网关慢时改成 120。

## 安全

- `settings.json` 里含明文 apikey，**不要**提交到 git 或发给别人。
- 本目录里的 `settings.example.json` 含真实 key（本机当前值），分发前请替换或删掉。
- 换 key 时直接改 `~/.claude/settings.json` 的 `ANTHROPIC_AUTH_TOKEN`，或重跑脚本。
