Claude Code 接入教程
按 Claude Desktop 第三方接口配置教程接入模型，并保留 Claude Code CLI 的安装、配置和使用方式
≡ ON THIS PAGE
使用方式
Claude Code 主要有两种使用方式：Desktop 适合图形化配置和文件操作，CLI 适合在项目目录、远程终端或服务器中完成代码阅读、修改和测试。
关于安装
可以前往 Claude 官方下载页面 https://claude.com/download 下载对应系统的安装包，或者使用本教程提供的安装包：
Desktop国内无法下载，CLI国内可以下载安装。
MacOS 系统
1. 启用开发者模式
重新打开 Claude Desktop，先不要登录账号。点击顶部菜单，按下面路径启用开发者模式：
Help → Troubleshooting → Enable Developer Mode
点完之后，应用会自动重启。
2. 找到第三方接口配置入口
重启完成后，顶部菜单会多出 Developer 选项。点击：
Developer → Configure Third-Party Inference
3. 选模型 + 填接口
在配置窗口左侧选择 Connection，把模式切到 Gateway。
按服务商提供的信息填写：
| 配置项 | 填写内容 |
|---|---|
| Gateway base URL | 服务商提供的接口地址，例如 https://your-api-host.example |
| Gateway API key | 在服务平台创建的 API Key，不要把真实密钥写入公开文档 |
| Gateway auth scheme | 按服务商要求选择，常见为 bearer |
继续向下找到 Model list，填写服务商实际提供的 Model ID。例如服务商文档使用 claude-sonnet-4-6 时，客户端中也必须填写完全相同的名称。
如果服务商支持 1M 上下文，并且当前模型确实提供对应能力，可以开启 Offer 1M-context variant。不要为不支持该能力的模型强行开启。
填写完成后点击最下面的 Apply 或 Apply locally，客户端会自动重启。
4. 实测下来是什么样
重启完成后进入 Code 模式，先执行一个低风险任务，例如：
请只读取当前项目目录，先概括目录结构和主要技术栈，不要修改任何文件。
Windows 系统
1. 启用开发者模式
打开 Claude Desktop，先不要登录账号。点击左上角菜单，按下面路径启用开发者模式：
Help → Troubleshooting → Enable Developer Mode
如果客户端弹出确认窗口，选择 Enable，确认启用开发者模式，随后等待客户端自动重启。
2. 找到第三方接口配置入口
Developer → Configure Third-Party Inference
3. 选模型 + 填接口
在配置窗口中选择Connection设置，优先尝试 Gateway。填写服务商提供的 Base URL、API Key、认证方式。
如果当前版本没有 Gateway API key 这一项，可以按照服务商要求改用 Static API key。
模型名称必须与服务商实际支持的 Model ID 完全一致。客户端支持时，可以按照同样的方式连续添加多个模型。
填写完成后点击最下面的 Apply locally，客户端会自动重启。
4. 实测下来是什么样
重启完成后，可以进行验证：
Claude Code CLI 安装与配置
1. 环境要求
安装前先确认当前环境满足基础要求：
Node.js
最低建议 Node.js 18，推荐使用 20 LTS 或更新的 LTS 版本。
npm
随 Node.js 一起安装，用于全局安装 Claude Code CLI。
先在当前终端确认 Node.js 和 npm 可用：
node -v
npm -v
如果命令不可用，先安装 Node.js LTS。
2. 自动安装与配置（推荐）
如果你只是想尽快用起来，推荐先使用自动安装与配置工具。
Claude Code CLI自动配置安装 Claude Code CLI测试连接，确认 Base URL、API Key 和模型能连通。一键写入配置，即可完成安装与配置。3. 手动安装与配置
如果想自己手动安装和配置，可以按下面方式手动完成。
使用 npm 全局安装 Claude Code CLI：
npm install -g @anthropic-ai/claude-code
claude --version
如果安装成功，执行 claude --version 会输出类似 claude 1.x.x 的版本号。还可以查看帮助：
claude --help
安装完成后在 C:\Users\你的用户名\.claude 目录下新建 settings.json 文件（若存在则无需新建），文件内容如下：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "API Key",
"ANTHROPIC_BASE_URL": "base_url"
}
}
4. Claude Code CLI 使用
claude 启动Claude Code CLI。