> ## 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.

# 發出第一條訊息

> 選一個供應商、配好憑證，在 JetBrains IDE 裡完成第一次 CC GUI 對話。

環境就緒後，用一條最短路徑驗證外掛能工作：開啟工具視窗 → 選供應商 → 配憑證 → 發一條訊息。

## 開啟工具視窗

任選一種方式：

* 點右側工具視窗條的 **CCG**
* **Find Action** 搜尋並執行開啟 / 聚焦 CC GUI 相關動作
* 編輯器選中程式碼後按 `Cmd+Alt+K`（Windows / Linux 為 `Ctrl+Alt+K`）

建議先開啟一個真實專案。沒有專案時，檔案引用和工作目錄都會缺上下文。

## 選擇供應商

在輸入框底部開啟供應商選擇器，先選一個：

| 目標          | 選誰                              | 還缺什麼                      |
| ----------- | ------------------------------- | ------------------------- |
| 最快驗證        | **Claude Code**                 | API Key，或授權本地 / CLI 登入    |
| 走 OpenAI 生態 | **Codex**                       | Codex 供應商，或授權 `~/.codex/` |
| 本機 CLI      | **Kimi / Grok / OpenCode / Pi** | 對應命令已在 PATH 上             |

第一次建議用 Claude Code。各引擎單獨說明見 [供應商 / CLI](/zh-Hant/jetbrains/providers/overview)。

## 配好憑證

開啟 **設定** → **供應商管理**。

<Tabs>
  <Tab title="Claude Code">
    三種常見接法：

    1. **新增供應商**：填名稱、API Key、Base URL。官方直連用 `https://api.anthropic.com`。
    2. **使用本地 settings.json**：授權讀取 `~/.claude/settings.json`。外掛不會改這個檔案。
    3. **使用 CLI 登入資訊**：你已經在終端登入過 Claude CLI 時用這個。

    智譜、Kimi、DeepSeek、MiniMax、OpenRouter 等第三方走「第三方 / 代理預設」。
  </Tab>

  <Tab title="Codex">
    開啟 **Codex** 子頁：

    1. 新增供應商，配置會寫入 `~/.codex/`。
    2. 或授權讀取本地 `config.toml` 和 `auth.json`。
    3. 訂閱制賬號可先在終端執行 `codex login`，再重啟 IDE。
  </Tab>

  <Tab title="本機 CLI">
    開啟 **CLI** 子頁，確認目標工具顯示 **已安裝**。未安裝時按對應引擎頁安裝，再點 **重新檢測**。見 [檢測與安裝](/zh-Hant/jetbrains/providers/cli)。
  </Tab>
</Tabs>

<Warning>
  API Key 只存在你這臺電腦上。截圖或錄屏前先打碼。
</Warning>

## 發一條最短的訊息

回到對話檢視，在輸入框寫：

```text theme={null}
用一句話介紹當前專案的技術棧。
```

按 `Enter` 傳送。如果傳送快捷鍵改成了 `Cmd/Ctrl+Enter`，按那個組合鍵。

正常時你會看到：

1. 使用者訊息出現在對話區
2. 狀態變為思考或工具執行
3. 助手開始流式回覆

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/jetbrains/first-chat.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=fe99061057e42257dfa48a9da1e81c8e" alt="第一次對話" width="100%" data-path="images/jetbrains/first-chat.png" />

## 第一次就可以試的引用

把編輯器裡的一段程式碼送給 CC GUI：

1. 選中幾行
2. 右鍵選傳送選區到 CC GUI，或按 `Cmd+Alt+K`（Windows / Linux 為 `Ctrl+Alt+K`）
3. 輸入框會出現 `@檔案路徑#L起始-結束`
4. 補一句「解釋這段程式碼」，再傳送

也可以從專案樹右鍵檔案，選傳送檔案路徑到輸入框。

## 如果沒有回覆

| 提示            | 原因                     | 下一步                                                                                                                                              |
| ------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| SDK 尚未安裝      | Claude / Codex SDK 沒裝好 | [準備環境](/zh-Hant/jetbrains/start/setup)                                                                                                           |
| Node.js 版本不支援 | 外掛用的 Node 低於 18        | 設定 → 基礎配置 → 環境                                                                                                                                   |
| 未配置供應商        | 當前執行時沒有可用憑證            | [Claude Code](/zh-Hant/jetbrains/providers/claude)、[Codex](/zh-Hant/jetbrains/providers/codex) 或 [多供應商總覽](/zh-Hant/jetbrains/providers/overview) |
| CLI 未安裝       | 本機找不到對應二進位制            | [檢測與安裝](/zh-Hant/jetbrains/providers/cli)                                                                                                        |
| 許可權彈窗一直停著     | 當前是預設模式，在等你確認          | [執行模式與許可權](/zh-Hant/jetbrains/chat/modes)                                                                                                        |

更多排障見 [常見問題](/zh-Hant/jetbrains/community/faq)。

## 下一步

* [看懂介面](/zh-Hant/jetbrains/start/interface)
* [對話區域](/zh-Hant/jetbrains/chat/overview)
* [輸入框](/zh-Hant/jetbrains/chat/input)