Claude Code 配置教程
一、创建 API 令牌
1. 选择模型和分组
2. 创建令牌
请妥善保管 API Key，不要发送给他人，也不要在截图中展示完整内容。
二、安装与配置
方式 A：桌面版（Desktop）
1. 下载安装
2. 免登录配置
1.
2.
Help → Troubleshooting → Enable Developer Mode，确 认开启后重启软件。3.
Developer → Configure Third-Party Inference。4.
桌面版在此界面直接完成配置，无需修改 settings.json。
方式 B：终端版（Terminal）
1. 官方脚本安装（推荐）
irm https://claude.ai/install.ps1 | iex2. npm 安装（备选）
macOS 或 Linux 出现 npm 权限错误时，不建议使用 sudo npm install，请改用 Node.js 版本管理工具后重新安装。
3. 验证安装
方式 C：VS Code 插件版
1.
Ctrl+Shift+X；macOS：Command+Shift+X）。2.
3.
Cursor、Windsurf 等兼容 VS Code 扩展的编辑器也可尝试安装同一插件。若没看到 Claude 图标，请重启编辑器并确认当前项目已被信任。
三、配置文件（终端版 / VS Code 插件版）
桌面版已在方式 A 中完成配置，可跳过本节。
1. 找到配置目录
| 系统 | 配置目录 |
|---|---|
| Windows | C:\Users\<你的用户名>\.claude |
| macOS | /Users/<你的用户名>/.claude |
| Linux | /home/<你的用户名>/.claude |
.claude 是隐藏目录。macOS 访达中按 Command+Shift+. 显示隐藏文件，Linux 文件管理器通常按 Ctrl+H 显示。2. 配置 API Key 和模型
.claude 目录中创建或打开 settings.json，写入以下内容：{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk开头的密钥",
"ANTHROPIC_BASE_URL": "https://www.tiantoken.com",
"ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5",
"ANTHROPIC_DEFAULT_FABLE_MODEL_NAME": "claude-fable-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
"ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "claude-opus-4-8",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "claude-sonnet-5",
"ANTHROPIC_MODEL": "claude-opus-4-8"
},
"includeCoAuthoredBy": false,
"theme": "dark"
}sk开头的密钥 替换为第一步创建的 API Key。模型名称需与词元模型广场中实际可用的名称一致；使用其他 Claude 模型时请同步修改对应值。JSON 中的双引号和逗号必须保留，不要在 API Key 前后添加空格。
3. 重启客户端
四、验证与排查
1.
settings.json 是否位于当 前用户的 .claude 目录中。2.
.txt 后缀。3.
ANTHROPIC_BASE_URL 是否为 `https://www.tiantoken.com。4.
5.
6.
7.
修改于 2026-09-10 08:30:05