Claude Code 部署安装与使用指引
Claude Code 是 Anthropic 官方命令行工具，通过 TimRouter API 接入 Claude 大模型。它直接在本地项目目录里工作：读代码、辅助排查问题、产出实现、解释逻辑，整体更贴近真实开发流程。
Anthropic 官方命令行工具，通过 TimRouter API 接入 Claude 大模型。
Windows 部署安装 Claude Code（原生部署安装，无需 WSL）
Windows 用户可以直接使用 PowerShell 部署安装 Claude Code，无需部署安装 WSL / Ubuntu。部署安装前请先准备 Git for Windows。
部署安装 Git for Windows
如果 Git 官网下载较慢，可使用境内镜像源获取下载，建议选用最新发布版本，下载 64-bit Git for Windows Setup 结尾的 .exe 部署安装包。部署安装过程中推荐勾选 Add Git to PATH。
https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/以管理员身份开启 PowerShell
在开始菜单搜索 PowerShell，单击右键并选择「采用管理员权限执行」。如果你使用普通 PowerShell 已经可以正常部署安装，也能够使用普通 PowerShell。
部署安装 Claude Code
在 PowerShell 中执行官方 Claude Code 部署安装指令。
npm install -g @anthropic-ai/claude-code部署安装完毕后，请先关闭退出当前 PowerShell 窗口，并再重新开启一个新的 PowerShell。
校验部署安装
claude --version如果能看到版本号，详细说明 Claude Code 部署安装即告完成。
切换到项目所在目录并启动
cd D:\your-projectclaude- 挑选您中意的主题（回车）
- 确认相关安全须知（回车）
- 沿用默认 Terminal 设定（回车）
- 对工作目录予以信任（回车）
- 开始编程
完成 TimRouter API 的接入配置
访问 TimRouter API 管理控制台查询获取你的 API Key，然后在 PowerShell 中执行以下命令。
setx ANTHROPIC_BASE_URL "https://api.timrouter.com"
setx ANTHROPIC_AUTH_TOKEN "你的 TimRouter API Key"设定完成后，关闭退出当前 PowerShell，再重新开启一个新的 PowerShell，再切换到项目所在目录执行 claude。
https://api.timrouter.com，不要加 /v1。
部署安装 Node.js
使用 Homebrew 部署安装 Node.js（如果尚未部署安装 Homebrew，请先行部署安装）。
# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 通过 Homebrew 安装 Node.js
brew install node
# 验证安装
node --version部署安装 Claude Code
在终端中执行官方 Claude Code 部署安装指令。
npm install -g @anthropic-ai/claude-code
claude --version完成 TimRouter API 的接入配置
访问 TimRouter API 管理控制台，点击左侧菜单「令牌管理」-「添加令牌」。
- 访问令牌名称：随意填写，例如 Claude Code
- 有效期限：推荐勾选永不过期
- 额度配置：设定为不限额度
- 分组：选择 Claude code 专属或者官转克劳德3及以上
- 其他选项：维持默认选项
然后在 .claude 目录下新建或修改 settings.json 配置文件，写入以下配置信息，推荐使用这种永久配置方式。
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
"ANTHROPIC_BASE_URL": "https://api.timrouter.com",
"API_TIMEOUT_MS": "300000"
}
}https://api.timrouter.com，不要加 /v1。
启动 Claude Code
配置完成后，先进入到你的项目文件夹中。
cd your-project-folder然后执行以下命令启动 Claude Code。
claude- 挑选您中意的主题（回车）
- 确认相关安全须知（回车）
- 沿用默认 Terminal 设定（回车）
- 对工作目录予以信任（回车）
- 开始编程
部署安装 Node.js
使用以下命令部署安装 Node.js LTS 版本（Ubuntu / Debian）。
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证安装
node --version部署安装 Claude Code
在终端中执行官方 Claude Code 部署安装指令。
npm install -g @anthropic-ai/claude-code
claude --version完成 TimRouter API 的接入配置
访问 TimRouter API 管理控制台，点击左侧菜单「令牌管理」-「添加令牌」。
- 访问令牌名称：随意填写，例如 Claude Code
- 有效期限：推荐勾选永不过期
- 额度配置：设定为不限额度
- 分组：选择 Claude code 专属或者官转克劳德3及以上
- 其他选项：维持默认选项
然后在 .claude 目录下新建或修改 settings.json 配置文件，写入以下配置信息，推荐使用这种永久配置方式。
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
"ANTHROPIC_BASE_URL": "https://api.timrouter.com",
"API_TIMEOUT_MS": "300000"
}
}https://api.timrouter.com，不要加 /v1。
启动 Claude Code
配置完成后，先进入到你的项目文件夹中。
cd your-project-folder然后执行以下命令启动 Claude Code。
claude- 挑选您中意的主题（回车）
- 确认相关安全须知（回车）
- 沿用默认 Terminal 设定（回车）
- 对工作目录予以信任（回车）
- 开始编程
常见问题解答
Q: 遇到 "Invalid API Key · Please run /login" 错误？
A: 这表明 Claude Code 未检测到环境变量。请检查：
- 是否已正确配置
ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL - 环境变量的取值是否无误（令牌以
sk-开头） - 若采用了永久性配置，是否已重启终端
Q: 为什么显示 "offline" 状态？
A: Claude Code 通过连接 Google 来判断网络状态。显示 "offline" 不影响正常使用，只是表明无法连接到 Google。
Q: 发起请求总是显示 "fetch failed"？
A: 可能是网络环境导致的问题。解决方案：
- 退出 Claude Code（Ctrl+C）
- 重新执行
claude命令 - 如果问题持续，请稍后再试
Q: API 报错如何处理？
A: 可能是转发代理不稳定导致的，建议退出后重新启动。如果问题持续，请稍后再试或联系技术全面支持。
Claude Code 国内使用 TimRouter API
搜索 Claude Code 国内使用、Claude Code API 中转、Claude Code 配置 API Key 的用户，通常需要解决两个问题：本地部署安装 Claude Code，以及把 Claude Code 的发起请求指向 TimRouter API。
| 配置项 | 填写内容 | 详细说明 |
|---|---|---|
ANTHROPIC_BASE_URL | https://api.timrouter.com | Claude Code 场景不要加 /v1 |
ANTHROPIC_AUTH_TOKEN | TimRouter API Key | 从管理控制台令牌管理中查询获取 |
API_TIMEOUT_MS | 300000 | 长任务可适当增加超时时间 |