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

# Claude Code

> 在 Claude Code 中接入Token Plan 进行 AI 编程。

## 概述

[Claude Code](https://docs.claude.com/en/docs/claude-code) 是 Anthropic 官方推出的终端内 AI 编程助手，通过自然语言交互帮助开发者更快地编写、调试和管理代码。本文将指导你把 SenseAudio [Token Plan](https://senseaudio.cn/tokenplan) 接入 Claude Code，直接在熟悉的 CLI 中调用 Claude 模型。

<CardGroup cols={2}>
  <Card title="终端原生体验" icon="terminal">
    无需切换窗口，直接在命令行中完成编码、调试与重构。
  </Card>

  <Card title="多模型灵活切换" icon="arrows-repeat">
    支持 Sonnet、Opus、Haiku 全系列，按场景选择最合适的模型。
  </Card>

  <Card title="项目上下文感知" icon="folder-tree">
    自动读取工作目录文件，理解项目结构后再给出建议。
  </Card>

  <Card title="安全受控执行" icon="shield-check">
    首次访问需手动信任文件夹，避免误操作本地代码。
  </Card>
</CardGroup>

## 前提条件

<Check>已订阅 SenseAudio [Token Plan](https://senseaudio.cn/tokenplan)</Check>
<Check>已安装 [Node.js 18 或更新版本](https://nodejs.org/en/download/)</Check>
<Check>Windows 用户需额外安装 [Git for Windows](https://git-scm.com/install/windows)</Check>

## 安装 Claude Code

<Steps>
  <Step title="一键安装">
    在终端中执行以下命令：

    ```bash theme={null}
    npm install -g @anthropic-ai/claude-code
    ```
  </Step>

  <Step title="验证安装">
    执行以下命令查看版本信息，若正常输出版本号则表示安装成功：

    ```bash theme={null}
    claude --version
    ```
  </Step>
</Steps>

<Note>
  更多安装细节与进阶用法请参考 [Claude Code 官方文档](https://docs.claude.com/en/docs/claude-code/setup)。
</Note>

## 配置 Token Plan

Claude Code 通过读取环境变量与本地配置文件接入 SenseAudio Token Plan，无需修改任何代码。

<Steps>
  <Step title="配置环境变量">
    从控制台 [API Key 管理](https://senseaudio.cn/api-platform/api-key) 获取你的 **Token Plan API Key**，然后根据操作系统选择对应配置方式。

    <Tabs>
      <Tab title="macOS / Linux">
        将以下内容追加到 `~/.zshrc`（zsh 用户）或 `~/.bashrc`（bash 用户）：

        ```bash theme={null}
        export ANTHROPIC_BASE_URL="https://api.senseaudio.cn"
        export ANTHROPIC_AUTH_TOKEN="<your-api-key>"
        export ANTHROPIC_API_KEY="<your-api-key>"
        ```

        保存后执行以下命令使配置生效（或重新打开终端）：

        ```bash theme={null}
        source ~/.zshrc   # zsh 用户
        source ~/.bashrc  # bash 用户
        ```
      </Tab>

      <Tab title="Windows">
        按 `Win + R`，输入 `sysdm.cpl` 回车，依次点击 **高级** → **环境变量**，在 **用户变量** 区域点击 **新建**，依次添加：

        | 变量名                    | 变量值                         |
        | ---------------------- | --------------------------- |
        | `ANTHROPIC_BASE_URL`   | `https://api.senseaudio.cn` |
        | `ANTHROPIC_AUTH_TOKEN` | `<your-api-key>`            |
        | `ANTHROPIC_API_KEY`    | `<your-api-key>`            |

        添加完成后，重新打开终端使配置生效。
      </Tab>
    </Tabs>
  </Step>

  <Step title="编辑或创建 Claude Code 的配置文件">
    * **macOS / Linux**：`~/.claude/settings.json`
    * **Windows**：`用户目录/.claude/settings.json`

    将下方配置中 `ANTHROPIC_AUTH_TOKEN` 的值替换为你的 SenseAudio API Key。
    环境变量 `ANTHROPIC_AUTH_TOKEN` 和 `ANTHROPIC_BASE_URL` 的优先级高于配置文件。

    ```json theme={null}
    {
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.senseaudio.cn",
        "ANTHROPIC_AUTH_TOKEN": "SENSEAUDIO_API_KEY",
        "API_TIMEOUT_MS": "3000000",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
        "ANTHROPIC_MODEL": "senseaudio-s2",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "senseaudio-s2",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "senseaudio-s2",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "senseaudio-s2"
      }
    }
    ```
  </Step>

  <Step title="跳过 Onboarding">
    编辑或新建 `.claude.json` 文件，将 `hasCompletedOnboarding` 字段设置为 `true`，可跳过首次启动时的引导流程。

    * **macOS / Linux**：`~/.claude.json`
    * **Windows**：`C:\Users\<用户名>\.claude.json`

    ```json theme={null}
    {
        "hasCompletedOnboarding": true
    }
    ```
  </Step>
</Steps>

<Info>
  **还没有 API Key？** 请先订阅 [Token Plan](https://senseaudio.cn/tokenplan)，然后在控制台 **账户管理 → Token Plan** 创建专属 API Key。套餐额度用尽或达到限制后，可开启 **Extra Usage**，超出部分将自动按量计费、从账户余额扣费。
</Info>

## 开始使用

配置完成后，进入项目目录并执行 `claude` 命令即可启动 Claude Code：

```bash theme={null}
cd my-project
claude
```

启动后选择 **信任此文件夹 (Trust This Folder)**，允许 Claude Code 访问该目录下的文件。

<Frame>
  <img src="https://mintcdn.com/sa-5efeb1e4/2uwj4t1TiXTu6X9i/images/token-plan/cc-trust-folder.png?fit=max&auto=format&n=2uwj4t1TiXTu6X9i&q=85&s=172dcf7d7c90da0c1b8dfbf97331477d" alt="信任此文件夹" style={{ borderRadius: '8px', maxWidth: '100%' }} width="1346" height="588" data-path="images/token-plan/cc-trust-folder.png" />
</Frame>

进入交互界面后，可通过以下命令管理会话：

* `/status` —— 查看当前模型与 API 地址，确认配置生效
* `/model` —— 切换模型（Opus / Sonnet / Haiku 三档均映射为 `senseaudio-s2`）
* 直接输入自然语言任务，例如 "帮我重构这个模块的错误处理逻辑"

## 相关资源

<CardGroup cols={3}>
  <Card title="Hermes Agent" icon="robot" href="/guides/token-plan/hermes-agent">
    接入开源自主 AI 智能体
  </Card>

  <Card title="S2 使用技巧" icon="lightbulb" href="/guides/token-plan/best-practices">
    发挥 S2 模型最佳效果
  </Card>

  <Card title="常见问题" icon="circle-question" href="/guides/token-plan/faq">
    订阅、限额、切换、开票等问题解答。
  </Card>
</CardGroup>