feat: add init command for environment validation

- Add 'codes init' command to check environment setup
- Verify Claude CLI installation and version
- Validate configuration file existence and format
- Test default configuration API connectivity
- Display all configurations with their status
- Provide actionable suggestions when checks fail

This command helps users quickly diagnose setup issues and
ensures their environment is ready to use codes CLI.

Updated README with init command documentation and examples.

Author: ourines

README.md

@@ -56,7 +56,15 @@ make build
 
 ## Quick Start
 
-### 1. Add Your First Configuration
+### 1. Check Your Environment (Optional but Recommended)
+
+```bash
+codes init
+```
+
+This will verify that everything is set up correctly and guide you if something is missing.
+
+### 2. Add Your First Configuration
 
 ```bash
 codes add
@@ -69,15 +77,15 @@ You'll be prompted to enter:
 
 The tool will automatically test the API connection before saving.
 
-### 2. Run Claude with Your Configuration
+### 3. Run Claude with Your Configuration
 
 ```bash
 codes
 ```
 
 This will launch Claude CLI with the selected configuration's environment variables.
 
-### 3. Switch Between Configurations
+### 4. Switch Between Configurations
 
 ```bash
 codes select
@@ -87,6 +95,29 @@ An interactive menu will appear showing all your configurations. Select one to s
 
 ## Commands
 
+### `codes init`
+
+Check your environment and validate your configuration. This command performs comprehensive checks including:
+
+- Verifies Claude CLI installation
+- Checks configuration file existence and validity
+- Tests API connectivity for the default configuration
+- Displays detailed status of all configurations
+
+```bash
+codes init
+```
+
+**Example output:**
+```
+✓ Claude CLI is installed
+✓ Configuration file exists
+✓ Found 3 configuration(s)
+✓ Default configuration is working
+```
+
+This is a great command to run after installation or when troubleshooting issues.
+
 ### `codes` (no arguments)
 
 Runs Claude CLI with the currently selected configuration. If Claude CLI is not installed, it will be automatically installed.

cmd/codes/main.go

