> ## 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 覆蓋。

## 下一步

* [多供應商總覽](/zh-Hant/vscode/providers/overview)
* [檢測與安裝](/zh-Hant/vscode/providers/cli)
* [執行模式與許可權](/zh-Hant/vscode/chat/modes)
* [MCP](/zh-Hant/vscode/customize/mcp)
* [Skills](/zh-Hant/vscode/customize/skills)