> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mossx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> 为 Claude Code 配置官方直连、第三方代理、本地 settings.json 或 CLI 登录。

Claude Code 是功能最完整的运行时：四种模式、MCP、Skills、规划审批和完整权限弹窗都从这里走。

先在 **设置 → SDK 依赖** 装好 Claude Agent SDK，再来配供应商。

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/vscode/provider-claude.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=e3059b70a5531c2ecee6b18c0a81a27a" alt="Claude 供应商页" width="100%" data-path="images/vscode/provider-claude.png" />

## 四种接入方式

### 1. 添加供应商（最常见）

点 **添加供应商**，填：

* 供应商名称
* API Key
* 请求地址（官方直连固定为 `https://api.anthropic.com`）
* 可选：主模型、Haiku / Sonnet / Opus / Fable 映射、自定义模型

有可视化表单和 JSON 两种编辑方式。JSON 可写完整 `settings.json` 字段。

官方直连会把请求发到 Anthropic。第三方预设立刻把请求转到对应代理端点。

内置预设包括智谱 GLM、Kimi、DeepSeek、MiniMax、Xiaomi MiMo、阿里千问、OpenRouter、百炼、LongCat、OpenCode Go 等。选预设后仍要填自己的 Key。

<Note>
  这些配置只存在你的电脑上。扩展不会把 Key 上传到 CC GUI 自己的服务器。
</Note>

### 2. 使用本地 settings.json

适合已经在维护 `~/.claude/settings.json` 的人。

* 扩展默认**不读**这个文件
* 你点 **授权并启用** 后，才读取一次
* 扩展不修改该文件
* 可随时取消授权；取消后 Claude 会处于未启用状态，直到你启用其他供应商

如果授权后仍提示没有可用配置，检查文件里是否真有 API Key 或请求地址。

### 3. 使用 CLI 登录信息

适合 Claude 订阅制账号：

1. 在系统终端登录 Claude CLI，并确认能提问
2. 确保 `~/.claude/settings.json` 的 `env` 为空
3. 在 CC GUI 授权「使用 CLI 登录信息」
4. 如有问题，重启 VS Code

走不通时，可把本地 `env` 临时写成代理：

```json theme={null}
{
  "env": {
    "HTTP_PROXY": "http://127.0.0.1:7897",
    "HTTPS_PROXY": "http://127.0.0.1:7897"
  }
}
```

仍失败就到 [GitHub Issues](https://github.com/hpstream/vscode-cc-gui/issues) 反馈。

### 4. 从其他工具导入

供应商页支持：

* 从 cc-switch 数据库或 CLI 导入
* 从 Claude Code Router 导入

导入前会列出新增和更新项，确认后再写入。编辑 cc-switch 来源的配置不会回写 cc-switch，再次导入还可能覆盖；建议先转成扩展本地配置再改。

## 模型

输入框底部的模型选择器列出当前供应商的模型。自定义模型排在最前。

**设置 → 供应商管理** 里还可以给已有模型补价格（美元 / 百万 tokens），供使用统计估算费用。由供应商或 `settings.json` 提供的模型只能改价格，不能在这里删掉。

## 工作目录和 CLI 覆盖

在 **设置 → 基础配置 → 环境**：

* **工作目录**：相对工作区根或绝对路径。留空则用工作区根
* **Claude CLI 路径（覆盖）**：指定后，扩展启动该二进制，而不是内置 SDK。保存会重启守护进程

大多数人不用填 CLI 覆盖。

## 下一步

* [多供应商总览](/vscode/providers/overview)
* [检测与安装](/vscode/providers/cli)
* [运行模式与权限](/vscode/chat/modes)
* [MCP](/vscode/customize/mcp)
* [Skills](/vscode/customize/skills)