@@ -16,6 +16,7 @@ var rootCmd = &cobra.Command{
 }
 
 func init() {
+	rootCmd.AddCommand(commands.InitCmd)
 	rootCmd.AddCommand(commands.InstallCmd)
 	rootCmd.AddCommand(commands.AddCmd)
 	rootCmd.AddCommand(commands.SelectCmd)

internal/commands/cobra.go

@@ -8,6 +8,16 @@ import (
 	"codes/internal/ui"
 )
 
+// InitCmd represents the init command
+var InitCmd = &cobra.Command{
+	Use:   "init",
+	Short: "Check environment and configuration",
+	Long:  "Verify Claude CLI installation and validate configuration files",
+	Run: func(cmd *cobra.Command, args []string) {
+		RunInit()
+	},
+}
+
 // InstallCmd represents the install command
 var InstallCmd = &cobra.Command{
 	Use:   "install",

internal/commands/commands.go

@@ -360,6 +360,135 @@ func installClaude(version string) {
 	ui.ShowSuccess("Claude installed successfully!")
 }
 
+func RunInit() {
+	ui.ShowHeader("Codes CLI Environment Check")
+	fmt.Println()
+
+	allGood := true
+
+	// 1. Check if Claude CLI is installed
+	ui.ShowInfo("Checking Claude CLI installation...")
+	if _, err := exec.LookPath("claude"); err != nil {
+		ui.ShowError("✗ Claude CLI not found", nil)
+		ui.ShowWarning("  Run 'codes update' to install Claude CLI")
+		allGood = false
+	} else {
+		ui.ShowSuccess("✓ Claude CLI is installed")
+
+		// Check Claude version
+		cmd := exec.Command("claude", "--version")
+		output, err := cmd.Output()
+		if err == nil {
+			version := strings.TrimSpace(string(output))
+			ui.ShowInfo("  Version: %s", version)
+		}
+	}
+	fmt.Println()
+
+	// 2. Check if config file exists
+	ui.ShowInfo("Checking configuration file...")
+	if _, err := os.Stat(config.ConfigPath); err != nil {
+		ui.ShowError("✗ Configuration file not found", nil)
+		ui.ShowInfo("  Expected location: %s", config.ConfigPath)
+		ui.ShowWarning("  Run 'codes add' to create your first configuration")
+		allGood = false
+	} else {
+		ui.ShowSuccess("✓ Configuration file exists")
+		ui.ShowInfo("  Location: %s", config.ConfigPath)
+
+		// 3. Validate configuration
+		cfg, err := config.LoadConfig()
+		if err != nil {
+			ui.ShowError("✗ Failed to load configuration", err)
+			ui.ShowWarning("  Your config file may be corrupted")
+			allGood = false
+		} else {
+			if len(cfg.Configs) == 0 {
+				ui.ShowWarning("✗ No configurations found in config file")
+				ui.ShowWarning("  Run 'codes add' to add a configuration")
+				allGood = false
+			} else {
+				ui.ShowSuccess("✓ Found %d configuration(s)", len(cfg.Configs))
+
+				// Show configurations with status
+				fmt.Println()
+				ui.ShowInfo("Configurations:")
+				for i, c := range cfg.Configs {
+					isDefault := ""
+					if c.Name == cfg.Default {
+						isDefault = " (default)"
+					}
+
+					statusIcon := "?"
+					statusText := "unknown"
+					if c.Status == "active" {
+						statusIcon = "✓"
+						statusText = "active"
+					} else if c.Status == "inactive" {
+						statusIcon = "✗"
+						statusText = "inactive"
+					}
+
+					fmt.Printf("  %d. %s %s%s - %s [%s]\n",
+						i+1, statusIcon, c.Name, isDefault, c.AnthropicBaseURL, statusText)
+				}
+
+				// 4. Test default configuration
+				if cfg.Default != "" {
+					fmt.Println()
+					ui.ShowInfo("Testing default configuration '%s'...", cfg.Default)
+
+					var defaultConfig *config.APIConfig
+					for i := range cfg.Configs {
+						if cfg.Configs[i].Name == cfg.Default {
+							defaultConfig = &cfg.Configs[i]
+							break
+						}
+					}
+
+					if defaultConfig != nil {
+						if config.TestAPIConfig(*defaultConfig) {
+							ui.ShowSuccess("✓ Default configuration is working")
+						} else {
+							ui.ShowWarning("✗ Default configuration test failed")
+							ui.ShowWarning("  API may be unreachable or credentials may be invalid")
+							ui.ShowInfo("  Run 'codes add' to add a new configuration")
+							allGood = false
+						}
+					} else {
+						ui.ShowWarning("✗ Default configuration '%s' not found", cfg.Default)
+						ui.ShowWarning("  Run 'codes select' to choose a valid configuration")
+						allGood = false
+					}
+				}
+			}
+		}
+	}
+
+	fmt.Println()
+	ui.ShowInfo("─────────────────────────────────")
+	fmt.Println()
+
+	if allGood {
+		ui.ShowSuccess("✓ All checks passed! You're ready to use codes.")
+		fmt.Println()
+		ui.ShowInfo("Quick commands:")
+		ui.ShowInfo("  codes          - Run Claude with current configuration")
+		ui.ShowInfo("  codes select   - Switch between configurations")
+		ui.ShowInfo("  codes add      - Add a new configuration")
+	} else {
+		ui.ShowWarning("⚠ Some checks failed. Please review the messages above.")
+		fmt.Println()
+		ui.ShowInfo("Suggested actions:")
+		if _, err := exec.LookPath("claude"); err != nil {
+			ui.ShowInfo("  1. Install Claude CLI: codes update")
+		}
+		if _, err := os.Stat(config.ConfigPath); err != nil {
+			ui.ShowInfo("  2. Add a configuration: codes add")
+		}
+	}
+}
+
 func checkForUpdates() {
 	// 检查codes CLI更新
 	go func() {