# Claude Code 功能可用性对照

Claude Code 的一部分能力来自**本地 CLI**，另一部分来自 **Anthropic 账号侧的托管服务**。
用第三方 API Key（包括 QCode）时，前者照常工作，后者不行。这页把边界写清楚，省得你排查半天。

> **依据说明**：下表「依据」列区分 **实测**（我们真跑过）与 **推断**（按产品形态判断，未实测）。
> 不要把推断当结论——如果某项对你很关键，请自己验证一次。

## 对照表

| 功能 | QCode Key 下 | 依据 |
|------|:---:|------|
| CLI 核心：对话、读写文件、Bash、MCP、Skills、Plugins、子代理 | ✅ | **实测**：`claude -p` 正常返回；创建文件成功 |
| 权限模式 `bypassPermissions` | ✅ | **实测**：同一任务成功落盘 |
| 权限模式 `acceptEdits` / `manual` / `plan` / `dontAsk` | ✅ | **推断**：均为本地决策逻辑，不依赖托管分类器 |
| 权限模式 **`auto`（自动模式）** | ❌ | **实测**：`--permission-mode auto` 下 Write 与 Bash **全部被拒**；同端点同任务换 `bypassPermissions` 立刻成功（对照实验） |
| `claude ultrareview` / `/ultrareview` | ❌ | **实测**：返回 `Ultrareview could not launch: Ultrareview is currently unavailable.` |
| `claude setup-token` | ❌ | **实测**：CLI 帮助文本写明 `requires Claude subscription` |
| 云端会话 / Claude Code on the web / 移动端 | ❌ | **官方**：Slack 与云端会话永远直连 Anthropic API、不经网关，见 [llm-gateway-connect](https://code.claude.com/docs/en/llm-gateway-connect) |
| Remote Control | ❌ | **官方**：网关配置生效时不可用；`ANTHROPIC_BASE_URL` 指向非 Anthropic 主机时同样被禁用，见同上文档 |
| 语音听写 | ❌ | **官方**：依赖 claude.ai 身份与转录端点，`ANTHROPIC_API_KEY` / `ANTHROPIC_AUTH_TOKEN` 生效期间不可用，见同上文档 |
| Artifacts（会话产出发布到 claude.ai） | ❌ | **推断**：claude.ai 账号侧功能 |
| Self-hosted environments | ❌ | **推断**：Team / Enterprise 计划功能 |
| Claude in Chrome 扩展 | ❌ | **推断**：绑定 Anthropic 计划 |
| Claude Code Desktop（本地会话） | ⚠️ 未测 | **推断**：桌面端调用的是同一个本地 CLI，理论上继承同一份配置 |

## 为什么 auto 模式用不了

`auto` 模式靠一个**托管分类器**替你判断每个操作该不该放行。第三方 Key 下拿不到这个分类器，
于是它的表现不是"放行一切"，而是**拒绝一切**——你会看到 Write 和 Bash 全被挡，
连 `echo` 都执行不了。

**这不是 QCode 的问题**，换任何第三方端点都一样。我们做过对照：同一个端点、同一个任务，
只把 `--permission-mode` 从 `auto` 换成 `bypassPermissions`，文件立刻创建成功。

**替代方案**：日常用 `acceptEdits`（编辑自动、命令仍问），隔离环境里用 `bypassPermissions`。

```bash
# 日常
claude --permission-mode acceptEdits

# 隔离环境 / CI（谨慎）
claude --permission-mode bypassPermissions
```

## 把 QCode 配好

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_你的QCode密钥"
claude -p "reply with exactly: OK"
```

返回 `OK` 即接通。详见 [环境变量配置](/docs/getting-started/environment)。

## 这张表会过时

Claude Code 每周发版，能力边界随时变。**看到与本页不符的行为，以你的实测为准**，
并欢迎反馈到 **hi@qcode.cc**，我们会更新本页。

## 相关文档

- [环境变量配置](/docs/getting-started/environment)
- [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths)
- [Claude Code 完整教程](/docs/getting-started/claude-code-tutorial)
- [故障排查指南](/docs/reference/troubleshooting)