指南

平台优势、可用模型、接入示例与常见问题。

CLI 配置

Claude Code

Anthropic 原生协议,配置 settings.json。

  1. 1

    安装工具

    任选一种方式安装,第一种为推荐方式,无需 Node.js:
    原生安装推荐
    macOS / Linux / WSL
    bash
    Windows PowerShell
    powershell
    Windows CMD
    bat
    Homebrew
    终端
    bash
    WinGet
    终端
    powershell
    npm
    终端
    bash

    此方式需先安装 Node.js(22+)。 安装 Node.js

    Debian / Fedora / RHEL / Alpine 也可用 apt、dnf、apk 安装。

  2. 2

    首次运行

    运行一次,出现欢迎界面或选项即说明安装成功:
    终端
    bash
  3. 3

    打开配置目录

    进入下方配置目录。若目录或对应文件不存在,请先手动创建:
    Windows%USERPROFILE%\.claude
    macOS~/.claude

    macOS:在访达中按 ⇧⌘G,粘贴上面的路径前往。

    Windows:在文件资源管理器地址栏粘贴上面的路径后回车。

  4. 4

    写入配置

    把配置写入文件,下面两种方式任选其一。

    方式一 · 终端一次性写入(推荐,存在即覆盖):

    bash

    方式二 · 在上述目录手动新建对应文件,粘贴内容保存(存在即覆盖):

    ~/.claude/settings.json
    json

    上面已包含三个推荐环境变量:关闭非必要遥测、终端标题与署名标头,可按需增删。

  5. 5

    填入 API Key

    YOUR_API_KEY 替换为活动发放给你的 API Key。

    还没有 API Key?前往 控制台

  6. 6

    测试对话

    再次运行命令,出现对话界面并能正常回复,即配置成功。
    终端
    bash