Claude Code 配置教程
安装并配置 Claude Code CLI 工具,连接 Coding Flow 平台。
Claude Code 是 Anthropic 官方 CLI 工具,强大的 AI 编程助手。本教程将引导你完成安装和配置。
开始前请先完成 Node.js 环境安装教程。
你需要准备
- 一个可用的 API Key(形如:
sk-******) - 一个可访问的 服务地址(Base URL)(通常由部署方/网关提供)
本站通用服务地址
第一步:安装 Claude Code
打开终端(Windows 使用 PowerShell 或 CMD),运行以下命令:
npm install -g @anthropic-ai/claude-code这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。
如果在 macOS / Linux 上遇到权限问题,可以使用 sudo:
sudo npm install -g @anthropic-ai/claude-code验证安装
安装完成后,输入以下命令检查,如果显示版本号,说明安装成功了!
claude --version第二步:项目配置
1. 全局配置
# 创建 C:\Users\<你的用户名>\.claude\settings.json 并添加以下内容:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.codingflow.ai",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": 1
}
}# 创建 settings.json
cat > ~/.claude/settings.json << 'EOF'
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.codingflow.ai",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": 1
}
}
EOF# 创建 settings.json
cat > ~/.claude/settings.json << 'EOF'
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.codingflow.ai",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": 1
}
}
EOF2. 项目内配置
在你的项目根目录下创建一个 .claude 目录,并在该目录下创建 settings.json 文件。 然后配置 settings.json 文件。将ANTHROPIC_AUTH_TOKEN替换为您的API密钥,ANTHROPIC_MODEL替换为您需要的模型
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.codingflow.ai",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": 1
}
}3. 跳过登陆验证
该配置将会绕过Claude的登陆验证,可以直接使用Claude Code。
在 ~/.claude.json 文件的最外层大括号内,找到合适的位置添加配置项:"hasCompletedOnboarding": true。
# 编辑 C:\Users\<你的用户名>\.claude.json
{
// ... 其他配置
"hasCompletedOnboarding": true
}# 编辑 ~/.claude.json
{
// ... 其他配置
"hasCompletedOnboarding": true
}# 编辑 ~/.claude.json
{
// ... 其他配置
"hasCompletedOnboarding": true
}重要提示
请将 YOUR_API_KEY 替换为在 Coding Flow平台 申请的 API Key。
以上配置参数说明
ANTHROPIC_BASE_URL: 模型提供者的 API 地址,固定设置为https://api.codingflow.ai。ANTHROPIC_AUTH_TOKEN: 认证密钥,此处为YOUR_API_KEY。ANTHROPIC_MODEL: 模型名称。CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: 强制禁用所有实验性 Beta 功能。
详细参数信息可参考:Claude Code 参数配置
第三步:开始使用
claude常见问题
Q: context_management: Extra inputs are not permitted
A: 在配置文件中配置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: 1,强制禁用所有实验性 Beta 功能。
Q: ValidationException: prompt is too long: 1004239 tokens > 1000000 maximum
A: 在配置文件中配置 CLAUDE_CODE_AUTO_COMPACT_WINDOW: 1000000,自动压缩上下文窗口,避免超出最大 token 数限制。
