配置 Codesome Claude API 环境。当用户提到"配置 codesome"、"codesome claude api"、"codesome 设置"、"配置 claude api 代理"、"setup codesome"时激活。支持 macOS 和 Windows,包含 Claude Code 安装、环境变量配置和连通性验证。
帮助用户在 macOS 和 Windows 上配置 Codesome API 代理,以使用 Claude Code。
ANTHROPIC_BASE_URL 或 ANTHROPIC_AUTH_TOKEN按以下 6 步顺序执行,每步完成后确认再进入下一步。
判断用户的操作系统:
setx 或系统设置配置如果无法自动判断,直接询问用户。
引导用户获取 Codesome API 密钥:
sk- 开头的字符串提示用户:
请先在 Codesome 平台 (https://cc.codesome.ai) 上获取您的 API 密钥:
1. 登录后进入控制台
2. 找到【使用密钥】
3. 创建或复制您的 API 密钥(sk-开头)
4. 将密钥提供给我,我来帮您完成配置
校验:确认用户提供的密钥以 sk- 开头,长度合理(通常 64 字符以上)。
检查并安装 Claude Code CLI 工具。
前置条件检查:
Windows 用户优先检查 Git Bash:
git --version
如果提示命令不存在,需要先安装 Git for Windows:
git --version检查 Node.js 和 npm:
# 检查 Node.js 是否已安装
node --version
# 检查 npm 是否可用
npm --version
如果未安装 Node.js,引导用户:
brew install node 或从 https://nodejs.org 下载安装 Claude Code:
npm install -g @anthropic-ai/claude-code
Windows 特殊处理:如果遇到 PowerShell 执行策略错误,参考下方「故障排查」章节。快速修复:
# 以管理员身份运行 PowerShell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
# 输入 Y 确认,然后重新运行 npm install
根据操作系统配置以下环境变量:
ANTHROPIC_BASE_URL = https://cc.codesome.aiANTHROPIC_AUTH_TOKEN = 用户提供的 API 密钥临时生效(当前终端会话):
export ANTHROPIC_BASE_URL="https://cc.codesome.ai"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
永久生效(写入 shell 配置文件):
检测用户使用的 shell(echo $SHELL),然后写入对应配置文件:
~/.zshrc~/.bashrc 或 ~/.bash_profile# 写入配置(以 zsh 为例)
echo '' >> ~/.zshrc
echo '# Codesome Claude API Configuration' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://cc.codesome.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"' >> ~/.zshrc
# 使配置立即生效
source ~/.zshrc
方式一:setx 永久设置(推荐):
setx ANTHROPIC_BASE_URL "https://cc.codesome.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"
注意:
setx设置的变量需要重新打开终端才能生效。
方式二:系统环境变量 GUI:
ANTHROPIC_BASE_URL,值:https://cc.codesome.aiANTHROPIC_AUTH_TOKEN,值:sk-你的密钥根据用户使用的 IDE 提供对应指引:
环境变量配置完成后,直接在终端中运行:
claude
执行以下验证步骤确认配置成功:
1. 检查 Claude Code 安装:
claude --version
预期输出:显示版本号,如 claude-code x.x.x
2. 检查环境变量:
# macOS
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
# Windows CMD
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%
# Windows PowerShell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
预期输出:分别显示 https://cc.codesome.ai 和用户的 API 密钥。
3. 测试 API 连通性:
claude "你好,请简单回复确认连接正常"
预期:Claude 正常回复,说明配置成功。
如果验证失败,参考下方「故障排查」章节。
用户请求: "帮我配置 codesome claude api"
执行流程:
sk-abc123...npm install -g @anthropic-ai/claude-code~/.zshrcclaude --version 和测试命令验证用户请求: "在 Windows 上配置 codesome"
执行流程:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUsersetx 配置环境变量用户请求: "我需要更换 codesome 的 API 密钥"
执行流程:
ANTHROPIC_AUTH_TOKEN症状:运行 npm install -g @anthropic-ai/claude-code 时报错,提示脚本执行被禁止。
原因:Windows PowerShell 默认执行策略为 Restricted,阻止 .ps1 脚本运行。
解决方案:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Y 确认npm install -g @anthropic-ai/claude-code
症状:node --version 或 npm --version 提示命令不存在。
解决方案:
macOS:
brew install node
或从 https://nodejs.org 下载 LTS 版本
Windows: 从 https://nodejs.org 下载 LTS 版本安装,安装时勾选"Add to PATH"
安装完成后检查 Node.js 路径(如 D:\Program Files\nodejs)是否在系统 Path 环境变量中。
症状:配置了环境变量但 echo $ANTHROPIC_BASE_URL 输出为空。
解决方案:
macOS:
~/.zshrc 或 ~/.bashrc)source ~/.zshrc(或对应文件)重新加载Windows:
setx 设置的变量需要重新打开终端才能生效(当前窗口不会更新)症状:claude 命令报错,无法连接到 API。
排查步骤:
ANTHROPIC_BASE_URL 值为 https://cc.codesome.ai(注意 https)curl https://cc.codesome.ai
症状:安装成功但 claude 命令找不到。
解决方案:
# 查看 npm 全局安装路径
npm config get prefix
# 确认该路径在系统 PATH 中
# macOS 通常是 /usr/local/bin
# Windows 通常是 %AppData%\npm
如果路径不在 PATH 中,手动添加或重新安装 Node.js。
症状:Windows 用户在终端中无法运行 git 命令,或 Claude Code 运行时提示缺少 bash 环境,或终端只有 CMD/PowerShell 而没有类 Unix shell 环境。
原因:Claude Code 依赖 bash 环境运行部分功能,Windows 默认不自带 Git Bash。
解决方案:
git --version
预期输出:git version 2.x.x.windows.x安装后注意:
terminal.integrated.defaultProfile.windows,选择 "Git Bash"ANTHROPIC_BASE_URL 固定为 https://cc.codesome.ai,不需要用户修改setx 后必须重新打开终端窗口