JiaPi 文档

Claude Code 接入教程

介绍 Claude Code Desktop 和 CLI 的使用方式,并配置第三方模型、环境变量和项目内验证流程

一、Claude Code 有哪几种使用方式

Claude Code 可以按使用方式分成两类:一种是桌面客户端,适合图形化配置第三方模型;另一种是命令行 CLI,适合在项目目录里完成代码阅读、修改、测试和提交前检查。

Claude Code Desktop

适合 Windows 和 macOS 桌面用户,通过设置页配置模型、密钥和接口地址。

Claude Code CLI

适合终端、WSL、Linux 服务器和远程开发,在项目目录中运行 claude 命令。

二、准备参数

开始配置前,先把下面几项准备好。不要一边安装一边猜参数,后面排查会很绕。

Base URL

通常是 https://ai-api.jiapi.com。

API Key

JiaPi 控制台创建的真实密钥。

三、Claude Code Desktop 安装

方案一

前往 https://code.claude.com/docs/en/overview#desktop-app 下载安装包并安装

ClaudeCode客户端安装包下载

方案二

下载完成后,不要双击打开
搜索PowerShell并"以管理员身份运行",执行如下命令。若报权限错误,去 Windows 设置 → 系统 → 开发者选项,打开"开发人员模式",重新执行 PowerShell 命令
Add-AppxPackage -Path "C:\Users\用户名\Downloads\Claude.msix"

四、Claude Code Desktop 配置第三方模型

点击左上角“三”,菜单栏 Help → Troubleshooting → Enable Developer Mode
ClaudeCode开启开发者模式
点击左上角“三”,菜单栏 Developer → Configure Third-Party Inference
ClaudeCode第三方接入
选择 Gateway 模式,输入第三方 Base URL、API Key,设置Credential kind,然后点击Test Connection测试
ClaudeCode连接参数
配置后若无法自动加载模型名称,需手动添加
ClaudeCode手动添加模型
点击 Apply locally → Relaunch now
ClaudeCode重启
重启后界面出现第三方大模型
ClaudeCode模型列表
测试Claude Code Desktop
ClaudeCode使用案例

五、Claude Code CLI 安装与配置

环境要求

安装前先确认当前环境满足基础要求:

Node.js

最低建议 Node.js 18,推荐使用 20 LTS 或更新的 LTS 版本。

npm

随 Node.js 一起安装,用于全局安装 Claude Code CLI。

网络

官方服务需要访问 Anthropic 相关服务;第三方兼容服务以服务商网络要求为准。

先在当前终端确认 Node.js 和 npm 可用:

node -v
npm -v

如果命令不可用,先安装 Node.js LTS。

安装 Claude Code CLI

使用 npm 全局安装 Claude Code CLI:

npm install -g @anthropic-ai/claude-code
claude --version

如果安装成功,claude --version 会输出类似 claude 1.x.x 的版本号。还可以查看帮助:

claude --help

配置 settings.json

安装完成后在 C:\Users\你的用户名\.claude 目录下新建 settings.json 文件(若存在则无需新建),文件内容如下

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "API Key",
    "ANTHROPIC_BASE_URL": "base_url"
  }
}

Claude Code CLI 使用

进入你的项目目录,然后启动 Claude Code:

ClaudeCLI进入项目

现在可以用自然语言描述任务了:

ClaudeCLI案例

六、常见问题

参考入口

On this page