官方源安装
此过程使用 100% 官方源服务进行安装,确保您的技术设置与官方版本完全一致
系统要求
- macOS/Linux: 无特定要求
- Node.js: 20+ 版本
安装步骤
1
打开终端
使用 Cmd+Space 搜索 "Terminal" 或在应用程序 → 实用工具中找到终端
2
3
卸载现有 Claude Code(如未安装可跳过)
$ npm uninstall -g @anthropic-ai/claude-code
安装官方版本
$ npm install -g @anthropic-ai/claude-code@1.0.80
5
配置 API 设置
创建 settings.json 文件来配置 API 端点:
$ vim ~/.claude/settings.json
添加以下内容:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "paste your API key here",
"ANTHROPIC_BASE_URL": "https://api.aicodeditor.com",
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"API_TIMEOUT_MS": "600000",
"BASH_DEFAULT_TIMEOUT_MS": "600000",
"BASH_MAX_TIMEOUT_MS": "600000",
"MCP_TIMEOUT": "30000",
"MCP_TOOL_TIMEOUT": "600000",
"CLAUDE_API_TIMEOUT": "600000"
},
"permissions": {
"allow": [],
"deny": []
}
}验证安装
运行以下命令确认安装成功:
$ claude -v
如果显示版本号,则安装成功。
开始使用
安装完成后,您可以在任何项目目录中开始使用 Claude Code:
# 进入项目目录
$ cd your-project-folder
# 启动 Claude Code
$ claude
重要说明
使用 Opus 模型: 设置 CLAUDE_CODE_MAX_OUTPUT_TOKENS 为 32000 以获得最佳性能。
重启 Claude Code: 修改配置后,请重启 Claude Code 使更改生效。
进阶技巧
使用别名简化命令
在 ~/.bashrc 或 ~/.zshrc 中添加:
alias cc="claude"项目特定配置
在项目根目录创建 .claude/settings.json
mkdir .claude && touch .claude/settings.json故障排除
权限问题: 如果安装时遇到权限错误,可能需要使用 sudo 或配置 npm 全局目录。
Node.js 版本: 确保使用 Node.js 20+ 版本,可使用 nvm 管理多个 Node.js 版本。
环境变量: 如果命令不可用,检查 PATH 环境变量是否包含 npm 全局安装目录。
