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 下载安装包并安装
方案二
Add-AppxPackage -Path "C:\Users\用户名\Downloads\Claude.msix"四、Claude Code Desktop 配置第三方模型







五、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:
现在可以用自然语言描述任务了: